az batch pool
Gestire i pool di Batch.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az batch pool autoscale |
Gestire il ridimensionamento automatico dei pool di Batch. |
Nucleo | GA |
| az batch pool autoscale disable |
Disabilita il ridimensionamento automatico per un pool. |
Nucleo | GA |
| az batch pool autoscale enable |
Abilita il ridimensionamento automatico per un pool. |
Nucleo | GA |
| az batch pool autoscale evaluate |
Ottiene il risultato della valutazione di una formula di ridimensionamento automatico nel pool. |
Nucleo | GA |
| az batch pool create |
Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Configurazione dei servizi cloud o Configurazione macchina virtuale. |
Nucleo | GA |
| az batch pool delete |
Elimina un pool dall'account specificato. |
Nucleo | GA |
| az batch pool list |
Elenca tutti i pool nell'account specificato. |
Nucleo | GA |
| az batch pool node-counts |
Ottenere i conteggi dei nodi per i pool di Batch. |
Nucleo | GA |
| az batch pool node-counts list |
Ottiene il numero di nodi di calcolo in ogni stato, raggruppati per pool. |
Nucleo | GA |
| 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. |
Nucleo | GA |
| az batch pool resize |
Ridimensionare o arrestare il ridimensionamento di un pool di Batch. |
Nucleo | GA |
| 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. |
Nucleo | GA |
| az batch pool show |
Ottiene informazioni sul pool specificato. |
Nucleo | GA |
| az batch pool supported-images |
Eseguire query sulle immagini di macchine virtuali supportate dal servizio Azure Batch. |
Nucleo | GA |
| az batch pool supported-images list |
Elenca tutte le immagini di macchine virtuali supportate dal servizio Azure Batch. |
Nucleo | GA |
| az batch pool usage-metrics |
Visualizzare le metriche di utilizzo dei pool di Batch. |
Nucleo | GA |
| az batch pool usage-metrics list |
Elenca le metriche di utilizzo, aggregate per pool in intervalli di tempo individuali, per l'account specificato. |
Nucleo | GA |
az batch pool create
Creare un pool di Batch in un account. Quando si crea un pool, scegliere gli argomenti da Configurazione dei servizi cloud o Configurazione macchina virtuale.
az batch pool create [--accelerated-networking {false, true}]
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--auto-scale-formula]
[--defer-os-rolling-upgrade {false, true}]
[--disable-auto-rollback {false, true}]
[--disk-encryption-targets]
[--enable-auto-os-upgrade {false, true}]
[--enable-cross-zone-upgrade {false, true}]
[--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]
[--max-batch-instance-percent]
[--max-unhealthy-instance-percent]
[--max-unhealthy-upgraded-instance-percent]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--pause-time-between-batches]
[--placement]
[--policy]
[--prioritize-unhealthy-instances {false, true}]
[--resize-timeout]
[--resource-tags]
[--rollback-failed-instances-on-policy-breach {false, true}]
[--security-type]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--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]
[--upgrade-policy-mode]
[--use-rolling-upgrade-policy {false, true}]
[--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: https://learn.microsoft.com/azure/virtual-network/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.
Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). # pylint: disable=line-too-long Modifiche ai riferimenti al pacchetto influiscono su tutti i nuovi nodi che si uniscono 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. 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 sulla specifica di questa formula, vedere "Ridimensionare automaticamente i nodi di calcolo in un pool di Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
Rinviare gli aggiornamenti del sistema operativo nelle macchine virtuali se eseguono attività. True se il flag è presente.
Indica se la funzionalità di rollback dell'immagine del sistema operativo deve essere disabilitata. True se il flag è presente.
Elenco separato da spazi di DiskEncryptionTargets. i valori possibili correnti includono OsDisk e TemporaryDisk.
Indica se gli aggiornamenti del sistema operativo devono essere applicati automaticamente alle istanze del set di scalabilità in sequenza quando diventa disponibile una versione più recente dell'immagine del sistema operativo. :code:<br />:code:<br /> Se è impostato su true per i pool basati su Windows, WindowsConfiguration.enableAutomaticUpdates <https://learn.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#windowsconfiguration>_ non può essere impostato su true. True se il flag è presente.
Consentire al set di scalabilità di macchine virtuali di ignorare i limiti az durante la creazione di batch di aggiornamento. Prendere in considerazione il dominio di aggiornamento e maxBatchInstancePercent per determinare le dimensioni del batch. Questo campo può essere impostato su true o false solo quando si usa NodePlacementConfiguration come Zonal. True se il flag è presente.
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.
Stringa che identifica in modo univoco il pool all'interno dell'account. 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. Obbligatorio.
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://learn.microsoft.com/rest/api/batchservice/pool/add?tabs=HTTP#request-body.
Percentuale massima delle istanze totali di macchine virtuali che verranno aggiornate contemporaneamente dall'aggiornamento in sequenza in un unico batch. Poiché si tratta di un valore massimo, le istanze non integre nei batch precedenti o futuri possono causare la diminuzione della percentuale di istanze in un batch per garantire una maggiore affidabilità. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent.
Percentuale massima delle istanze totali della macchina virtuale nel set di scalabilità che possono essere contemporaneamente non integre, in seguito all'aggiornamento o rilevate in uno stato non integro dai controlli di integrità della macchina virtuale prima dell'interruzione dell'aggiornamento in sequenza. Questo vincolo verrà controllato prima di avviare qualsiasi batch. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent.
Percentuale massima di istanze di macchina virtuale aggiornate che possono essere trovate in uno stato non integro. Questo controllo verrà eseguito dopo l'aggiornamento di ogni batch. Se questa percentuale viene mai superata, l'aggiornamento in sequenza viene interrotto. Il valore di questo campo deve essere compreso tra 0 e 100 inclusi.
Elenco di coppie nome-valore associate al pool come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente. Valori separati da spazi nel formato 'key=value'.
SKU dell'agente del nodo di calcolo Batch di cui eseguire il provisioning nei nodi di calcolo nel pool. 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". Obbligatorio.
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.
Tempo di attesa tra il completamento dell'aggiornamento per tutte le macchine virtuali in un batch e l'avvio del batch successivo. La durata dell'ora deve essere specificata nel formato ISO 8601. Il formato previsto è una durata ISO-8601.
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. "cachedisk".
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. I valori noti sono: "regional" e "zonal".
Aggiornare tutte le istanze non integre in un set di scalabilità prima di qualsiasi istanza integra. True se il flag è presente.
Timeout per l'allocazione dei nodi di calcolo al pool. 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.
Il rollback delle istanze non riuscite nel modello precedente se i criteri di aggiornamento in sequenza vengono violati. True se il flag è presente.
Specificare il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.
Riga di comando di StartTask. 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). Obbligatorio.
Elenco delle impostazioni delle variabili di ambiente per StartTask. 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 in modo specifico 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 (nessun tentativo).
Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker. 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.
L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo. 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.
Modalità di aggiornamento del sistema operativo del pool.
Indica se i criteri di aggiornamento in sequenza devono essere usati durante l'aggiornamento automatico del sistema operativo. L'aggiornamento automatico del sistema operativo eseguirà il fallback ai criteri predefiniti se non sono definiti criteri nel set di scalabilità di macchine virtuali. True se il flag è presente.
Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace delle macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per le macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o dimensioni per le 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). Obbligatorio.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
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.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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 ottenere. Obbligatorio.
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 è stata modificata dall'ora specificata.
Non richiedere conferma.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
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.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
Clausola di $select OData.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
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.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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]
[--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. È necessario solo in alternativa, impostato dalla 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.
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 raccoltaempty, tutti i metadati esistenti vengono rimossi da thePool.
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 di ripetizione dell'attività.
Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. 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 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.
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
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
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.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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. È necessario solo in alternativa, impostato dalla 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). Formato di durata ISO-8601.
Numero desiderato di nodi di calcolo dedicati nel pool.
Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
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.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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]
[--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 ottenere. Obbligatorio.
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.
Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. 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]".
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 è stata modificata dall'ora specificata.
File contenente la specifica 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.
Elenco di coppie nome-valore associate al pool come metadati. 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'.
Riga di comando di StartTask. 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). Obbligatorio.
Elenco delle impostazioni delle variabili di ambiente per StartTask. 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 in modo specifico 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 (nessun tentativo).
Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker. 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.
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
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
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.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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. Obbligatorio.
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 è stata modificata dall'ora specificata.
Clausola di $select OData.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
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.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
