Pool - Update Properties

Servizio:

Batch Service

Versione API:

2024-07-01.20.0

Aggiorna le proprietà del pool specificato.
In questo modo tutte le proprietà aggiornabili del pool vengono sostituite completamente. Ad esempio, se al pool è associato startTask e se StartTask non è specificato con questa richiesta, il servizio Batch rimuoverà l'oggetto StartTask esistente.

POST {batchUrl}/pools/{poolId}/updateproperties?api-version=2024-07-01.20.0

Con parametri facoltativi:

POST {batchUrl}/pools/{poolId}/updateproperties?timeout={timeout}&api-version=2024-07-01.20.0

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
batchUrl	path	True	string	URL di base per tutte le richieste del servizio Azure Batch.
poolId	path	True	string	ID del pool da aggiornare.
api-version	query	True	string	Versione dell'API client.
timeout	query		integer int32	Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è maggiore di 30, verrà usato il valore predefinito.

Intestazione della richiesta

Media Types: "application/json; odata=minimalmetadata"

Nome	Necessario	Tipo	Descrizione
client-request-id		string uuid	Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date		string date-time-rfc1123	Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Corpo della richiesta

Media Types: "application/json; odata=minimalmetadata"

Nome	Necessario	Tipo	Descrizione
applicationPackageReferences	True	ApplicationPackageReference[]	Elenco dei pacchetti dell'applicazione da installare in ogni nodo di calcolo nel pool. 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.
certificateReferences	True	CertificateReference[]	Elenco di certificati da installare in ogni nodo di calcolo nel pool. 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 'estensione Azure KeyVault.
metadata	True	MetadataItem[]	Elenco di coppie nome-valore associate al pool come metadati. 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.
startTask		StartTask	Un'attività da eseguire in ogni nodo di calcolo quando viene aggiunto al pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando il nodo di calcolo viene riavviato. Se questo elemento è presente, sovrascrive qualsiasi StartTask esistente. Se omesso, qualsiasi StartTask esistente viene rimosso dal pool.
targetNodeCommunicationMode		NodeCommunicationMode	Modalità di comunicazione del nodo desiderata per il pool. Questa impostazione sostituisce qualsiasi impostazione targetNodeCommunication esistente nel pool. Se omesso, l'impostazione esistente è predefinita.

Risposte

Nome	Tipo	Descrizione
204 No Content		La richiesta al servizio Batch ha avuto esito positivo. Intestazioni client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Errore del servizio Batch.

Sicurezza

azure_auth

Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	Rappresentare l'account utente

Authorization

Tipo: apiKey
In: header

Esempio

Pool update

Esempio di richiesta

HTTP

POST account.region.batch.azure.com/pools/poolId/updateproperties?api-version=2024-07-01.20.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "certificateReferences": [],
  "applicationPackageReferences": [],
  "metadata": []
}

Risposta di esempio

Codice di stato:

204

Definizioni

Nome	Descrizione
ApplicationPackageReference	Riferimento a un pacchetto da distribuire nei nodi di calcolo.
AutoUserScope	Ambito dell'utente automatico
AutoUserSpecification	Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch.
BatchError	Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail	Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
CertificateReference	Riferimento a un certificato da installare nei nodi di calcolo in un pool.
CertificateStoreLocation	Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
CertificateVisibility	Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.
ComputeNodeIdentityReference	Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
ContainerHostBatchBindMountEntry	Voce di percorso e modalità di montaggio da montare nel contenitore di attività.
ContainerHostDataPath	Percorsi che verranno montati nel contenitore dell'attività contenitore.
ContainerRegistry	Registro contenitori privato.
ContainerWorkingDirectory	Percorso della directory di lavoro dell'attività del contenitore.
ElevationLevel	Livello di elevazione dell'utente.
EnvironmentSetting	Variabile di ambiente da impostare in un processo task.
ErrorMessage	Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
MetadataItem	Coppia nome-valore associata a una risorsa del servizio Batch.
NodeCommunicationMode	Determina il modo in cui un pool comunica con il servizio Batch.
PoolUpdatePropertiesParameter	Set di modifiche da apportare a un pool.
ResourceFile	Un singolo file o più file da scaricare in un nodo di calcolo.
StartTask	Attività eseguita quando un nodo viene aggiunto a un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato l'immagine.
TaskContainerSettings	Impostazioni del contenitore per un'attività.
UserIdentity	Definizione dell'identità utente in cui viene eseguita l'attività.

ApplicationPackageReference

Riferimento a un pacchetto da distribuire nei nodi di calcolo.

Nome	Tipo	Descrizione
applicationId	string	ID dell'applicazione da distribuire. Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Versione dell'applicazione da distribuire. Se omesso, viene distribuita la versione predefinita. Se questo viene omesso in un pool e non viene specificata alcuna versione predefinita per questa applicazione, la richiesta ha esito negativo con il codice di errore InvalidApplicationPackageReferences e il codice di stato HTTP 409. Se questa operazione viene omessa in un'attività e non viene specificata alcuna versione predefinita per questa applicazione, l'attività ha esito negativo con un errore di pre-elaborazione.

AutoUserScope

Ambito dell'utente automatico

Nome	Tipo	Descrizione
pool	string	Specifica che l'attività viene eseguita come account utente automatico comune creato in ogni nodo di calcolo in un pool.
task	string	Specifica che il servizio deve creare un nuovo utente per l'attività.

AutoUserSpecification

Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch.

Nome	Tipo	Descrizione
elevationLevel	ElevationLevel	Livello di elevazione dell'utente automatico. Il valore predefinito è nonAdmin.
scope	AutoUserScope	Ambito dell'utente automatico Il valore predefinito è pool. Se il pool esegue Windows, è necessario specificare il valore Task se è necessario un isolamento più rigoroso tra le attività. Ad esempio, se l'attività modifica il Registro di sistema in modo da influire su altre attività o se i certificati sono stati specificati nel pool che non devono essere accessibili dalle normali attività, ma devono essere accessibili da StartTasks.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message	ErrorMessage	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
values	BatchErrorDetail[]	Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
key	string	Identificatore che specifica il significato della proprietà Value.
value	string	Informazioni aggiuntive incluse nella risposta di errore.

CertificateReference

Riferimento a un certificato da installare nei nodi di calcolo in un pool.

Nome	Tipo	Descrizione
storeLocation	CertificateStoreLocation	Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato. Il valore predefinito è currentuser. Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows. 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.
storeName	string	Nome dell'archivio certificati nel nodo di calcolo in cui installare il certificato. Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows. I nomi comuni degli archivi includono: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ma è possibile usare anche qualsiasi nome di archivio personalizzato. Il valore predefinito è My.
thumbprint	string	Identificazione personale del certificato.
thumbprintAlgorithm	string	Algoritmo a cui è associata l'identificazione personale. Deve essere sha1.
visibility	CertificateVisibility[]	Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato. È possibile specificare più visibilità in questa raccolta. Il valore predefinito è tutti Gli account.

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.

Nome	Tipo	Descrizione
currentuser	string	I certificati devono essere installati nell'archivio certificati CurrentUser.
localmachine	string	I certificati devono essere installati nell'archivio certificati LocalMachine.

CertificateVisibility

Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.

Nome	Tipo	Descrizione
remoteuser	string	Il certificato deve essere visibile agli account utente in cui gli utenti accedono in remoto al nodo di calcolo.
starttask	string	Il certificato deve essere visibile all'account utente in cui viene eseguito StartTask. Si noti che se l'ambito dell'utente automatico è Pool sia per StartTask che per un'attività, questo certificato sarà visibile anche all'attività.
task	string	Il certificato deve essere visibile agli account utente in cui vengono eseguite le attività di processo.

ComputeNodeIdentityReference

Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa ARM dell'identità assegnata dall'utente.

ContainerHostBatchBindMountEntry

Voce di percorso e modalità di montaggio da montare nel contenitore di attività.

Nome	Tipo	Descrizione
isReadOnly	boolean	Montare o meno questo percorso di origine come modalità di sola lettura. Il valore predefinito è false (modalità lettura/scrittura). Per Linux, se si monta questo percorso come modalità di lettura/scrittura, ciò non significa che tutti gli utenti nel contenitore dispongano dell'accesso in lettura/scrittura per il percorso, dipende dall'accesso nella macchina virtuale host. Se questo percorso viene montato in sola lettura, tutti gli utenti all'interno del contenitore non potranno modificare il percorso.
source	ContainerHostDataPath	Il percorso che può essere montato nel cliente del contenitore può selezionare.

ContainerHostDataPath

Percorsi che verranno montati nel contenitore dell'attività contenitore.

Nome	Tipo	Descrizione
Applications	string	Percorso delle applicazioni.
JobPrep	string	Percorso dell'attività di preparazione del processo.
Shared	string	Percorso dell'attività a più istanze in cui condividere i propri file.
Startup	string	Percorso dell'attività di avvio.
Task	string	Percorso dell'attività.
VfsMounts	string	Il percorso contiene tutti i file system virtuali montati in questo nodo.

ContainerRegistry

Registro contenitori privato.

Nome	Tipo	Descrizione
identityReference	ComputeNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password. Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
password	string	Password per accedere al server del Registro di sistema.
registryServer	string	URL del Registro di sistema. Se omesso, il valore predefinito è "docker.io".
username	string	Nome utente per accedere al server del Registro di sistema.

ContainerWorkingDirectory

Percorso della directory di lavoro dell'attività del contenitore.

Nome	Tipo	Descrizione
containerImageDefault	string	Usare la directory di lavoro definita nell'immagine del contenitore. Tenere presente che questa directory non conterrà i file di risorse scaricati da Batch.
taskWorkingDirectory	string	Usare la directory di lavoro dell'attività del servizio Batch standard, che conterrà i file di risorse attività popolati da Batch.

ElevationLevel

Livello di elevazione dell'utente.

Nome	Tipo	Descrizione
admin	string	L'utente è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete.
nonadmin	string	L'utente è un utente standard senza accesso con privilegi elevati.

EnvironmentSetting

Variabile di ambiente da impostare in un processo task.

Nome	Tipo	Descrizione
name	string	Nome della variabile di ambiente.
value	string	Valore della variabile di ambiente.

ErrorMessage

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
lang	string	Codice linguistico del messaggio di errore
value	string	Testo del messaggio.

MetadataItem

Coppia nome-valore associata a una risorsa del servizio Batch.

Nome	Tipo	Descrizione
name	string	Nome dell'elemento di metadati.
value	string	Valore dell'elemento di metadati.

NodeCommunicationMode

Determina il modo in cui un pool comunica con il servizio Batch.

Nome	Tipo	Descrizione
classic	string	I nodi che usano la modalità di comunicazione classica richiedono la comunicazione TCP in ingresso sulle porte 29876 e 29877 da "BatchNodeManagement. Tag del servizio {region}" e comunicazione TCP in uscita sulla porta 443 per "Storage.region" e "BatchNodeManagement. Tag del servizio {region}".
default	string	La modalità di comunicazione del nodo viene impostata automaticamente dal servizio Batch.
simplified	string	I nodi che usano la modalità di comunicazione semplificata richiedono la comunicazione TCP in uscita sulla porta 443 a "BatchNodeManagement. Tag del servizio {region}". Non sono necessarie porte in ingresso aperte.

PoolUpdatePropertiesParameter

Set di modifiche da apportare a un pool.

Nome	Tipo	Descrizione
applicationPackageReferences	ApplicationPackageReference[]	Elenco dei pacchetti dell'applicazione da installare in ogni nodo di calcolo nel pool. 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.
certificateReferences	CertificateReference[]	Elenco di certificati da installare in ogni nodo di calcolo nel pool. 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 'estensione Azure KeyVault.
metadata	MetadataItem[]	Elenco di coppie nome-valore associate al pool come metadati. 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.
startTask	StartTask	Un'attività da eseguire in ogni nodo di calcolo quando viene aggiunto al pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando il nodo di calcolo viene riavviato. Se questo elemento è presente, sovrascrive qualsiasi StartTask esistente. Se omesso, qualsiasi StartTask esistente viene rimosso dal pool.
targetNodeCommunicationMode	NodeCommunicationMode	Modalità di comunicazione del nodo desiderata per il pool. Questa impostazione sostituisce qualsiasi impostazione targetNodeCommunication esistente nel pool. Se omesso, l'impostazione esistente è predefinita.

ResourceFile

Un singolo file o più file da scaricare in un nodo di calcolo.

Nome	Tipo	Descrizione
autoStorageContainerName	string	Nome del contenitore di archiviazione nell'account di archiviazione automatico. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata.
blobPrefix	string	Prefisso BLOB da usare durante il download di BLOB da un contenitore di Archiviazione di Azure. Verranno scaricati solo i BLOB i cui nomi iniziano con il prefisso specificato. La proprietà è valida solo quando si usa autoStorageContainerName o storageContainerUrl. Questo prefisso può essere un nome file parziale o una sottodirectory. Se non viene specificato un prefisso, verranno scaricati tutti i file nel contenitore.
fileMode	string	Attributo della modalità di autorizzazione file in formato ottale. Questa proprietà si applica solo ai file scaricati nei nodi di calcolo Linux. Verrà ignorato se viene specificato per un oggetto resourceFile che verrà scaricato in un nodo di calcolo Windows. Se questa proprietà non viene specificata per un nodo di calcolo Linux, al file viene applicato il valore predefinito 0770.
filePath	string	Percorso nel nodo di calcolo in cui scaricare i file rispetto alla directory di lavoro dell'attività. Se viene specificata la proprietà httpUrl, filePath è obbligatorio e descrive il percorso in cui verrà scaricato il file, incluso il nome file. In caso contrario, se si specifica la proprietà autoStorageContainerName o storageContainerUrl, filePath è facoltativo ed è la directory in cui scaricare i file. Nel caso in cui filePath venga usato come directory, qualsiasi struttura di directory già associata ai dati di input verrà mantenuta in modo completo e accodato alla directory filePath specificata. Il percorso relativo specificato non può uscire dalla directory di lavoro dell'attività, ad esempio tramite '..'.
httpUrl	string	URL del file da scaricare. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Se l'URL punta ad Archiviazione BLOB di Azure, deve essere leggibile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un BLOB nell'archiviazione di Azure: includere una firma di accesso condiviso (SAS) che concede le autorizzazioni di lettura per il BLOB, usare un'identità gestita con autorizzazione di lettura o impostare l'ACL per il BLOB o il relativo contenitore per consentire l'accesso pubblico.
identityReference	ComputeNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere all'archiviazione BLOB di Azure specificata da storageContainerUrl o httpUrl Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
storageContainerUrl	string	URL del contenitore BLOB all'interno di Archiviazione BLOB di Azure. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Questo URL deve essere leggibile ed elencabile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un contenitore nell'archiviazione di Azure: includere una firma di accesso condiviso che concede autorizzazioni di lettura ed elenco per il contenitore, usare un'identità gestita con autorizzazioni di lettura ed elenco o impostare l'ACL per il contenitore per consentire l'accesso pubblico.

StartTask

Attività eseguita quando un nodo viene aggiunto a un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato l'immagine.

Nome	Tipo	Descrizione
commandLine	string	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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	TaskContainerSettings	Impostazioni per il contenitore in cui viene eseguito StartTask. Quando viene specificato questo parametro, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) nel contenitore, tutte le variabili di ambiente delle attività vengono mappate nel contenitore e la riga di comando Task viene eseguita nel contenitore. I file prodotti nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, ovvero le API di file batch non saranno in grado di accedere a tali file.
environmentSettings	EnvironmentSetting[]	Elenco delle impostazioni delle variabili di ambiente per StartTask.
maxTaskRetryCount	integer	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).
resourceFiles	ResourceFile[]	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à.
userIdentity	UserIdentity	Identità utente con cui viene eseguito StartTask. Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.
waitForSuccess	boolean	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.

TaskContainerSettings

Impostazioni del contenitore per un'attività.

Nome	Tipo	Descrizione
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Percorsi da montare nell'attività contenitore. Se questa matrice è null o non è presente, l'attività contenitore monta l'intera unità disco temporanea in Windows (o AZ_BATCH_NODE_ROOT_DIR in Linux). Se questa matrice è impostata come vuota, non verrà montato alcun percorso dati nel contenitore.
containerRunOptions	string	Opzioni aggiuntive per il comando create del contenitore. Queste opzioni aggiuntive vengono fornite come argomenti al comando "docker create", oltre a quelli controllati dal servizio Batch.
imageName	string	Immagine da usare per creare il contenitore in cui verrà eseguita l'attività. Si tratta del riferimento completo all'immagine, come specificato in "docker pull". Se non viene specificato alcun tag come parte del nome dell'immagine, il tag ":latest" viene usato come valore predefinito.
registry	ContainerRegistry	Registro privato che contiene l'immagine del contenitore. Questa impostazione può essere omessa se è già stata specificata durante la creazione del pool.
workingDirectory	ContainerWorkingDirectory	Percorso della directory di lavoro dell'attività del contenitore. Il valore predefinito è 'taskWorkingDirectory'.

UserIdentity

Definizione dell'identità utente in cui viene eseguita l'attività.

Nome	Tipo	Descrizione
autoUser	AutoUserSpecification	Utente automatico con cui viene eseguita l'attività. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.
username	string	Nome dell'identità utente con cui viene eseguita l'attività. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.