Pools - Replace Pool Properties

Non è disponibile alcun contenuto da inviare per questa richiesta, ma le intestazioni possono essere utili.

Intestazioni

• DataServiceId: string
• ETag: string
• Last-Modified: string
• client-request-id: string
• request-id: string

BatchError

Risposta di errore imprevista.

ElevationLevel

Livello di elevazione dell'utente automatico. Il valore predefinito è nonAdmin.

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à.

string

L'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}).

string

Versione dell'applicazione da distribuire. Se omesso, viene distribuita la versione predefinita. Se questo viene omesso in un Pool e non viene specificata una versione predefinita per questa applicazione, la richiesta fallisce con il codice di errore InvalidApplicationPackageReferences e il codice di stato HTTP 409. Se questo viene omesso in un Task e non è specificata una versione predefinita per questa applicazione, il Task fallisce con un errore di pre-elaborazione.

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.

BatchErrorMessage

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

BatchErrorDetail[]

Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

string

Identificatore che specifica il significato della proprietà Value.

string

Informazioni aggiuntive incluse nella risposta di errore.

string

Il codice linguistico del messaggio di errore.

string

Testo del messaggio.

string

Nome dell'elemento di metadati.

string

Valore dell'elemento di metadati.

string (arm-id)

ID risorsa ARM dell'identità assegnata dall'utente.

BatchApplicationPackageReference[]

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.

BatchMetadataItem[]

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.

BatchStartTask

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.

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).

BatchTaskContainerSettings

Le impostazioni del contenitore sotto cui viene eseguita la StartTask. Quando questo viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle directory Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.

EnvironmentSetting[]

Elenco delle impostazioni delle variabili di ambiente per StartTask.

integer (int32)

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).

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

L'identità utente sotto cui viene eseguito il StartTask. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task.

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 è vero.

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.

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.

string

L'immagine da usare per creare il contenitore in cui verrà eseguito il Task. Questa è la referenza completa all'Image, come specificato per "docker pull". Se non viene fornito alcun tag come parte del nome dell'Immagine, il tag ":latest" viene usato come predefinito.

ContainerRegistryReference

Il registro privato che contiene l'immagine del contenitore. Questa impostazione può essere omessa se era già stata fornita alla creazione del Pool.

ContainerWorkingDirectory

La posizione della directory di lavoro Task del container. Il valore predefinito è 'taskWorkingDirectory'.

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.

ContainerHostDataPath

Il percorso che può essere montato nel cliente del contenitore può selezionare.

BatchNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password.

string (password)

Password per accedere al server del Registro di sistema.

string (uri)

URL del Registro di sistema. Se omesso, il valore predefinito è "docker.io".

string

Nome utente per accedere al server del Registro di sistema.

string

Nome della variabile di ambiente.

string

Valore della variabile di ambiente.

string

Il nome del container di archiviazione nell'account di auto storage. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata.

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.

string

Attributo della modalità di autorizzazione file in formato ottale. Questa proprietà si applica solo ai file scaricati su Linux Compute Nodes. Verrà ignorato se viene specificato per un file di risorsa che verrà scaricato su un nodo di calcolo di Windows. Se questa proprietà non è specificata per un nodo Linux Compute, allora viene applicato un valore predefinito 0770 al file.

string

La posizione sul Nodo di Calcolo su cui scaricare il/i file/i, rispetto alla directory operativa del Task. 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 del Task (ad esempio usando '..').

string (uri)

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.

BatchNodeIdentityReference

Il riferimento all'identità assegnata dall'utente da utilizzare per accedere a Azure Blob Storage specificato da storageContainerUrl o httpUrl.

string (uri)

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.

AutoUserSpecification

L'utente automatico sotto cui viene eseguito il Task. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.

string

Il nome dell'identità utente con cui viene eseguito il Task. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.