Pool - Patch

Service:

Batch Service

API Version:

2023-11-01.18.0

Aggiornamenti le proprietà del pool specificato.
In questo modo vengono sostituite solo le proprietà pool specificate nella richiesta. Ad esempio, se al pool è associato un oggetto StartTask e una richiesta non specifica un elemento StartTask, il pool mantiene l'oggetto StartTask esistente.

PATCH {batchUrl}/pools/{poolId}?api-version=2023-11-01.18.0

With optional parameters:

PATCH {batchUrl}/pools/{poolId}?timeout={timeout}&api-version=2023-11-01.18.0

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
batchUrl	path	True	string	URL di base per tutte le richieste di 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 per cui il server può dedicare l'elaborazione della richiesta, in secondi. Il valore predefinito è 30 secondi.

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 impostano in genere questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.
If-Match		string	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.
If-None-Match		string	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.
If-Modified-Since		string date-time-rfc1123	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.
If-Unmodified-Since		string date-time-rfc1123	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.

Corpo della richiesta

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

Nome	Tipo	Descrizione
applicationPackageReferences	ApplicationPackageReference[]	Elenco di pacchetti da installare in ogni nodo di calcolo del pool. Le modifiche apportate 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 finché 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 a Package vengono rimossi dal pool. Se omesso, i riferimenti al pacchetto esistenti vengono lasciati invariati.
certificateReferences	CertificateReference[]	Elenco di certificati da installare in ogni nodo di calcolo del pool. 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 .
metadata	MetadataItem[]	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.
startTask	StartTask	Attività da eseguire in ogni nodo di calcolo durante l'aggiunta 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 lasciato invariato.
targetNodeCommunicationMode	NodeCommunicationMode	Modalità di comunicazione del nodo desiderata per il pool. Se questo elemento è presente, sostituisce l'oggetto targetNodeCommunicationMode esistente configurato nel pool. Se omesso, i metadati esistenti vengono lasciati invariati.

Risposte

Nome	Tipo	Descrizione
200 OK		La richiesta al servizio Batch ha avuto esito positivo. Headers 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

Microsoft Entra flusso del codice di autenticazione OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	Rappresentare l'account utente

Authorization

Type: apiKey
In: header

Esempio

Patch the Pool

Sample Request

HTTP

PATCH account.region.batch.azure.com/pools/poolId?api-version=2023-11-01.18.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  }
}

Sample Response

Status code:

200

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 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.
ContainerRegistry	Un registro contenitori privato.
ContainerWorkingDirectory	Percorso della directory di lavoro dell'attività 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 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.
PoolPatchParameter	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 oppure 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 e viene generato 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 un modo che potrebbe 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, che deve 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 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, ovvero creati con cloudServiceConfiguration o con virtualMachineConfiguration usando un riferimento a un'immagine di 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, ovvero creati con cloudServiceConfiguration o con virtualMachineConfiguration usando un riferimento a un'immagine di Windows. I nomi degli archivi comuni includono: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ma è anche possibile usare 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à del 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.

ContainerRegistry

Un registro contenitori privato.

Nome	Tipo	Descrizione
identityReference	ComputeNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container anziché al nome utente e alla 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à 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 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 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 di servizio {region}" e comunicazione TCP in uscita sulla porta 443 per "Storage.region" e "BatchNodeManagement. Tag di 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.

PoolPatchParameter

Set di modifiche da apportare a un pool.

Nome	Tipo	Descrizione
applicationPackageReferences	ApplicationPackageReference[]	Elenco di pacchetti da installare in ogni nodo di calcolo del pool. Le modifiche apportate 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 finché 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 a Package vengono rimossi dal pool. Se omesso, i riferimenti al pacchetto esistenti vengono lasciati invariati.
certificateReferences	CertificateReference[]	Elenco di certificati da installare in ogni nodo di calcolo del pool. 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 .
metadata	MetadataItem[]	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.
startTask	StartTask	Attività da eseguire in ogni nodo di calcolo durante l'aggiunta 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 lasciato invariato.
targetNodeCommunicationMode	NodeCommunicationMode	Modalità di comunicazione del nodo desiderata per il pool. Se questo elemento è presente, sostituisce l'oggetto targetNodeCommunicationMode esistente configurato nel pool. Se omesso, i metadati esistenti vengono lasciati invariati.

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 automatica. 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 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 viene specificata la proprietà autoStorageContainerName o storageContainerUrl, filePath è facoltativo ed è la directory in cui scaricare i file. Nel caso in cui filePath venga usato come directory, tutte le strutture di directory già associate ai dati di input verranno mantenute complete e aggiunte alla directory filePath specificata. Il percorso relativo specificato non può uscire dalla directory di lavoro dell'attività, ad esempio utilizzando '.'.
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 a 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 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 ai Archiviazione BLOB di Azure specificati 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 in 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 oppure 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://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
containerSettings	TaskContainerSettings	Impostazioni per il contenitore in cui viene eseguito StartTask. Quando viene specificato, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory Azure Batch nel nodo) nel contenitore, tutte le variabili di ambiente dell'attività vengono mappate al 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, vale a dire che le API del 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 di ripetizione 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 tenterà 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.
resourceFiles	ResourceFile[]	Elenco di file che il servizio Batch scaricherà nel nodo di calcolo prima di eseguire la riga di comando. Per l'elenco dei file di risorse è prevista una dimensione massima. 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 dell'applicazione 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 per uscire con il codice di uscita 0, prima di pianificare le attività nel nodo di calcolo. Se true e StartTask ha esito negativo in un nodo, il servizio Batch ritenta startTask fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata 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, altre attività possono avviare l'esecuzione 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
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à. Questo è il riferimento completo all'immagine, come verrebbe specificato in "docker pull". Se non viene fornito alcun tag come parte del nome 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à 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 in cui viene eseguita l'attività. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno, ma non entrambi.