az batch pool
Nota
Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.
Gestire i pool di Batch.
Comandi
| Nome | Descrizione | Tipo | Stato |
|---|---|---|---|
| az batch pool autoscale |
Gestire il ridimensionamento automatico dei pool di Batch. |
Memoria centrale | Disponibilità generale |
| az batch pool autoscale disable |
Disabilita il ridimensionamento automatico per un pool. |
Memoria centrale | Disponibilità generale |
| az batch pool autoscale enable |
Abilita il ridimensionamento automatico per un pool. |
Memoria centrale | Disponibilità generale |
| az batch pool autoscale evaluate |
Ottiene il risultato della valutazione di una formula di ridimensionamento automatico nel pool. |
Memoria centrale | Disponibilità generale |
| az batch pool create |
Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale. |
Memoria centrale | Disponibilità generale |
| az batch pool create (azure-batch-cli-extensions estensione) |
Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale. |
Estensione | Disponibilità generale |
| az batch pool delete |
Elimina un pool dall'account specificato. |
Memoria centrale | Disponibilità generale |
| az batch pool list |
Elenca tutti i pool nell'account specificato. |
Memoria centrale | Disponibilità generale |
| az batch pool node-counts |
Ottenere i conteggi dei nodi per i pool di Batch. |
Memoria centrale | Disponibilità generale |
| az batch pool node-counts list |
Ottiene il numero di nodi di calcolo in ogni stato, raggruppati per pool. |
Memoria centrale | Disponibilità generale |
| az batch pool reset |
Aggiornare le proprietà di un pool di Batch. Le proprietà non specificate che possono essere aggiornate vengono reimpostate sulle impostazioni predefinite. |
Memoria centrale | Disponibilità generale |
| az batch pool resize |
Ridimensionare o arrestare il ridimensionamento di un pool di Batch. |
Memoria centrale | Disponibilità generale |
| az batch pool set |
Aggiornare le proprietà di un pool di Batch. L'aggiornamento di una proprietà in un sottogruppo reimposta le proprietà non specificate di tale gruppo. |
Memoria centrale | Disponibilità generale |
| az batch pool show |
Ottiene informazioni sul pool specificato. |
Memoria centrale | Disponibilità generale |
| az batch pool supported-images |
Eseguire query sulle immagini di macchine virtuali supportate dal servizio Azure Batch. |
Memoria centrale | Disponibilità generale |
| az batch pool supported-images list |
Elenca tutte le immagini di macchine virtuali supportate dal servizio Azure Batch. |
Memoria centrale | Disponibilità generale |
| az batch pool usage-metrics |
Visualizzare le metriche di utilizzo dei pool di Batch. |
Memoria centrale | Disponibilità generale |
| az batch pool usage-metrics list |
Elenca le metriche di utilizzo, aggregate per pool in intervalli di tempo individuali, per l'account specificato. |
Memoria centrale | Disponibilità generale |
az batch pool create
Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale.
az batch pool create [--accelerated-networking {false, true}]
[--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--disk-encryption-targets]
[--enable-inter-node-communication]
[--enable-secure-boot {false, true}]
[--enable-vtpm {false, true}]
[--enable-write-accel {false, true}]
[--encryption-at-host {false, true}]
[--id]
[--image]
[--json-file]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--os-family {2, 3, 4, 5, 6}]
[--os-version]
[--placement {cachedisk}]
[--policy {regional, zonal}]
[--resize-timeout]
[--resource-tags]
[--security-type]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
[--target-communication {classic, default, simplified}]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--vm-size]Parametri facoltativi
Indica se il pool deve abilitare la rete accelerata. La rete accelerata consente la virtualizzazione di I/O radice singola (SR-IOV) a una macchina virtuale, con un miglioramento delle prestazioni di rete. Per altri dettagli, vedere Network https://learn.microsoft.com/azure/virtual- /accelerated-networking-overview. Impostare true per abilitare.
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo. Valori separati da spazi.
Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto in un determinato pool. ID applicazione separati da spazi con versione facoltativa nel formato "id[#version]".
Formula per il numero desiderato di nodi di calcolo nel pool. La formula viene verificata per la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore. Per altre informazioni sulla specifica di questa formula, vedere https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.
Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault. Identificazioni personali del certificato separate da spazi.
Elenco separato da spazi di DiskEncryptionTargets. i valori possibili correnti includono OsDisk e TemporaryDisk.
Indica se il pool consente la comunicazione diretta tra nodi di calcolo. L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false. True se il flag è presente.
Abilitare l'avvio protetto.
Abilitare vTPM.
Specificare se writeAccelerator deve essere abilitato o disabilitato sul disco.
Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Il comportamento predefinito è: la crittografia dell'host verrà disabilitata a meno che questa proprietà non sia impostata su true per la risorsa.
Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID pool all'interno di un account che differisce solo per caso.
Informazioni di riferimento sulle immagini del sistema operativo. Può trattarsi del formato 'publisher:offer:sku[:version]' o di un ID immagine ARM completo del formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se il formato 'publisher:offer:sku[:version]' è facoltativo e se omesso verrà usato più recente. I valori validi possono essere recuperati tramite 'az batch pool supported-images list'. Ad esempio: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".
Il file contenente il pool crea la specifica del parametro delle proprietà in JSON (formattato in modo che corrisponda al corpo della richiesta dell'API REST). Se questo parametro viene specificato, tutti gli argomenti 'Pool Create Properties Parameters' vengono ignorati. Vedere https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.
Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente. Valori separati da spazi nel formato 'key=value'.
Obbligatorio. L'agente del nodo di calcolo batch è un programma che viene eseguito in ogni nodo di calcolo nel pool e fornisce l'interfaccia di comando e controllo tra il nodo di calcolo e il servizio Batch. Esistono implementazioni diverse dell'agente del nodo di calcolo, note come SKU, per sistemi operativi diversi. È necessario specificare uno SKU dell'agente del nodo di calcolo corrispondente al riferimento immagine selezionato. Per ottenere l'elenco degli SKU dell'agente del nodo di calcolo supportati insieme al relativo elenco di riferimenti alle immagini verificate, vedere l'operazione "Elenca gli SKU dell'agente del nodo di calcolo supportati".
Specificare i requisiti di memorizzazione nella cache. I valori possibili sono: Nessuno, ReadOnly, ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
Dimensioni iniziali del disco in GB durante la creazione di un nuovo disco del sistema operativo.
Obbligatorio. I valori possibili sono: 2 - Famiglia di sistemi operativi 2, equivalente a Windows Server 2008 R2 SP1. 3 - Famiglia di sistemi operativi 3, equivalente a Windows Server 2012. 4 - Famiglia di sistemi operativi 4, equivalente a Windows Server 2012 R2. 5 - Famiglia di sistemi operativi 5, equivalente a Windows Server 2016. 6 - Famiglia di sistemi operativi 6, equivalente a Windows Server 2019. Per altre informazioni, vedere Versioni del sistema operativo guest di Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).
Il valore predefinito è * che specifica la versione più recente del sistema operativo per la famiglia di sistemi operativi specificata.
Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutte le macchine virtuali nel pool. Questa proprietà può essere usata dall'utente nella richiesta per scegliere il percorso, ad esempio lo spazio su disco della cache per il provisioning temporaneo del disco del sistema operativo. Per altre informazioni sui requisiti delle dimensioni del disco del sistema operativo temporaneo, vedere Requisiti delle dimensioni del disco del sistema operativo temporaneo per le macchine virtuali Windows in https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e macchine virtuali Linux all'indirizzo https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.
Tipo di criteri di posizionamento dei nodi nei pool batch. Criteri di allocazione usati dal servizio Batch per effettuare il provisioning dei nodi. Se non specificato, Batch userà i criteri internazionali.
Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.
L'utente è in grado di specificare i tag delle risorse per il pool. Qualsiasi risorsa creata per il pool verrà quindi contrassegnata anche con gli stessi tag di risorsa.
Specificare il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare Uefi Impostazioni. Il comportamento predefinito è: Uefi Impostazioni non verrà abilitato a meno che questa proprietà non sia impostata.
Obbligatorio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. Riferimenti a risorse separate da spazi in formato filename=httpurl.
Indica se il servizio Batch deve attendere il completamento di StartTask( ovvero uscire con il codice di uscita 0) prima di pianificare qualsiasi attività nel nodo di calcolo. Se true e StartTask non riesce in un nodo, il servizio Batch ritenta l'avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo inutilizzabile e non pianifica attività. Questa condizione può essere rilevata tramite lo stato del nodo di calcolo e i dettagli dell'errore. Se false, il servizio Batch non attenderà il completamento di StartTask. In questo caso, è possibile avviare l'esecuzione di altre attività nel nodo di calcolo mentre StartTask è ancora in esecuzione; e anche se StartTask ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true. True se il flag è presente.
Tipo di account di archiviazione per il disco gestito.
Modalità di comunicazione del nodo desiderata per il pool. Se questo elemento è presente, sostituisce il targetNodeCommunicationMode esistente configurato nel pool. Se omesso, i metadati esistenti vengono lasciati invariati.
Numero desiderato di nodi di calcolo dedicati nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.
Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.
Se omesso, non verrà crittografato alcun disco nei nodi di calcolo nel pool. Nel pool Linux è supportato solo "TemporaryDisk". nel pool di Windows è necessario specificare "OsDisk" e "TemporaryDisk". Dischi di destinazione separati da crittografare. I valori possono essere OsDisk o TemporaryDisk.
Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool. Il valore predefinito è 1. Il valore massimo è minore di 4 volte il numero di core di vmSize del pool o 256.
Obbligatorio. Per informazioni sulle dimensioni disponibili delle macchine virtuali per i pool di Servizi cloud (pool creati con cloudServiceConfiguration), vedere Dimensioni per Servizi cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supporta tutte le dimensioni di vm Servizi cloud ad eccezione di ExtraSmall, A1V2 e A2V2. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace Macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per Macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Dimensioni per Macchine virtuali (Windows).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch pool create (azure-batch-cli-extensions estensione)
Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Servizi cloud Configurazione o Configurazione macchina virtuale.
az batch pool create [--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--disk-encryption-targets]
[--enable-inter-node-communication]
[--id]
[--image]
[--json-file]
[--metadata]
[--node-agent-sku-id]
[--os-family]
[--os-version]
[--parameters]
[--policy]
[--resize-timeout]
[--resource-group]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--template]
[--vm-size]Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo.
Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto in un determinato pool.
Questa proprietà non deve essere specificata se enableAutoScale è impostato su false. È necessario se enableAutoScale è impostato su true. La formula viene verificata la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore. Per altre informazioni su come specificare questa formula, vedere "Ridimensionare automaticamente i nodi di calcolo in un pool di Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault.
Elenco di spazio separato di DiskEncryptionTargets. i valori possibili correnti includono OsDisk e TemporaryDisk.
Indica se il pool consente la comunicazione diretta tra nodi di calcolo. L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false.
Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID pool all'interno di un account che differisce solo per caso.
Informazioni di riferimento sulle immagini del sistema operativo. Può trattarsi del formato 'publisher:offer:sku[:version]' o di un ID immagine ARM completo del formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se il formato 'publisher:offer:sku[:version]' è facoltativo e se omesso verrà usato più recente. I valori validi possono essere recuperati tramite 'az batch pool node-agent-skus list'. Ad esempio: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".
Il file contenente il pool da creare in formato JSON, se questo parametro viene specificato, tutti gli altri parametri vengono ignorati.
Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
SKU dell'agente del nodo Batch di cui eseguire il provisioning nei nodi di calcolo nel pool. L'agente del nodo Batch è un programma che viene eseguito in ogni nodo del pool e fornisce l'interfaccia di comando e controllo tra il nodo e il servizio Batch. Sono disponibili diverse implementazioni dell'agente del nodo, definite SKU, per sistemi operativi diversi. È necessario specificare uno SKU dell'agente del nodo che corrisponde al riferimento all'immagine selezionata. Per ottenere l'elenco degli SKU dell'agente di nodi supportati insieme all'elenco dei riferimenti alle immagini verificate, vedere l'operazione "Elenca gli SKU dell'agente del nodo supportati".
La famiglia del sistema operativo guest Azure da installare nelle macchine virtuali nel pool. I valori possibili sono: 2 - Famiglia di sistemi operativi 2, equivalente a Windows Server 2008 R2 SP1. 3 - Famiglia di sistemi operativi 3, equivalente a Windows Server 2012. 4 - Famiglia di sistemi operativi 4, equivalente a Windows Server 2012 R2. 5 - Famiglia di sistemi operativi 5, equivalente a Windows Server 2016. Per altre informazioni, vedere Versioni del sistema operativo guest di Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Valori consentiti: 2, 3, 4, 5.
Il valore predefinito è * che specifica la versione più recente del sistema operativo per la famiglia di sistemi operativi specificata.
Valori dei parametri per un file modello JSON del pool batch. Può essere usato solo con --template.
Tipo di criteri di posizionamento dei nodi nei pool batch. Criteri di allocazione usati dal servizio Batch per effettuare il provisioning dei nodi. Se non specificato, Batch userà i criteri internazionali. Valori consentiti: area, zona.
Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
Gruppo di risorse dell'account Batch.
Riga di comando dell'attività di avvio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux.
Elenco di file che il servizio Batch scaricherà nel nodo di calcolo prima di eseguire la riga di comando. Riferimenti a risorse separate da spazi nel formato filename=httpurl.
Indica se il servizio Batch deve attendere che l'attività di avvio venga completata correttamente( ovvero per uscire con il codice di uscita 0) prima di pianificare eventuali attività nel nodo di calcolo. Se true e l'attività di avvio non riesce in un nodo di calcolo, il servizio Batch ritenta l'attività di avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo di calcolo inutilizzabile e non pianifica le attività. Questa condizione può essere rilevata tramite lo stato del nodo e i dettagli degli errori di pianificazione. Se false, il servizio Batch non attenderà il completamento dell'attività di avvio. In questo caso, altre attività possono avviare l'esecuzione nel nodo di calcolo mentre l'attività di avvio è ancora in esecuzione; e anche se l'attività di avvio non riesce, le nuove attività continueranno a essere pianificate nel nodo. L’impostazione predefinita è false. True se il flag è presente.
Numero desiderato di nodi di calcolo dedicati nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.
Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.
Se omesso, non verrà crittografato alcun disco nei nodi di calcolo nel pool. Nel pool Linux è supportato solo "TemporaryDisk". nel pool di Windows è necessario specificare "OsDisk" e "TemporaryDisk". Dischi di destinazione separati da crittografare. I valori possono essere OsDisk o TemporaryDisk.
Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool. Il valore predefinito è 1. Il valore massimo è minore di 4 volte il numero di core di vmSize del pool o 256.
Un file di modello JSON del pool batch. Se si specifica questo parametro, tutti gli altri parametri vengono ignorati.
Obbligatorio. Per informazioni sulle dimensioni disponibili delle macchine virtuali per i pool di Servizi cloud (pool creati con cloudServiceConfiguration), vedere Dimensioni per Servizi cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supporta tutte le dimensioni di vm Servizi cloud ad eccezione di ExtraSmall, A1V2 e A2V2. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace Macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per Macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Dimensioni per Macchine virtuali (Windows).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch pool delete
Elimina un pool dall'account specificato.
Quando si richiede l'eliminazione di un pool, si verificano le azioni seguenti: lo stato pool è impostato per l'eliminazione; tutte le operazioni di ridimensionamento in corso sul pool vengono arrestate; il servizio Batch avvia il ridimensionamento del pool a zero nodi di calcolo; qualsiasi attività in esecuzione su nodi di calcolo esistenti viene terminata e accodata (come se fosse stata richiesta un'operazione di ridimensionamento del pool con l'opzione di accodamento predefinita); infine, il pool viene rimosso dal sistema. Poiché l'esecuzione di attività viene riquedata, l'utente può rieseguire queste attività aggiornando il processo in modo che venga usata come destinazione un pool diverso. Le attività possono quindi essere eseguite nel nuovo pool. Se si vuole eseguire l'override del comportamento di accodamento, è necessario chiamare ridimensionare il pool in modo esplicito per ridurre le dimensioni del pool a zero prima di eliminare il pool. Se si chiama un'API Update, Patch o Delete in un pool nello stato di eliminazione, l'operazione avrà esito negativo con codice di stato HTTP 409 con codice di errore PoolBeingDeleted.
az batch pool delete --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]Parametri necessari
ID del pool da eliminare.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client.
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata.
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client.
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata.
Indica che non è richiesta la conferma.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch pool list
Elenca tutti i pool nell'account specificato.
az batch pool list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
Clausola di $expand OData.
Clausola di $filter OData. Per altre informazioni sulla costruzione di questo filtro, vedere https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.
Clausola di $select OData.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch pool reset
Aggiornare le proprietà di un pool di Batch. Le proprietà non specificate che possono essere aggiornate vengono reimpostate sulle impostazioni predefinite.
az batch pool reset --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-wait-for-success]Parametri necessari
ID del pool da aggiornare.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
Obbligatorio. L'elenco sostituisce tutti i riferimenti al pacchetto dell'applicazione esistenti nel pool. Le modifiche apportate ai riferimenti al pacchetto dell'applicazione influiscono su tutti i nuovi nodi di calcolo che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool finché non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto dell'applicazione in un determinato pool. Se omesso o se si specifica una raccolta vuota, eventuali riferimenti ai pacchetti di applicazioni esistenti vengono rimossi dal pool. È possibile specificare un massimo di 10 riferimenti in un determinato pool.
Obbligatorio. Questo elenco sostituisce tutti i riferimenti al certificato esistenti configurati nel pool. Se si specifica una raccolta vuota, tutti i riferimenti al certificato esistenti vengono rimossi dal pool. Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault.
File contenente la specifica del parametro delle proprietà di aggiornamento del pool in JSON (formattato in modo che corrisponda al corpo della richiesta dell'API REST). Se si specifica questo parametro, tutti gli argomenti del parametro 'Pool Update Properties Parameters' vengono ignorati.
Obbligatorio. Questo elenco sostituisce tutti i metadati esistenti configurati nel pool. Se omesso o se si specifica una raccolta vuota, tutti i metadati esistenti vengono rimossi dal pool.
Riga di comando dell'attività di avvio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux.
Elenco delle impostazioni delle variabili di ambiente per l'attività di avvio. Valori separati da spazi nel formato 'key=value'.
Numero massimo di tentativi consentiti per l'attività.
Indica se il servizio Batch deve attendere che l'attività di avvio venga completata correttamente( ovvero per uscire con il codice di uscita 0) prima di pianificare eventuali attività nel nodo di calcolo. True se il flag è presente. In caso contrario, l'impostazione predefinita è False.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch pool resize
Ridimensionare o arrestare il ridimensionamento di un pool di Batch.
az batch pool resize --pool-id
[--abort]
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
[--resize-timeout]
[--target-dedicated-nodes]
[--target-low-priority-nodes]Parametri necessari
ID del pool.
Parametri facoltativi
Arrestare l'operazione di ridimensionamento del pool.
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
L'operazione verrà eseguita solo se l'ETag corrente della risorsa corrisponde esattamente al valore specificato.
L'operazione verrà eseguita solo se la risorsa è stata modificata dopo il timestamp specificato.
L'operazione non verrà eseguita solo se l'ETag corrente della risorsa corrisponde esattamente al valore specificato.
L'operazione non verrà eseguita solo se la risorsa è stata modificata dopo il timestamp specificato.
Quando i nodi possono essere rimossi dal pool, se le dimensioni del pool diminuiscono.
Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
Numero desiderato di nodi di calcolo dedicati nel pool.
Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch pool set
Aggiornare le proprietà di un pool di Batch. L'aggiornamento di una proprietà in un sottogruppo reimposta le proprietà non specificate di tale gruppo.
az batch pool set --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]Parametri necessari
ID del pool da aggiornare.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. Se questo elemento è presente, sostituisce eventuali riferimenti al pacchetto esistenti. Se si specifica una raccolta vuota, tutti i riferimenti al pacchetto vengono rimossi dal pool. Se omesso, i riferimenti al pacchetto esistenti vengono lasciati invariati. ID applicazione separati da spazi con versione facoltativa nel formato "id[#version]".
Se questo elemento è presente, sostituisce eventuali riferimenti al certificato esistenti configurati nel pool. Se omesso, i riferimenti al certificato esistenti vengono lasciati invariati. Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault. Identificazioni personali del certificato separate da spazi.
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client.
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata.
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client.
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata.
File contenente la specifica del parametro patch del pool in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti del pool vengono ignorati.
Se questo elemento è presente, sostituisce tutti i metadati esistenti configurati nel pool. Se si specifica una raccolta vuota, tutti i metadati vengono rimossi dal pool. Se omesso, i metadati esistenti vengono lasciati invariati. Valori separati da spazi nel formato 'key=value'.
Obbligatorio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Valori separati da spazi nel formato 'key=value'.
Numero massimo di tentativi dell'attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente il numero di tentativi. Il servizio Batch proverà l'attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova l'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non ritenta l'attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta l'attività senza limite, ma non è consigliabile per un'attività di avvio o per qualsiasi attività. Il valore predefinito è 0, ovvero nessun tentativo.
I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. Riferimenti a risorse separate da spazi in formato filename=httpurl.
Indica se il servizio Batch deve attendere il completamento di StartTask( ovvero uscire con il codice di uscita 0) prima di pianificare qualsiasi attività nel nodo di calcolo. Se true e StartTask non riesce in un nodo, il servizio Batch ritenta l'avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo inutilizzabile e non pianifica attività. Questa condizione può essere rilevata tramite lo stato del nodo di calcolo e i dettagli dell'errore. Se false, il servizio Batch non attenderà il completamento di StartTask. In questo caso, è possibile avviare l'esecuzione di altre attività nel nodo di calcolo mentre StartTask è ancora in esecuzione; e anche se StartTask ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true. Specificare 'true' o 'false' per aggiornare la proprietà.
Modalità di comunicazione del nodo desiderata per il pool. Se questo elemento è presente, sostituisce il targetNodeCommunicationMode esistente configurato nel pool. Se omesso, i metadati esistenti vengono lasciati invariati.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch pool show
Ottiene informazioni sul pool specificato.
az batch pool show --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]Parametri necessari
ID del pool da ottenere.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
Clausola di $expand OData.
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client.
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata.
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client.
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata.
Clausola di $select OData.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per