Job Schedule - List

Service:

Batch Service

API Version:

2023-11-01.18.0

Elenca tutte le pianificazioni dei processi nell'account specificato.

GET {batchUrl}/jobschedules?api-version=2023-11-01.18.0

With optional parameters:

GET {batchUrl}/jobschedules?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&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.
api-version	query	True	string	Versione dell'API client.
$expand	query		string	Clausola $expand OData.
$filter	query		string	Clausola $filter OData. Per altre informazioni sulla costruzione di questo filtro, vedere https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-schedules.
$select	query		string	Clausola $select OData.
maxresults	query		integer int32	Numero massimo di elementi da restituire nella risposta. È possibile restituire al massimo 1000 pianificazioni processi.
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.

Risposte

Nome	Tipo	Descrizione
200 OK	CloudJobScheduleListResult	Risposta contenente l'elenco delle pianificazioni dei processi. Headers client-request-id: string request-id: string ETag: string Last-Modified: 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

JobSchedule list

Sample Request

HTTP

GET account.region.batch.azure.com/jobschedules?api-version=2023-11-01.18.0

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "jobSchedule1",
      "url": "https://account.region.batch.azure.com/jobschedules/jobSchedule1",
      "eTag": "0x8D40FFD2E10996A",
      "lastModified": "2016-11-18T21:52:24.0064874Z",
      "creationTime": "2016-11-18T21:52:22.5431125Z",
      "state": "active",
      "stateTransitionTime": "2016-11-18T21:52:24.0064874Z",
      "previousState": "disabled",
      "previousStateTransitionTime": "2016-11-18T21:52:23.6471782Z",
      "jobSpecification": {
        "priority": 0,
        "maxParallelTasks": -1,
        "allowTaskPreemption": false,
        "usesTaskDependencies": false,
        "onAllTasksComplete": "noaction",
        "onTaskFailure": "noaction",
        "constraints": {
          "maxWallClockTime": "P10675199DT2H48M5.4775807S",
          "maxTaskRetryCount": 0
        },
        "poolInfo": {
          "poolId": "poolId"
        }
      },
      "executionInfo": {
        "recentJob": {
          "url": "https://account.region.batch.azure.com/jobs/jobSchedule1:job-1",
          "id": "jobSchedule1:job-1"
        }
      }
    },
    {
      "id": "jobSchedule2",
      "url": "https://account.region.batch.azure.com/jobschedules/jobSchedule2",
      "eTag": "0x8D40FFCFF760B51",
      "lastModified": "2016-11-18T21:51:05.8184017Z",
      "creationTime": "2016-11-18T21:51:05.8184017Z",
      "state": "active",
      "stateTransitionTime": "2016-11-18T21:51:05.8184017Z",
      "schedule": {
        "doNotRunUntil": "2020-01-01T12:30:00Z"
      },
      "jobSpecification": {
        "priority": 0,
        "maxParallelTasks": -1,
        "usesTaskDependencies": false,
        "onAllTasksComplete": "noaction",
        "onTaskFailure": "noaction",
        "constraints": {
          "maxWallClockTime": "P10675199DT2H48M5.4775807S",
          "maxTaskRetryCount": 0
        },
        "poolInfo": {
          "poolId": "testPool2"
        }
      },
      "executionInfo": {
        "nextRunTime": "2020-01-01T12:30:00Z"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
AccessScope	Risorse batch a cui il token concede l'accesso.
ApplicationPackageReference	Riferimento a un pacchetto da distribuire nei nodi di calcolo.
AuthenticationTokenSettings	Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch.
AutoPoolSpecification	Specifica le caratteristiche per un "pool automatico" temporaneo. Il servizio Batch creerà questo pool automatico quando viene inviato il processo.
AutoUserScope	Ambito dell'utente automatico
AutoUserSpecification	Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch.
AzureBlobFileSystemConfiguration	Informazioni usate per connettersi a un contenitore di archiviazione di Azure usando Blobfuse.
AzureFileShareConfiguration	Informazioni usate per connettersi a una condivisione file di Azure.
BatchError	Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail	Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch.
CachingType	Tipo di memorizzazione nella cache da abilitare per il disco.
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.
CIFSMountConfiguration	Informazioni utilizzate per connettersi a un file system CIFS.
CloudJobSchedule	Pianificazione processi che consente processi ricorrenti specificando quando eseguire processi e una specifica usata per creare ogni processo.
CloudJobScheduleListResult	Risultato dell'elenco delle pianificazioni dei processi in un account.
CloudServiceConfiguration	Configurazione per i nodi di calcolo in un pool basato sulla piattaforma Azure Servizi cloud.
ComputeNodeFillType	Modalità di distribuzione delle attività tra nodi di calcolo in un pool.
ComputeNodeIdentityReference	Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
ContainerConfiguration	Configurazione per i pool abilitati per i contenitori.
ContainerRegistry	Un registro contenitori privato.
ContainerType	Tecnologia contenitore da usare.
ContainerWorkingDirectory	Percorso della directory di lavoro dell'attività contenitore.
DataDisk	Impostazioni che verranno usate dai dischi dati associati ai nodi di calcolo nel pool. Quando si usano dischi dati allegati è necessario montare e formattare i dischi all'interno di una macchina virtuale per poterli usare.
DiffDiskPlacement	Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutti i nodi di calcolo (VM) nel pool.
DiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal nodo di calcolo (VM).
DiskEncryptionConfiguration	Configurazione della crittografia del disco applicata ai nodi di calcolo nel pool. La configurazione della crittografia del disco non è supportata nel pool Linux creato con l'immagine della raccolta di calcolo di Azure.
DiskEncryptionTarget	L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo.
DynamicVNetAssignmentScope	Ambito dell'assegnazione dinamica della rete virtuale.
ElevationLevel	Livello di elevazione dell'utente.
EnvironmentSetting	Variabile di ambiente da impostare in un processo attività.
ErrorMessage	Messaggio di errore ricevuto in una risposta di errore Azure Batch.
HttpHeader	Coppia nome-valore intestazione HTTP
ImageReference	Riferimento a un'immagine di Azure Macchine virtuali Marketplace o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti Azure Marketplace Immagine verificati da Azure Batch, vedere l'operazione 'Elenca immagini supportate'.
InboundEndpointProtocol	Protocollo dell'endpoint.
InboundNATPool	Pool NAT in ingresso che può essere usato per gestire porte specifiche nei nodi di calcolo in un pool di Batch esternamente.
IPAddressProvisioningType	Tipo di provisioning per indirizzi IP pubblici per il pool.
JobConstraints	Vincoli di esecuzione per un processo.
JobManagerTask	Specifica i dettagli di un'attività di Gestione processi.
JobNetworkConfiguration	Configurazione di rete per il processo.
JobPreparationTask	Attività di preparazione processo da eseguire prima di qualsiasi attività del processo in qualsiasi nodo di calcolo specificato.
JobReleaseTask	Attività di rilascio processo da eseguire al completamento del processo in qualsiasi nodo di calcolo in cui è stato eseguito il processo.
JobScheduleExecutionInformation	Contiene informazioni sui processi che sono stati e che verranno eseguiti in base a una pianificazione del processo.
JobScheduleState	Stato della pianificazione del processo.
JobScheduleStatistics	Statistiche sull'utilizzo delle risorse per una pianificazione del processo.
JobSpecification	Specifica i dettagli dei processi da creare in una pianificazione.
LinuxUserConfiguration	Proprietà usate per creare un account utente in un nodo di calcolo Linux.
LoginMode	Modalità di accesso per l'utente
ManagedDisk
MetadataItem	Coppia nome-valore associata a una risorsa del servizio Batch.
MountConfiguration	File system da montare in ogni nodo.
NetworkConfiguration	Configurazione di rete per un pool.
NetworkSecurityGroupRule	Regola del gruppo di sicurezza di rete da applicare a un endpoint in ingresso.
NetworkSecurityGroupRuleAccess	Azione che deve essere eseguita per un indirizzo IP, un intervallo di subnet o un tag specificati.
NFSMountConfiguration	Informazioni utilizzate per connettersi a un file system NFS.
NodeCommunicationMode	Determina il modo in cui un pool comunica con il servizio Batch.
NodePlacementConfiguration	Configurazione del posizionamento dei nodi per un pool.
NodePlacementPolicyType	Criteri di posizionamento per l'allocazione dei nodi nel pool.
OnAllTasksComplete	L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo sono nello stato completato.
OnTaskFailure	L'azione che il servizio Batch deve eseguire quando un'attività nel processo ha esito negativo.
OSDisk	Impostazioni per il disco del sistema operativo del nodo di calcolo (VM).
OutputFile	Specifica per il caricamento di file da un nodo di calcolo Azure Batch a un altro percorso dopo che il servizio Batch ha terminato l'esecuzione del processo attività.
OutputFileBlobContainerDestination	Specifica una destinazione di caricamento di file all'interno di un contenitore di archiviazione BLOB di Azure.
OutputFileDestination	Destinazione in cui deve essere caricato un file.
OutputFileUploadCondition	Le condizioni in cui deve essere caricato un file di output attività o un set di file.
OutputFileUploadOptions	Informazioni dettagliate su un'operazione di caricamento dei file di output, incluse le condizioni per eseguire il caricamento.
PoolEndpointConfiguration	Configurazione dell'endpoint per un pool.
PoolInformation	Specifica la modalità di assegnazione di un processo a un pool.
PoolLifetimeOption	Durata minima dei pool automatici creati e modalità di assegnazione di più processi in base a una pianificazione ai pool.
PoolSpecification	Specifica per la creazione di un nuovo pool.
PublicIPAddressConfiguration	Configurazione dell'indirizzo IP pubblico della configurazione di rete di un pool.
RecentJob	Informazioni sul processo più recente da eseguire in Pianificazione processi.
ResourceFile	Un singolo file o più file da scaricare in un nodo di calcolo.
Schedule	Pianificazione in base alla quale verranno creati processi. Tutte le ore sono fisse rispettivamente a UTC e non sono interessate dall'ora legale.
SecurityProfile	Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.
SecurityTypes	Specifica il tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings.
ServiceArtifactReference	Specifica l'ID riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'.
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.
StorageAccountType	Tipo di account di archiviazione da usare per la creazione di dischi dati o disco del sistema operativo.
TaskConstraints	Vincoli di esecuzione da applicare a un'attività.
TaskContainerSettings	Impostazioni del contenitore per un'attività.
TaskSchedulingPolicy	Specifica la modalità di distribuzione delle attività tra nodi di calcolo.
UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM, usate durante la creazione della macchina virtuale.
UserAccount	Proprietà usate per creare un utente usato per eseguire attività in un nodo di calcolo Azure Batch.
UserIdentity	Definizione dell'identità utente in cui viene eseguita l'attività.
VirtualMachineConfiguration	Configurazione per i nodi di calcolo in un pool basato sull'infrastruttura di Macchine virtuali di Azure.
VMExtension	Configurazione per le estensioni della macchina virtuale.
WindowsConfiguration	Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.
WindowsUserConfiguration	Proprietà usate per creare un account utente in un nodo di calcolo Windows.

AccessScope

Risorse batch a cui il token concede l'accesso.

Nome	Tipo	Descrizione
job	string	Concede l'accesso per eseguire tutte le operazioni sul processo contenente 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.

AuthenticationTokenSettings

Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch.

Nome	Tipo	Descrizione
access	AccessScope[]	Risorse batch a cui il token concede l'accesso. Il token di autenticazione concede l'accesso a un set limitato di operazioni del servizio Batch. Attualmente l'unico valore supportato per la proprietà di accesso è "job", che concede l'accesso a tutte le operazioni correlate al processo che contiene l'attività.

AutoPoolSpecification

Specifica le caratteristiche per un "pool automatico" temporaneo. Il servizio Batch creerà questo pool automatico quando viene inviato il processo.

Nome	Tipo	Descrizione
autoPoolIdPrefix	string	Prefisso da aggiungere all'identificatore univoco quando viene creato automaticamente un pool. Il servizio Batch assegna a ogni pool automatico un identificatore univoco durante la creazione. Per distinguere i pool creati per scopi diversi, è possibile specificare questo elemento per aggiungere un prefisso all'ID assegnato. Il prefisso può essere costituito da un massimo di 20 caratteri.
keepAlive	boolean	Indica se mantenere attivo un pool automatico dopo la scadenza della durata. Se false, il servizio Batch elimina il pool una volta scaduta la durata (come determinato dall'impostazione poolLifetimeOption); ovvero quando viene completata la pianificazione del processo o del processo. Se true, il servizio Batch non elimina automaticamente il pool. Spetta all'utente eliminare i pool automatici creati con questa opzione.
pool	PoolSpecification	Specifica pool per il pool automatico.
poolLifetimeOption	PoolLifetimeOption	Durata minima dei pool automatici creati e modalità di assegnazione di più processi in base a una pianificazione ai pool.

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.

AzureBlobFileSystemConfiguration

Informazioni usate per connettersi a un contenitore di archiviazione di Azure usando Blobfuse.

Nome	Tipo	Descrizione
accountKey	string	Chiave dell'account di archiviazione di Azure. Questa proprietà si escludono a vicenda sia con sasKey che con l'identità; deve essere specificato esattamente uno.
accountName	string	Nome dell'account di archiviazione di Azure.
blobfuseOptions	string	Opzioni della riga di comando aggiuntive da passare al comando mount. Queste sono le opzioni 'net use' nelle opzioni di Windows e 'mount' in Linux.
containerName	string	Nome del contenitore Archiviazione BLOB di Azure.
identityReference	ComputeNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere a containerName Questa proprietà si escludono a vicenda sia con accountKey che con sasKey; deve essere specificato esattamente uno.
relativeMountPath	string	Percorso relativo nel nodo di calcolo in cui verrà montato il file system Tutti i file system vengono montati in relazione alla directory dei montaggi batch, accessibili tramite la variabile di ambiente AZ_BATCH_NODE_MOUNTS_DIR.
sasKey	string	Token di firma di accesso condiviso di Archiviazione di Azure. Questa proprietà si escludono a vicenda sia con accountKey che con l'identità; deve essere specificato esattamente uno.

AzureFileShareConfiguration

Informazioni usate per connettersi a una condivisione file di Azure.

Nome	Tipo	Descrizione
accountKey	string	Chiave dell'account di Archiviazione di Azure.
accountName	string	Nome dell'account di archiviazione di Azure.
azureFileUrl	string	URL File di Azure. Si tratta del formato 'https://{account}.file.core.windows.net/'.
mountOptions	string	Opzioni della riga di comando aggiuntive da passare al comando mount. Queste sono le opzioni 'net use' nelle opzioni di Windows e 'mount' in Linux.
relativeMountPath	string	Percorso relativo nel nodo di calcolo in cui verrà montato il file system Tutti i file system vengono montati in relazione alla directory dei montaggi batch, accessibili tramite la variabile di ambiente AZ_BATCH_NODE_MOUNTS_DIR.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere usati 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 Azure Batch.

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

CachingType

Tipo di memorizzazione nella cache da abilitare per il disco.

Nome	Tipo	Descrizione
none	string	La modalità di memorizzazione nella cache per il disco non è abilitata.
readonly	string	La modalità di memorizzazione nella cache per il disco è di sola lettura.
readwrite	string	La modalità di memorizzazione nella cache per il disco è di lettura e scrittura.

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.

CIFSMountConfiguration

Informazioni utilizzate per connettersi a un file system CIFS.

Nome	Tipo	Descrizione
mountOptions	string	Opzioni della riga di comando aggiuntive da passare al comando mount. Queste sono le opzioni 'net use' nelle opzioni di Windows e 'mount' in Linux.
password	string	Password da usare per l'autenticazione nel file system CIFS.
relativeMountPath	string	Percorso relativo nel nodo di calcolo in cui verrà montato il file system Tutti i file system vengono montati in relazione alla directory dei montaggi batch, accessibili tramite la variabile di ambiente AZ_BATCH_NODE_MOUNTS_DIR.
source	string	URI del file system da montare.
username	string	Utente da usare per l'autenticazione nel file system CIFS.

CloudJobSchedule

Pianificazione processi che consente processi ricorrenti specificando quando eseguire processi e una specifica usata per creare ogni processo.

Nome	Tipo	Descrizione
creationTime	string	Ora di creazione della pianificazione del processo.
displayName	string	Nome visualizzato per la pianificazione.
eTag	string	ETag della pianificazione del processo. Si tratta di una stringa opaca. È possibile usarlo per rilevare se la pianificazione del processo è stata modificata tra le richieste. In particolare, è possibile passare L'ETag con una richiesta Di pianificazione del processo di aggiornamento per specificare che le modifiche devono essere effettive solo se nessuno altro ha modificato la pianificazione nel frattempo.
executionInfo	JobScheduleExecutionInformation	Informazioni sui processi che sono stati eseguiti e verranno eseguiti in questa pianificazione.
id	string	Stringa che identifica in modo univoco la pianificazione all'interno dell'account.
jobSpecification	JobSpecification	Dettagli dei processi da creare in questa pianificazione.
lastModified	string	Ora dell'ultima modifica della pianificazione del processo. Questa è l'ultima volta in cui i dati a livello di pianificazione, ad esempio la specifica del processo o le informazioni sulla ricorrenza, sono state modificate. Non influisce sui cambiamenti a livello di processo, ad esempio i nuovi processi creati o i processi che cambiano lo stato.
metadata	MetadataItem[]	Elenco di coppie nome-valore associate alla pianificazione come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
previousState	JobScheduleState	Stato precedente della pianificazione del processo. Questa proprietà non è presente se la pianificazione del processo è nello stato attivo iniziale.
previousStateTransitionTime	string	Ora in cui la pianificazione del processo ha immesso lo stato precedente. Questa proprietà non è presente se la pianificazione del processo è nello stato attivo iniziale.
schedule	Schedule	Pianificazione in base alla quale verranno creati processi. Tutte le ore sono fisse rispettivamente a UTC e non sono interessate dall'ora legale.
state	JobScheduleState	Stato corrente della pianificazione del processo.
stateTransitionTime	string	Ora in cui la pianificazione del processo ha immesso lo stato corrente.
stats	JobScheduleStatistics	Statistiche sull'utilizzo delle risorse di durata per la pianificazione del processo. Le statistiche potrebbero non essere immediatamente disponibili. Il servizio Batch esegue l'roll-up periodico delle statistiche. Il ritardo tipico è di circa 30 minuti.
url	string	URL della pianificazione del processo.

CloudJobScheduleListResult

Risultato dell'elenco delle pianificazioni dei processi in un account.

Nome	Tipo	Descrizione
odata.nextLink	string	URL per ottenere il set successivo di risultati.
value	CloudJobSchedule[]	Elenco di pianificazioni dei processi.

CloudServiceConfiguration

Configurazione per i nodi di calcolo in un pool basato sulla piattaforma Azure Servizi cloud.

Nome	Tipo	Descrizione
osFamily	string	Famiglia di sistemi operativi guest di Azure da installare nelle macchine virtuali nel pool. I valori possibili sono: 2 - Famiglia di sistemi operativi 2, equivalente a Windows Server 2008 R2 SP1. 3 - Famiglia del sistema operativo 3, equivalente a Windows Server 2012. 4 - Famiglia del sistema operativo 4, equivalente a Windows Server 2012 R2. 5 - Famiglia del sistema operativo 5, equivalente a Windows Server 2016. 6 - Famiglia di sistemi operativi 6, equivalente a Windows Server 2019. Per altre informazioni, vedere Versioni del sistema operativo guest di Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).
osVersion	string	Versione del sistema operativo guest di Azure da installare nelle macchine virtuali nel pool. Il valore predefinito è * che specifica la versione più recente del sistema operativo per la famiglia di sistemi operativi specificata.

ComputeNodeFillType

Modalità di distribuzione delle attività tra nodi di calcolo in un pool.

Nome	Tipo	Descrizione
pack	string	Il maggior numero possibile di attività (taskSlotsPerNode) deve essere assegnato a ogni nodo di calcolo nel pool prima che tutte le attività vengano assegnate al nodo di calcolo successivo nel pool.
spread	string	Le attività devono essere assegnate in modo uniforme in tutti i nodi di calcolo nel pool.

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.

ContainerConfiguration

Configurazione per i pool abilitati per i contenitori.

Nome	Tipo	Descrizione
containerImageNames	string[]	Raccolta di nomi di immagine del contenitore. Questo è il riferimento completo all'immagine, come verrebbe specificato in "docker pull". Un'immagine verrà generata dal registro Docker predefinito, a meno che l'immagine non sia completamente qualificata con un registro alternativo.
containerRegistries	ContainerRegistry[]	Registri privati aggiuntivi da cui è possibile eseguire il pull dei contenitori. Se è necessario scaricare immagini da un registro privato che richiede le credenziali, è necessario specificare le credenziali qui.
type	ContainerType	Tecnologia contenitore da usare.

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.

ContainerType

Tecnologia contenitore da usare.

Nome	Tipo	Descrizione
criCompatible	string	Per avviare i contenitori verrà usata una tecnologia basata su CRI.
dockerCompatible	string	Per avviare i contenitori verrà usata una tecnologia contenitore compatibile con Docker.

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.

DataDisk

Impostazioni che verranno usate dai dischi dati associati ai nodi di calcolo nel pool. Quando si usano dischi dati allegati è necessario montare e formattare i dischi all'interno di una macchina virtuale per poterli usare.

Nome	Tipo	Descrizione
caching	CachingType	Tipo di memorizzazione nella cache da abilitare per i dischi dati. Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	Dimensioni iniziali del disco in gigabyte.
lun	integer	Numero di unità logica. Il lun viene usato per identificare in modo univoco ogni disco dati. Se si collegano più dischi, ognuno deve avere un lun distinto. Il valore deve essere compreso tra 0 e 63 inclusi.
storageAccountType	StorageAccountType	Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs".

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutti i nodi di calcolo (VM) nel pool.

Nome	Tipo	Descrizione
CacheDisk	string	Il disco del sistema operativo temporaneo viene archiviato nella cache della macchina virtuale.

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal nodo di calcolo (VM).

Nome	Tipo	Descrizione
placement	DiffDiskPlacement	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 temporanee 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.

DiskEncryptionConfiguration

Configurazione della crittografia del disco applicata ai nodi di calcolo nel pool. La configurazione della crittografia del disco non è supportata nel pool Linux creato con l'immagine della raccolta di calcolo di Azure.

Nome	Tipo	Descrizione
targets	DiskEncryptionTarget[]	L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo. Se omesso, non verrà crittografato alcun disco nei nodi di calcolo del pool. Nel pool Linux è supportato solo "TemporaryDisk". nel pool di Windows è necessario specificare "OsDisk" e "TemporaryDisk".

DiskEncryptionTarget

L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo.

Nome	Tipo	Descrizione
osdisk	string	Il disco del sistema operativo nel nodo di calcolo è crittografato.
temporarydisk	string	Il disco temporaneo nel nodo di calcolo è crittografato. In Linux questa crittografia si applica ad altre partizioni (ad esempio quelle sui dischi dati montati) quando la crittografia viene eseguita in fase di avvio.

DynamicVNetAssignmentScope

Ambito dell'assegnazione dinamica della rete virtuale.

Nome	Tipo	Descrizione
job	string	L'assegnazione dinamica della rete virtuale viene eseguita per processo.
none	string	Non è abilitata alcuna assegnazione dinamica di rete virtuale.

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

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 del linguaggio del messaggio di errore
value	string	Testo del messaggio.

HttpHeader

Coppia nome-valore intestazione HTTP

Nome	Tipo	Descrizione
name	string	Nome senza distinzione tra maiuscole e minuscole dell'intestazione da usare durante il caricamento dei file di output
value	string	Valore dell'intestazione da usare durante il caricamento dei file di output

ImageReference

Riferimento a un'immagine di Azure Macchine virtuali Marketplace o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti Azure Marketplace Immagine verificati da Azure Batch, vedere l'operazione 'Elenca immagini supportate'.

Nome	Tipo	Descrizione
exactVersion	string	Versione specifica dell'immagine della piattaforma o dell'immagine del marketplace usata per creare il nodo. Questo campo di sola lettura è diverso da 'version' solo se il valore specificato per 'version' quando il pool è stato creato è 'latest'.
offer	string	Tipo di offerta dell'immagine di Azure Macchine virtuali Marketplace. Ad esempio, UbuntuServer o WindowsServer.
publisher	string	Autore dell'immagine di Azure Macchine virtuali Marketplace. Ad esempio, Canonical o MicrosoftWindowsServer.
sku	string	SKU dell'immagine di Azure Macchine virtuali Marketplace. Ad esempio, 18.04-LTS o 2019-Datacenter.
version	string	Versione dell'immagine di Azure Macchine virtuali Marketplace. È possibile specificare il valore 'latest' per selezionare la versione più recente di un'immagine. Se omesso, il valore predefinito è "latest".
virtualMachineImageId	string	Identificatore della risorsa ARM dell'immagine della raccolta di calcolo di Azure. I nodi di calcolo nel pool verranno creati usando questo ID immagine. Si tratta del formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} per l'impostazione predefinita alla versione dell'immagine più recente. Questa proprietà si escludono a vicenda con altre proprietà ImageReference. L'immagine della raccolta di calcolo di Azure deve avere repliche nella stessa area e deve trovarsi nella stessa sottoscrizione dell'account Azure Batch. Se la versione dell'immagine non è specificata nell'imageId, verrà usata la versione più recente. Per informazioni sulle impostazioni del firewall per l'agente del nodo di calcolo batch per comunicare con il servizio Batch, vedere https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Protocollo dell'endpoint.

Nome	Tipo	Descrizione
tcp	string	Usare TCP per l'endpoint.
udp	string	Usare UDP per l'endpoint.

InboundNATPool

Pool NAT in ingresso che può essere usato per gestire porte specifiche nei nodi di calcolo in un pool di Batch esternamente.

Nome	Tipo	Descrizione
backendPort	integer	Numero di porta nel nodo di calcolo. Deve essere univoco all'interno di un pool di Batch. I valori accettabili sono compresi tra 1 e 65535 ad eccezione di 22, 3389, 29876 e 29877, perché sono riservati. Se vengono forniti valori riservati, la richiesta ha esito negativo con codice di stato HTTP 400.
frontendPortRangeEnd	integer	Ultimo numero di porta nell'intervallo di porte esterne che verranno usate per fornire l'accesso in ingresso al back-endPort nei singoli nodi di calcolo. I valori accettabili sono compresi tra 1 e 65534, ad eccezione delle porte da 50000 a 55000 riservate dal servizio Batch. Tutti gli intervalli all'interno di un pool devono essere distinti e non possono sovrapporsi. Ogni intervallo deve contenere almeno 40 porte. Se vengono forniti valori riservati o sovrapposti, la richiesta ha esito negativo con codice di stato HTTP 400.
frontendPortRangeStart	integer	Primo numero di porta nell'intervallo di porte esterne che verranno usate per fornire l'accesso in ingresso al back-endPort in singoli nodi di calcolo. I valori accettabili sono compresi tra 1 e 65534 ad eccezione delle porte da 50000 a 55000 riservate. Tutti gli intervalli all'interno di un pool devono essere distinti e non possono sovrapporsi. Ogni intervallo deve contenere almeno 40 porte. Se vengono forniti valori riservati o sovrapposti, la richiesta ha esito negativo con codice di stato HTTP 400.
name	string	Nome dell'endpoint. Il nome deve essere univoco all'interno di un pool di Batch, può contenere lettere, numeri, caratteri di sottolineatura, punti e trattini. I nomi devono iniziare con una lettera o un numero, devono terminare con una lettera, un numero o un carattere di sottolineatura e non possono superare i 77 caratteri. Se vengono forniti valori non validi, la richiesta ha esito negativo e viene visualizzato il codice di stato HTTP 400.
networkSecurityGroupRules	NetworkSecurityGroupRule[]	Elenco delle regole del gruppo di sicurezza di rete che verranno applicate all'endpoint. Il numero massimo di regole che è possibile specificare in tutti gli endpoint in un pool di Batch è 25. Se non vengono specificate regole del gruppo di sicurezza di rete, verrà creata una regola predefinita per consentire l'accesso in ingresso al back-endPort specificato. Se il numero massimo di regole del gruppo di sicurezza di rete viene superato, la richiesta ha esito negativo con codice di stato HTTP 400.
protocol	InboundEndpointProtocol	Protocollo dell'endpoint.

IPAddressProvisioningType

Tipo di provisioning per indirizzi IP pubblici per il pool.

Nome	Tipo	Descrizione
batchmanaged	string	Un indirizzo IP pubblico verrà creato e gestito da Batch. Potrebbero essere presenti più indirizzi IP pubblici a seconda delle dimensioni del pool.
nopublicipaddresses	string	Non verrà creato alcun indirizzo IP pubblico.
usermanaged	string	Gli indirizzi IP pubblici vengono forniti dall'utente e verranno usati per effettuare il provisioning dei nodi di calcolo.

JobConstraints

Vincoli di esecuzione per un processo.

Nome	Tipo	Descrizione
maxTaskRetryCount	integer	Numero massimo di tentativi di ripetizione di ogni 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à ogni attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova un'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non ritenta attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta attività senza limiti. Il valore predefinito è 0, ovvero nessun tentativo.
maxWallClockTime	string	Tempo trascorso massimo di esecuzione del processo, misurato dal momento in cui viene creato il processo. Se il processo non viene completato entro il limite di tempo, il servizio Batch lo termina e tutte le attività ancora in esecuzione. In questo caso, il motivo della terminazione sarà MaxWallClockTimeExpiry. Se questa proprietà non viene specificata, non è previsto alcun limite di tempo per quanto tempo può essere eseguito il processo.

JobManagerTask

Specifica i dettagli di un'attività di Gestione processi.

Nome	Tipo	Descrizione
allowLowPriorityNode	boolean	Indica se l'attività di Gestione processi può essere eseguita in un nodo di calcolo con priorità spot/bassa. Il valore predefinito è true.
applicationPackageReferences	ApplicationPackageReference[]	Elenco di pacchetti dell'applicazione che il servizio Batch distribuirà nel nodo di calcolo prima di eseguire la riga di comando. I pacchetti dell'applicazione vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro Attività. Pertanto, se un pacchetto dell'applicazione a cui si fa riferimento è già presente nel nodo di calcolo ed è aggiornato, non viene scaricato nuovamente; viene usata la copia esistente nel nodo di calcolo. Se non è possibile installare un pacchetto dell'applicazione a cui si fa riferimento, ad esempio perché il pacchetto è stato eliminato o perché il download non è riuscito, l'attività ha esito negativo.
authenticationTokenSettings	AuthenticationTokenSettings	Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch. Se questa proprietà è impostata, il servizio Batch fornisce all'attività un token di autenticazione che può essere usato per autenticare le operazioni del servizio Batch senza richiedere una chiave di accesso account. Il token viene fornito tramite la variabile di ambiente AZ_BATCH_AUTHENTICATION_TOKEN. Le operazioni che l'attività può eseguire usando il token dipendono dalle impostazioni. Ad esempio, un'attività può richiedere autorizzazioni di processo per aggiungere altre attività al processo oppure controllare lo stato del processo o di altre attività nel processo.
commandLine	string	Riga di comando dell'attività Gestione processi. 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).
constraints	TaskConstraints	Vincoli che si applicano all'attività Gestione processi.
containerSettings	TaskContainerSettings	Impostazioni per il contenitore in cui viene eseguita l'attività Gestione processi. Se il pool che eseguirà questa attività ha impostato containerConfiguration, è necessario impostare anche questo valore. Se il pool che eseguirà questa attività non dispone di containerConfiguration impostato, non deve essere impostato. 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.
displayName	string	Nome visualizzato dell'attività di Gestione processi. Non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
environmentSettings	EnvironmentSetting[]	Elenco delle impostazioni delle variabili di ambiente per l'attività Gestione processi.
id	string	Stringa che identifica in modo univoco l'attività di Gestione processi all'interno del processo. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri.
killJobOnCompletion	boolean	Indica se il completamento dell'attività di Gestione processi indica il completamento dell'intero processo. Se true, al termine dell'attività di Gestione processi, il servizio Batch contrassegna il processo come completato. Se alcune attività sono ancora in esecuzione in questo momento (diverse dal rilascio del processo), tali attività vengono terminate. Se false, il completamento dell'attività Gestione processi non influisce sullo stato del processo. In questo caso, è necessario usare l'attributo onAllTasksComplete per terminare il processo oppure avere un client o un utente terminare il processo in modo esplicito. Un esempio è se Gestione processi crea un set di attività, ma non assume alcun ruolo aggiuntivo nell'esecuzione. Il valore predefinito è true. Se si usano gli attributi onAllTasksComplete e onTaskFailure per controllare la durata del processo e l'uso dell'attività di Gestione processi solo per creare le attività per il processo (non per monitorare lo stato di avanzamento), è importante impostare killJobOnCompletion su false.
outputFiles	OutputFile[]	Elenco di file che il servizio Batch caricherà dal nodo di calcolo dopo l'esecuzione della riga di comando. Per le attività a istanze multiple, i file verranno caricati solo dal nodo di calcolo in cui viene eseguita l'attività primaria.
requiredSlots	integer	Numero di slot di pianificazione necessari per l'esecuzione dell'attività. Il valore predefinito è 1. Un'attività può essere pianificata per l'esecuzione in un nodo di calcolo solo se il nodo dispone di slot di pianificazione gratuiti sufficienti. Per attività a istanze multiple, questa proprietà non è supportata e non deve essere specificata.
resourceFiles	ResourceFile[]	Elenco di file che il servizio Batch scaricherà 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à. 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.
runExclusive	boolean	Indica se l'attività Job Manager richiede l'uso esclusivo del nodo di calcolo in cui viene eseguito. Se true, nessun'altra attività verrà eseguita nello stesso nodo finché Gestione processi è in esecuzione. Se false, altre attività possono essere eseguite contemporaneamente con Gestione processi in un nodo di calcolo. L'attività di Gestione processi viene in genere conteggiato rispetto al limite di attività simultaneo del nodo di calcolo, pertanto ciò è rilevante solo se il nodo di calcolo consente più attività simultanee. Il valore predefinito è true.
userIdentity	UserIdentity	Identità utente in cui viene eseguita l'attività Gestione processi. Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

JobNetworkConfiguration

Configurazione di rete per il processo.

Nome	Tipo	Descrizione
subnetId	string	Identificatore della risorsa ARM della subnet di rete virtuale a cui verranno aggiunti i nodi di calcolo che eseguono attività dal processo per la durata dell'attività. Questa operazione funzionerà solo con un pool VirtualMachineConfiguration. La rete virtuale deve trovarsi nella stessa area e nella stessa sottoscrizione dell'account Azure Batch. La subnet specificata deve avere un numero sufficiente di indirizzi IP liberi per contenere il numero di nodi di calcolo che eseguiranno Attività dal processo. Può essere fino al numero di nodi di calcolo nel pool. L'entità servizio "MicrosoftAzureBatch" deve avere il ruolo "Collaboratore macchina virtuale classica" Role-Based Controllo di accesso (RBAC) per la rete virtuale specificata in modo che Azure Batch servizio possa pianificare attività nei nodi. È possibile verificarne la verifica controllando se la rete virtuale specificata dispone di gruppi di sicurezza di rete associati. Se la comunicazione con i nodi nella subnet specificata viene negata da un gruppo di sicurezza di rete, il servizio Batch imposterà lo stato dei nodi di calcolo su inutilizzabile. Si tratta del formato /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Se la rete virtuale specificata dispone di gruppi di sicurezza di rete associati, è necessario abilitare alcune porte di sistema riservate per la comunicazione in ingresso dal servizio Azure Batch. Per i pool creati con una configurazione di macchina virtuale, abilitare le porte 29876 e 29877, nonché la porta 22 per Linux e la porta 3389 per Windows. La porta 443 deve essere aperta anche per le connessioni in uscita per le comunicazioni con Archiviazione di Azure. Per altri dettagli, vedere: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

Attività di preparazione processo da eseguire prima di qualsiasi attività del processo in qualsiasi nodo di calcolo specificato.

Nome	Tipo	Descrizione
commandLine	string	Riga di comando dell'attività Preparazione processo. 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).
constraints	TaskConstraints	Vincoli che si applicano all'attività Preparazione processo.
containerSettings	TaskContainerSettings	Impostazioni per il contenitore in cui viene eseguita l'attività preparazione processo. 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 l'attività Preparazione processo.
id	string	Stringa che identifica in modo univoco l'attività preparazione processo all'interno del processo. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri. Se non si specifica questa proprietà, il servizio Batch assegna un valore predefinito "jobpreparation". Nessun'altra attività nel processo può avere lo stesso ID dell'attività di preparazione processo. Se si tenta di inviare un'attività con lo stesso ID, il servizio Batch rifiuta la richiesta con codice di errore TaskIdSameAsJobPreparationTask; se si chiama direttamente l'API REST, il codice di stato HTTP è 409 (Conflitto).
rerunOnNodeRebootAfterSuccess	boolean	Indica se il servizio Batch deve eseguire di nuovo l'attività preparazione processo dopo il riavvio di un nodo di calcolo. L'attività preparazione processo viene sempre eseguita di nuovo se viene ricreata l'immagine di un nodo di calcolo o se l'attività di preparazione processo non è stata completata, ad esempio perché il riavvio si è verificato durante l'esecuzione dell'attività. Pertanto, è consigliabile scrivere sempre un'attività di preparazione processo per essere idempotente e comportarsi correttamente se viene eseguita più volte. Il valore predefinito è true.
resourceFiles	ResourceFile[]	Elenco di file che il servizio Batch scaricherà 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à. 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.
userIdentity	UserIdentity	Identità utente in cui viene eseguita l'attività Preparazione processo. Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività nei nodi di calcolo Windows o un utente non amministrativo univoco per il pool nei nodi di calcolo Linux.
waitForSuccess	boolean	Indica se il servizio Batch deve attendere il completamento dell'attività di preparazione processo prima di pianificare qualsiasi altra attività del processo nel nodo di calcolo. Un'attività di preparazione processo è stata completata correttamente se viene chiusa con il codice di uscita 0. Se true e l'attività di preparazione del processo ha esito negativo in un nodo, il servizio Batch ritenta l'attività preparazione processi fino al numero massimo di tentativi,come specificato nell'elemento vincoli. Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch non pianifica attività del processo nel nodo. Il nodo rimane attivo e idoneo per l'esecuzione di attività di altri processi. Se false, il servizio Batch non attenderà il completamento dell'attività di preparazione del processo. In questo caso, altre attività del processo possono avviare l'esecuzione nel nodo di calcolo mentre l'attività preparazione processo è ancora in esecuzione; e anche se l'attività di preparazione del processo non riesce, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true.

JobReleaseTask

Attività di rilascio processo da eseguire al completamento del processo in qualsiasi nodo di calcolo in cui è stato eseguito il processo.

Nome	Tipo	Descrizione
commandLine	string	Riga di comando dell'attività Rilascio processo. 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 eseguita l'attività Rilascio processo. 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 l'attività Rilascio processo.
id	string	Stringa che identifica in modo univoco l'attività rilascio processo all'interno del processo. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri. Se non si specifica questa proprietà, il servizio Batch assegna un valore predefinito "jobrelease". Nessun'altra attività nel processo può avere lo stesso ID dell'attività Di rilascio processo. Se si tenta di inviare un'attività con lo stesso ID, il servizio Batch rifiuta la richiesta con codice di errore TaskIdSameAsJobReleaseTask; se si chiama direttamente l'API REST, il codice di stato HTTP è 409 (Conflitto).
maxWallClockTime	string	Tempo massimo trascorso per cui l'attività di rilascio del processo può essere eseguita in un determinato nodo di calcolo, misurata dal momento in cui viene avviata l'attività. Se l'attività non viene completata entro il limite di tempo, il servizio Batch lo termina. Il valore predefinito è 15 minuti. Non è possibile specificare un timeout più lungo di 15 minuti. In caso affermativo, il servizio Batch lo rifiuta con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
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à.
retentionTime	string	Tempo minimo per conservare la directory attività per l'attività Versione processo nel nodo di calcolo. Dopo questa volta, il servizio Batch può eliminare la directory attività e tutto il relativo contenuto. Il valore predefinito è 7 giorni, ad esempio la directory attività verrà mantenuta per 7 giorni a meno che il nodo di calcolo non venga rimosso o che il processo venga eliminato.
userIdentity	UserIdentity	Identità utente in cui viene eseguita l'attività Rilascio processi. Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

JobScheduleExecutionInformation

Contiene informazioni sui processi che sono stati e che verranno eseguiti in base a una pianificazione del processo.

Nome	Tipo	Descrizione
endTime	string	Ora in cui è terminata la pianificazione. Questa proprietà viene impostata solo se la pianificazione del processo è nello stato completato.
nextRunTime	string	Alla successiva creazione di un processo in base a questa pianificazione. Questa proprietà è significativa solo se la pianificazione è nello stato attivo quando si verifica l'ora. Ad esempio, se la pianificazione è disabilitata, non verrà creato alcun processo in nextRunTime, a meno che il processo non sia abilitato prima di allora.
recentJob	RecentJob	Informazioni sul processo più recente nella pianificazione processo. Questa proprietà è presente solo se almeno un processo è stato eseguito in base alla pianificazione.

JobScheduleState

Stato della pianificazione del processo.

Nome	Tipo	Descrizione
active	string	La pianificazione del processo è attiva e creerà processi in base alla pianificazione.
completed	string	La pianificazione del processo è stata terminata, raggiungendo la data di fine o terminando esplicitamente dall'utente.
deleting	string	L'utente ha richiesto l'eliminazione della pianificazione del processo, ma l'operazione di eliminazione è ancora in corso. L'utilità di pianificazione non avvierà nuovi processi per questa pianificazione del processo e eliminerà eventuali processi e attività esistenti nella pianificazione dei processi, incluso qualsiasi processo attivo. La pianificazione del processo verrà eliminata quando sono stati eliminati tutti i processi e le attività in Pianificazione processi.
disabled	string	L'utente ha disabilitato la pianificazione del processo. L'utilità di pianificazione non avvierà nuovi processi in questa pianificazione, ma qualsiasi processo attivo esistente continuerà a essere eseguito.
terminating	string	La pianificazione del processo non ha più lavoro da eseguire o è stata terminata in modo esplicito dall'utente, ma l'operazione di terminazione è ancora in corso. L'utilità di pianificazione non avvierà nuovi processi per questa pianificazione del processo, né sarà attivo alcun processo esistente.

JobScheduleStatistics

Statistiche sull'utilizzo delle risorse per una pianificazione del processo.

Nome	Tipo	Descrizione
kernelCPUTime	string	Tempo totale cpu in modalità kernel (sommato tra tutti i core e tutti i nodi di calcolo) utilizzato da tutte le attività in tutti i processi creati in base alla pianificazione.
lastUpdateTime	string	Ora dell'ultimo aggiornamento delle statistiche. Tutte le statistiche sono limitate all'intervallo tra startTime e lastUpdateTime.
numFailedTasks	integer	Numero totale di attività non riuscite durante l'intervallo di tempo specificato in Processi creati in base alla pianificazione. Un'attività ha esito negativo se esaurisce il numero massimo di tentativi senza restituire il codice di uscita 0.
numSucceededTasks	integer	Numero totale di attività completate durante l'intervallo di tempo specificato in Processi creati in base alla pianificazione. Un'attività viene completata correttamente se restituisce il codice di uscita 0.
numTaskRetries	integer	Numero totale di tentativi durante l'intervallo di tempo specificato in tutte le attività in tutti i processi creati nella pianificazione.
readIOGiB	number	I gibibyte totali letti dal disco da tutte le attività in tutti i processi creati in base alla pianificazione.
readIOps	integer	Numero totale di operazioni di lettura su disco eseguite da tutte le attività in tutti i processi creati in base alla pianificazione.
startTime	string	Ora di inizio dell'intervallo di tempo coperto dalle statistiche.
url	string	URL delle statistiche.
userCPUTime	string	Tempo cpu in modalità utente totale (sommato tra tutti i core e tutti i nodi di calcolo) utilizzato da tutte le attività in tutti i processi creati in base alla pianificazione.
waitTime	string	Tempo di attesa totale di tutte le attività in tutti i processi creati nella pianificazione. Il tempo di attesa per un'attività viene definito come tempo trascorso tra la creazione dell'attività e l'inizio dell'esecuzione dell'attività. Se l'attività viene ritentata a causa di errori, il tempo di attesa è il tempo per l'esecuzione più recente dell'attività. Questo valore viene segnalato solo nelle statistiche di durata dell'account; non è incluso nelle statistiche del processo.
wallClockTime	string	Tempo di clock totale di tutte le attività in tutti i processi creati in base alla pianificazione. Il tempo di clock del muro è il tempo trascorso dal momento in cui l'attività è stata avviata in esecuzione su un nodo di calcolo al termine (o all'ultima volta che le statistiche sono state aggiornate, se l'attività non è stata completata da allora). Se un'attività è stata ritentata, include l'ora dell'orologio del muro di tutti i tentativi di attività.
writeIOGiB	number	I gibibyte totali scritti su disco da tutte le attività in tutti i processi creati in base alla pianificazione.
writeIOps	integer	Numero totale di operazioni di scrittura su disco eseguite da tutte le attività in tutti i processi creati in base alla pianificazione.

JobSpecification

Specifica i dettagli dei processi da creare in una pianificazione.

Nome	Tipo	Valore predefinito	Descrizione
allowTaskPreemption	boolean		Se le attività in questo processo possono essere precedute da altri processi con priorità elevata Se il valore è impostato su True, altri processi con priorità elevata inviati al sistema avranno la precedenza e potranno ripetere le attività da questo processo. È possibile aggiornare l'autorizzazione di un processoTaskPreemption dopo aver creato l'API del processo di aggiornamento.
commonEnvironmentSettings	EnvironmentSetting[]		Elenco delle impostazioni comuni delle variabili di ambiente. Queste variabili di ambiente sono impostate per tutte le attività nei processi creati in questa pianificazione (inclusi Job Manager, Job Preparation e Job Release Tasks). Le singole attività possono eseguire l'override di un'impostazione di ambiente specificata qui specificando lo stesso nome di impostazione con un valore diverso.
constraints	JobConstraints		Vincoli di esecuzione per i processi creati in questa pianificazione.
displayName	string		Nome visualizzato per i processi creati in questa pianificazione. Il nome non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
jobManagerTask	JobManagerTask		Dettagli di un'attività di Gestione processi da avviare quando un processo viene avviato in base a questa pianificazione. Se il processo non specifica un'attività di Gestione processi, l'utente deve aggiungere in modo esplicito attività al processo usando l'API Attività. Se il processo specifica un'attività di Gestione processi, il servizio Batch crea l'attività di Gestione processi quando viene creato il processo e tenterà di pianificare l'attività di Gestione processi prima di pianificare altre attività nel processo.
jobPreparationTask	JobPreparationTask		Attività preparazione processo per i processi creati in questa pianificazione. Se un processo dispone di un'attività di preparazione processo, il servizio Batch eseguirà l'attività preparazione processo in un nodo prima di avviare qualsiasi attività del processo nel nodo di calcolo.
jobReleaseTask	JobReleaseTask		Attività rilascio processo per i processi creati in questa pianificazione. Lo scopo principale dell'attività rilascio processo è annullare le modifiche apportate ai nodi apportati dall'attività preparazione processo. Le attività di esempio includono l'eliminazione di file locali o l'arresto dei servizi avviati come parte della preparazione del processo. Non è possibile specificare un'attività di rilascio processo senza specificare anche un'attività di preparazione processo per il processo. Il servizio Batch esegue l'attività Rilascio processi nei nodi di calcolo che hanno eseguito l'attività preparazione processo.
maxParallelTasks	integer	-1	Numero massimo di attività che possono essere eseguite in parallelo per il processo. Il valore di maxParallelTasks deve essere -1 o maggiore di 0 se specificato. Se non specificato, il valore predefinito è -1, il che significa che non esiste alcun limite al numero di attività che possono essere eseguite contemporaneamente. È possibile aggiornare maxParallelTasks di un processo dopo aver creato l'API del processo di aggiornamento.
metadata	MetadataItem[]		Elenco di coppie nome-valore associate a ogni processo creato in questa pianificazione come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
networkConfiguration	JobNetworkConfiguration		Configurazione di rete per il processo.
onAllTasksComplete	OnAllTasksComplete		L'azione che il servizio Batch deve eseguire quando tutte le attività in un processo creato in questa pianificazione si trovano nello stato completato. Si noti che se un processo non contiene attività, tutte le attività vengono considerate complete. Questa opzione è quindi più comunemente usata con un'attività Job Manager; se si vuole usare la terminazione automatica dei processi senza Job Manager, è necessario impostare inizialmente suAllTasksComplete su noaction e aggiornare le proprietà del processo per impostare onAllTasksComplete per terminare il processo dopo aver completato l'aggiunta di Attività. Il valore predefinito è noaction.
onTaskFailure	OnTaskFailure		L'azione che il servizio Batch deve eseguire quando qualsiasi attività ha esito negativo in un processo creato in questa pianificazione. Un'attività viene considerata non riuscita se ha esito negativo se ha un erroreInfo. Un errorInfo viene impostato se l'attività viene completata con un codice di uscita diverso da zero dopo aver esaurito il conteggio dei tentativi oppure se si è verificato un errore durante l'avvio dell'attività, ad esempio a causa di un errore di download del file di risorse. Il valore predefinito è noaction.
poolInfo	PoolInformation		Pool in cui il servizio Batch esegue le attività dei processi creati in base a questa pianificazione.
priority	integer		Priorità dei processi creati in questa pianificazione. I valori della priorità possono essere compresi tra -1000 e 1000, dove -1000 è la priorità più bassa e 1000 la priorità più alta. Il valore predefinito è 0. Questa priorità viene usata come impostazione predefinita per tutti i processi nella pianificazione del processo. È possibile aggiornare la priorità di un processo dopo la creazione tramite l'API processo di aggiornamento.
usesTaskDependencies	boolean		Se le attività nel processo possono definire le dipendenze tra loro. Il valore predefinito è false.

LinuxUserConfiguration

Proprietà usate per creare un account utente in un nodo di calcolo Linux.

Nome	Tipo	Descrizione
gid	integer	ID gruppo per l'account utente. Le proprietà uid e gid devono essere specificate insieme o non affatto. Se non è specificato il sistema operativo sottostante, seleziona il gid.
sshPrivateKey	string	Chiave privata SSH per l'account utente. La chiave privata non deve essere protetta da password. La chiave privata viene usata per configurare automaticamente l'autenticazione basata su chiave asimmetrica per SSH tra nodi di calcolo in un pool Linux quando la proprietà enableInterNodeCommunication del pool è true (viene ignorata se enableInterNodeCommunication è false). A tale scopo, inserire la coppia di chiavi nella directory ssh dell'utente. Se non specificato, SSH senza password non è configurato tra nodi di calcolo (non viene eseguita alcuna modifica della directory SSH dell'utente).
uid	integer	ID utente dell'account utente. Le proprietà uid e gid devono essere specificate insieme o non affatto. Se non è specificato il sistema operativo sottostante, seleziona l'uid.

LoginMode

Modalità di accesso per l'utente

Nome	Tipo	Descrizione
batch	string	La LOGON32_LOGON_BATCH modalità di accesso Win32. La modalità di accesso batch è consigliata per processi paralleli a esecuzione prolungata.
interactive	string	La LOGON32_LOGON_INTERACTIVE modalità di accesso Win32. Controllo dell'account utente è abilitato nei pool VirtualMachineConfiguration di Windows. Se questa opzione viene usata con un'identità utente con privilegi elevati in un pool VirtualMachineConfiguration di Windows, la sessione utente non verrà elevata a meno che l'applicazione eseguita dalla riga di comando Task sia configurata per richiedere sempre privilegi amministrativi o per richiedere sempre il privilegio massimo.

ManagedDisk

Nome	Tipo	Descrizione
storageAccountType	StorageAccountType	Tipo di account di archiviazione per il disco gestito.

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.

MountConfiguration

File system da montare in ogni nodo.

Nome	Tipo	Descrizione
azureBlobFileSystemConfiguration	AzureBlobFileSystemConfiguration	Contenitore di Archiviazione di Azure da montare usando BLOB FUSE in ogni nodo. Questa proprietà si escludono a vicenda con tutte le altre proprietà.
azureFileShareConfiguration	AzureFileShareConfiguration	Condivisione file di Azure da montare in ogni nodo. Questa proprietà si escludono a vicenda con tutte le altre proprietà.
cifsMountConfiguration	CIFSMountConfiguration	File system CIFS/SMB da montare in ogni nodo. Questa proprietà si escludono a vicenda con tutte le altre proprietà.
nfsMountConfiguration	NFSMountConfiguration	File system NFS da montare in ogni nodo. Questa proprietà si escludono a vicenda con tutte le altre proprietà.

NetworkConfiguration

Configurazione di rete per un pool.

Nome	Tipo	Descrizione
dynamicVNetAssignmentScope	DynamicVNetAssignmentScope	Ambito dell'assegnazione dinamica della rete virtuale.
enableAcceleratedNetworking	boolean	Indica se questo pool deve abilitare la rete accelerata. La rete accelerata consente la virtualizzazione I/O radice singola (SR-IOV) a una macchina virtuale, che può portare a prestazioni di rete migliori. Per informazioni dettagliate, vedere: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration	PoolEndpointConfiguration	Configurazione per gli endpoint nei nodi di calcolo nel pool di Batch. La configurazione dell'endpoint del pool è supportata solo nei pool con la proprietà virtualMachineConfiguration.
publicIPAddressConfiguration	PublicIPAddressConfiguration	Configurazione di IPAddress pubblico per i nodi di calcolo nel pool di Batch. La proprietà di configurazione DELL'INDIRIZZO IP pubblico è supportata solo in Pool con la proprietà virtualMachineConfiguration.
subnetId	string	Identificatore della risorsa ARM della subnet di rete virtuale a cui verranno aggiunti i nodi di calcolo del pool. Si tratta del formato /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. La rete virtuale deve trovarsi nella stessa area e nella stessa sottoscrizione dell'account Azure Batch. La subnet specificata deve avere un numero sufficiente di indirizzi IP liberi per contenere il numero di nodi di calcolo nel pool. Se la subnet non dispone di indirizzi IP gratuiti sufficienti, il pool allocherà parzialmente i nodi e si verificherà un errore di ridimensionamento. L'entità servizio "MicrosoftAzureBatch" deve avere il ruolo "Collaboratore macchina virtuale classica" Role-Based Controllo di accesso (RBAC) per la rete virtuale specificata. La subnet specificata deve consentire la comunicazione dal servizio Azure Batch per poter pianificare attività nei nodi. È possibile verificarne la verifica controllando se la rete virtuale specificata dispone di gruppi di sicurezza di rete associati. Se la comunicazione con i nodi nella subnet specificata viene negata da un gruppo di sicurezza di rete, il servizio Batch imposterà lo stato dei nodi di calcolo su inutilizzabile. Per i pool creati con virtualMachineConfiguration sono supportate solo le reti virtuali ARM ('Microsoft.Network/virtualNetworks'), ma per i pool creati con cloudServiceConfiguration sono supportati sia ARM che reti virtuali classiche. Se la rete virtuale specificata ha gruppi di sicurezza di rete associati, è necessario abilitare alcune porte di sistema riservate per le comunicazioni in ingresso. Per i pool creati con una configurazione di macchina virtuale, abilitare le porte 29876 e 29877, nonché la porta 22 per Linux e la porta 3389 per Windows. Per i pool creati con una configurazione del servizio cloud, abilitare le porte 10100, 20100 e 30100. Abilitare anche le connessioni in uscita ad Archiviazione di Azure sulla porta 443. Per altri dettagli, vedere: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Regola del gruppo di sicurezza di rete da applicare a un endpoint in ingresso.

Nome	Tipo	Descrizione
access	NetworkSecurityGroupRuleAccess	Azione che deve essere eseguita per un indirizzo IP, un intervallo di subnet o un tag specificati.
priority	integer	Priorità per questa regola. Le priorità all'interno di un pool devono essere univoche e vengono valutate in ordine di priorità. Più è basso il numero, maggiore sarà la priorità. Ad esempio, le regole possono essere specificate con numeri di ordine di 150, 250 e 350. La regola con il numero di ordine di 150 ha la precedenza sulla regola con un ordine di 250. Le priorità consentite sono da 150 a 4096. Se vengono forniti valori riservati o duplicati, la richiesta ha esito negativo con codice di stato HTTP 400.
sourceAddressPrefix	string	Prefisso o tag dell'indirizzo di origine da trovare per la regola. I valori validi sono un singolo indirizzo IP (ad esempio 10.10.10.10.10), una subnet IP (ad esempio 192.168.1.0/24), un tag predefinito o * (per tutti gli indirizzi). Se vengono forniti altri valori, la richiesta ha esito negativo e viene visualizzato il codice di stato HTTP 400.
sourcePortRanges	string[]	Intervalli di porte di origine da trovare per la regola. I valori validi sono "" (per tutte le porte da 0 a 65535), una porta specifica (ad esempio 22) o un intervallo di porte (ad esempio 100-200). Le porte devono essere incluse nell'intervallo compreso tra 0 e 65535. Ogni voce di questa raccolta non deve sovrapporsi ad alcuna altra voce (un intervallo o una singola porta). Se vengono forniti altri valori, la richiesta ha esito negativo e viene visualizzato il codice di stato HTTP 400. Il valore predefinito è ''.

NetworkSecurityGroupRuleAccess

Azione che deve essere eseguita per un indirizzo IP, un intervallo di subnet o un tag specificati.

Nome	Tipo	Descrizione
allow	string	Consente l'accesso.
deny	string	Nega l'accesso.

NFSMountConfiguration

Informazioni utilizzate per connettersi a un file system NFS.

Nome	Tipo	Descrizione
mountOptions	string	Opzioni della riga di comando aggiuntive da passare al comando mount. Queste sono le opzioni 'net use' nelle opzioni di Windows e 'mount' in Linux.
relativeMountPath	string	Percorso relativo nel nodo di calcolo in cui verrà montato il file system Tutti i file system vengono montati in relazione alla directory dei montaggi batch, accessibili tramite la variabile di ambiente AZ_BATCH_NODE_MOUNTS_DIR.
source	string	URI del file system da montare.

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.

NodePlacementConfiguration

Configurazione del posizionamento dei nodi per un pool.

Nome	Tipo	Descrizione
policy	NodePlacementPolicyType	Tipo di criterio 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 a livello di area.

NodePlacementPolicyType

Criteri di posizionamento per l'allocazione dei nodi nel pool.

Nome	Tipo	Descrizione
regional	string	Tutti i nodi del pool verranno allocati nella stessa area.
zonal	string	I nodi nel pool verranno distribuiti tra diverse zone di disponibilità con il bilanciamento ottimale.

OnAllTasksComplete

L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo sono nello stato completato.

Nome	Tipo	Descrizione
noaction	string	Non eseguire alcuna operazione. Il processo rimane attivo a meno che non venga terminato o disabilitato da altri mezzi.
terminatejob	string	Terminare il processo. TerminateReason del processo è impostato su 'AllTasksComplete'.

OnTaskFailure

L'azione che il servizio Batch deve eseguire quando un'attività nel processo ha esito negativo.

Nome	Tipo	Descrizione
noaction	string	Non eseguire alcuna operazione. Il processo rimane attivo a meno che non venga terminato o disabilitato da altri mezzi.
performexitoptionsjobaction	string	Eseguire l'azione associata alla condizione di uscita dell'attività nell'insieme exitConditions dell'attività. È comunque possibile che non venga eseguita alcuna azione, se si tratta di ciò che specifica l'attività.

OSDisk

Impostazioni per il disco del sistema operativo del nodo di calcolo (VM).

Nome	Tipo	Descrizione
caching	CachingType	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None, ReadOnly, ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium. Il valore predefinito per la memorizzazione nella cache non è nessuno. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	Dimensioni iniziali del disco in GB durante la creazione di un nuovo disco del sistema operativo.
ephemeralOSDiskSettings	DiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal nodo di calcolo (VM).
managedDisk	ManagedDisk	Parametri del disco gestito.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

OutputFile

Specifica per il caricamento di file da un nodo di calcolo Azure Batch a un altro percorso dopo che il servizio Batch ha terminato l'esecuzione del processo attività.

Nome	Tipo	Descrizione
destination	OutputFileDestination	Destinazione dei file di output.
filePattern	string	Modello che indica quali file caricare. Sono supportati sia percorsi relativi che assoluti. I percorsi relativi sono relativi alla directory di lavoro attività. Sono supportati i caratteri jolly seguenti: * corrisponde a 0 o più caratteri (ad esempio pattern abc* corrisponderebbe a abc o abcdef), ** corrisponde a qualsiasi directory, ? corrisponde a qualsiasi carattere singolo, [abc] corrisponde a un carattere nelle parentesi quadre e [a-c] corrisponde a un carattere nell'intervallo. Le parentesi quadre possono includere una negazione per corrispondere a qualsiasi carattere non specificato (ad esempio [!abc] corrisponde a qualsiasi carattere ma a, b o c). Se un nome file inizia con "." viene ignorato per impostazione predefinita, ma può essere corrispondente specificandolo in modo esplicito (ad esempio .gif non corrisponderà a .a.gif, ma ..gif). Esempio semplice: **.txt corrisponde a qualsiasi file che non viene avviato in '.' e termina con .txt nella directory di lavoro attività o in qualsiasi sottodirectory. Se il nome del file contiene un carattere jolly, può essere eseguito l'escape usando parentesi quadre ( ad esempio abc[] corrisponderebbe a un file denominato abc. Si noti che sia \ che / vengono trattati come separatori di directory in Windows, ma solo / è in Linux. Le variabili di ambiente (%var% in Windows o $var in Linux) vengono espanse prima dell'applicazione del modello.
uploadOptions	OutputFileUploadOptions	Opzioni aggiuntive per l'operazione di caricamento, incluse le condizioni per eseguire il caricamento.

OutputFileBlobContainerDestination

Specifica una destinazione di caricamento di file all'interno di un contenitore di archiviazione BLOB di Azure.

Nome	Tipo	Descrizione
containerUrl	string	URL del contenitore all'interno di Archiviazione BLOB di Azure a cui caricare i file. Se non si usa un'identità gestita, l'URL deve includere una firma di accesso condiviso (SAS) concedendole le autorizzazioni di scrittura al contenitore.
identityReference	ComputeNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere Archiviazione BLOB di Azure specificato da containerUrl L'identità deve avere accesso in scrittura al contenitore Archiviazione BLOB di Azure
path	string	BLOB di destinazione o directory virtuale all'interno del contenitore di archiviazione di Azure. Se filePattern fa riferimento a un file specifico (ovvero non contiene caratteri jolly), il percorso è il nome del BLOB a cui caricare il file. Se filePattern contiene uno o più caratteri jolly (e quindi può corrispondere a più file), il percorso è il nome della directory virtuale BLOB (che viene preceduta da ogni nome BLOB) a cui caricare i file. Se omesso, i file vengono caricati nella radice del contenitore con un nome BLOB corrispondente al nome del file.
uploadHeaders	HttpHeader[]	Elenco delle coppie nome-valore per le intestazioni da usare nel caricamento di file di output Queste intestazioni verranno specificate durante il caricamento di file in Archiviazione di Azure. Documento ufficiale sulle intestazioni consentite durante il caricamento di BLOB: https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Destinazione in cui deve essere caricato un file.

Nome	Tipo	Descrizione
container	OutputFileBlobContainerDestination	Percorso nell'archivio BLOB di Azure in cui vengono caricati i file.

OutputFileUploadCondition

Le condizioni in cui deve essere caricato un file di output attività o un set di file.

Nome	Tipo	Descrizione
taskcompletion	string	Caricare i file dopo l'uscita dal processo attività, indipendentemente dal codice di uscita.
taskfailure	string	Caricare i file solo dopo l'uscita dal processo attività con un codice di uscita diverso da zero.
tasksuccess	string	Caricare i file solo dopo l'uscita dal processo attività con un codice di uscita pari a 0.

OutputFileUploadOptions

Informazioni dettagliate su un'operazione di caricamento dei file di output, incluse le condizioni per eseguire il caricamento.

Nome	Tipo	Descrizione
uploadCondition	OutputFileUploadCondition	Condizioni in cui deve essere caricato il file o il set di file di output dell'attività. Il valore predefinito è taskcompletion.

PoolEndpointConfiguration

Configurazione dell'endpoint per un pool.

Nome	Tipo	Descrizione
inboundNATPools	InboundNATPool[]	Elenco di pool NAT in ingresso che possono essere usati per gestire porte specifiche in un singolo nodo di calcolo esternamente. Il numero massimo di pool NAT in ingresso per pool batch è 5. Se il numero massimo di pool NAT in ingresso viene superato, la richiesta ha esito negativo con codice di stato HTTP 400. Non è possibile specificare se IPAddressProvisioningType è NoPublicIPAddresses.

PoolInformation

Specifica la modalità di assegnazione di un processo a un pool.

Nome	Tipo	Descrizione
autoPoolSpecification	AutoPoolSpecification	Caratteristiche per un 'pool automatico' temporaneo. Il servizio Batch creerà questo pool automatico al momento dell'invio del processo. Se la creazione automatica del pool ha esito negativo, il servizio Batch sposta il processo in uno stato completato e l'errore di creazione del pool viene impostato nella proprietà di errore di pianificazione del processo. Il servizio Batch gestisce la durata (sia la creazione che, a meno che keepAlive non sia specificata, eliminazione) del pool automatico. Tutte le azioni utente che influiscono sulla durata del pool automatico mentre il processo è attivo comporta un comportamento imprevisto. È necessario specificare l'ID pool o la specifica del pool automatico, ma non entrambi.
poolId	string	ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato. È necessario assicurarsi che il pool a cui fa riferimento questa proprietà esista. Se il pool non esiste al momento in cui il servizio Batch tenta di pianificare un processo, nessuna attività per il processo verrà eseguita fino a quando non si crea un pool con tale ID. Si noti che il servizio Batch non rifiuterà la richiesta di processo; non eseguirà semplicemente attività finché il pool non esiste. È necessario specificare l'ID pool o la specifica del pool automatico, ma non entrambi.

PoolLifetimeOption

Durata minima dei pool automatici creati e modalità di assegnazione di più processi in base a una pianificazione ai pool.

Nome	Tipo	Descrizione
job	string	Il pool esiste per la durata del processo a cui è dedicato. Il servizio Batch crea il pool quando crea il processo. Se l'opzione "processo" viene applicata a una pianificazione processo, il servizio Batch crea un nuovo pool automatico per ogni processo creato nella pianificazione.
jobschedule	string	Il pool esiste per la durata della pianificazione del processo. Il servizio Batch crea il pool quando crea il primo processo nella pianificazione. È possibile applicare questa opzione solo alle pianificazioni dei processi, non ai processi.

PoolSpecification

Specifica per la creazione di un nuovo pool.

Nome	Tipo	Descrizione
applicationLicenses	string[]	L'elenco delle licenze dell'applicazione che il servizio Batch renderà disponibile in ogni nodo di calcolo nel pool. L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza che non è supportata, la creazione del pool avrà esito negativo. Le licenze consentite disponibili nel pool sono 'maya', 'vray', '3dsmax', 'arnold'. Un addebito aggiuntivo si applica per ogni licenza dell'applicazione aggiunta al pool.
applicationPackageReferences	ApplicationPackageReference[]	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}). Le modifiche apportate ai riferimenti al pacchetto influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool finché non vengono riavviati o ricreati. Sono disponibili un massimo di 10 riferimenti al pacchetto in qualsiasi pool specificato.
autoScaleEvaluationInterval	string	Intervallo di tempo in base al quale regolare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica. Il valore predefinito è 15 minuti. Il valore minimo e massimo sono rispettivamente 5 minuti e 168 ore. Se si specifica un valore minore di 5 minuti o superiore a 168 ore, il servizio Batch rifiuta la richiesta con un errore di valore della proprietà non valido; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
autoScaleFormula	string	Formula per il numero desiderato di nodi di calcolo nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su false. È obbligatorio 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.
certificateReferences	CertificateReference[]	Elenco dei certificati da installare in ogni nodo di calcolo nel 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 query per questa posizione. 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 .
cloudServiceConfiguration	CloudServiceConfiguration	Configurazione del servizio cloud per il pool. Questa proprietà deve essere specificata se è necessario creare il pool con macchine virtuali PaaS di Azure. Questa proprietà e virtualMachineConfiguration si escludono a vicenda e una delle proprietà deve essere specificata. Se nessuno dei due viene specificato, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Questa proprietà non può essere specificata se l'account Batch è stato creato con la relativa proprietà poolAllocationMode impostata su 'UserSubscription'.
displayName	string	Nome visualizzato del pool. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
enableAutoScale	boolean	Indica se le dimensioni del pool devono essere regolate automaticamente nel tempo. Se false, è necessario specificare almeno uno di targetDedicatedNodes e targetLowPriorityNodes. Se true, l'elemento autoScaleFormula è obbligatorio. Il pool viene ridimensionato automaticamente in base alla formula. Il valore predefinito è false.
enableInterNodeCommunication	boolean	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.
metadata	MetadataItem[]	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.
mountConfiguration	MountConfiguration[]	Elenco di file system da montare su ogni nodo nel pool. Supporta File di Azure, NFS, CIFS/SMB e BLOBfuse.
networkConfiguration	NetworkConfiguration	Configurazione di rete per il pool. Configurazione di rete per un pool.
resizeTimeout	string	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 rifiuta la richiesta con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
resourceTags	object	Tag specificati dall'utente associati al pool. Tag definiti dall'utente da associare al pool di Azure Batch. Se specificato, questi tag vengono propagati alle risorse di Azure di backup associate al pool. Questa proprietà può essere specificata solo quando l'account Batch è stato creato con la proprietà poolAllocationMode impostata su 'UserSubscription'.
startTask	StartTask	Attività da eseguire in ogni nodo di calcolo durante il join del pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando viene riavviato il nodo di calcolo. Batch ritenta attività quando viene attivata un'operazione di ripristino in un nodo. Alcuni esempi di operazioni di ripristino includono (ma non sono limitati a) quando un nodo non integro viene riavviato o un nodo di calcolo scomparso a causa di un errore host. I tentativi dovuti alle operazioni di ripristino sono indipendenti da e non vengono conteggiati rispetto al maxTaskRetryCount. Anche se maxTaskRetryCount è 0, potrebbe verificarsi un tentativo interno a causa di un'operazione di ripristino. A causa di questo, tutte le attività devono essere idempotenti. Ciò significa che le attività devono tollerare l'interruzione e il riavvio senza causare alcun danneggiamento o dati duplicati. La procedura consigliata per le attività a esecuzione prolungata consiste nell'usare una forma di checkpoint. In alcuni casi, startTask può essere eseguito nuovamente anche se il nodo di calcolo non è stato riavviato. È consigliabile prestare particolare attenzione per evitare StartTasks che creano processi di interruzione o installano/avviano i servizi dalla directory di lavoro StartTask, in quanto questo impedisce a Batch di essere in grado di eseguire nuovamente StartTask.
targetDedicatedNodes	integer	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.
targetLowPriorityNodes	integer	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.
targetNodeCommunicationMode	NodeCommunicationMode	Modalità di comunicazione del nodo desiderata per il pool. Se omesso, il valore predefinito è Default.
taskSchedulingPolicy	TaskSchedulingPolicy	Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è distribuito.
taskSlotsPerNode	integer	Numero di slot di attività che è possibile usare 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 della vmSize del pool o 256.
userAccounts	UserAccount[]	Elenco degli account utente da creare in ogni nodo di calcolo nel pool.
virtualMachineConfiguration	VirtualMachineConfiguration	Configurazione della macchina virtuale per il pool. Questa proprietà deve essere specificata se il pool deve essere creato con macchine virtuali IaaS di Azure. Questa proprietà e cloudServiceConfiguration si escludono a vicenda e una delle proprietà deve essere specificata. Se nessuno dei due viene specificato, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
vmSize	string	Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni. Per informazioni sulle dimensioni disponibili delle macchine virtuali nei pool, vedere Scegliere le dimensioni di una macchina virtuale per i nodi di calcolo in un pool di Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

PublicIPAddressConfiguration

Configurazione dell'indirizzo IP pubblico della configurazione di rete di un pool.

Nome	Tipo	Descrizione
ipAddressIds	string[]	Elenco di indirizzi IP pubblici che verranno usati dal servizio Batch durante il provisioning dei nodi di calcolo. Il numero di indirizzi IP specificati qui limita le dimensioni massime del pool: 100 nodi dedicati o 100 nodi spot/con priorità bassa possono essere allocati per ogni indirizzo IP pubblico. Ad esempio, un pool che richiede 250 macchine virtuali dedicate richiederebbe almeno 3 indirizzi IP pubblici specificati. Ogni elemento di questa raccolta è nel formato : /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.
provision	IPAddressProvisioningType	Tipo di provisioning per indirizzi IP pubblici per il pool. Il valore predefinito è BatchManaged.

RecentJob

Informazioni sul processo più recente da eseguire in Pianificazione processi.

Nome	Tipo	Descrizione
id	string	ID del processo.
url	string	URL del processo.

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 sono reciprocamente esclusive e una di esse deve essere specificata.
blobPrefix	string	Prefisso BLOB da usare quando si scaricano 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 viene usato autoStorageContainerName o storageContainerUrl. Questo prefisso può essere un nome file parziale o una sottodirectory. Se non viene specificato un prefisso, tutti i file nel contenitore verranno scaricati.
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 di Windows. Se questa proprietà non è specificata per un nodo di calcolo Linux, viene applicato un valore predefinito 0770 al file.
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, il 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, 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 usando '.'.
httpUrl	string	URL del file da scaricare. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl sono reciprocamente esclusive 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 (SAS) concedendole le autorizzazioni di lettura nel BLOB, usare un'identità gestita con autorizzazioni 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 Archiviazione BLOB di Azure specificato da storageContainerUrl o httpUrl Riferimento a un'identità assegnata dall'utente associata al pool 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 sono reciprocamente esclusive e una di esse deve essere specificata. Questo URL deve essere leggibile e elencabile dai nodi di calcolo. Esistono tre modi per ottenere un URL di questo tipo per un contenitore nell'archiviazione di Azure: includere una firma di accesso condiviso (SAS) concedendole autorizzazioni di lettura e elenco nel contenitore, usare un'identità gestita con autorizzazioni di lettura e elenco o impostare l'ACL per il contenitore per consentire l'accesso pubblico.

Schedule

Pianificazione in base alla quale verranno creati processi. Tutte le ore sono fisse rispettivamente a UTC e non sono interessate dall'ora legale.

Nome	Tipo	Descrizione
doNotRunAfter	string	Ora dopo la quale non verrà creato alcun processo in questa pianificazione del processo. La pianificazione verrà spostata sullo stato completato non appena questa scadenza è passata e non esiste alcun processo attivo in questa pianificazione del processo. Se non si specifica un'ora doNotRunAfter e si sta creando una pianificazione del processo ricorrente, la pianificazione dei processi rimarrà attiva fino a quando non verrà terminata in modo esplicito.
doNotRunUntil	string	La prima volta in cui è possibile creare un processo in questa pianificazione del processo. Se non si specifica un'ora doNotRunUntil, la pianificazione diventa pronta per creare immediatamente processi.
recurrenceInterval	string	Intervallo di tempo tra l'ora di inizio di due processi successivi in Pianificazione processi. Una pianificazione del processo può avere al massimo un processo attivo in qualsiasi momento. Poiché una pianificazione del processo può avere al massimo un processo attivo in qualsiasi momento, se è ora di creare un nuovo processo in una pianificazione processo, ma il processo precedente è ancora in esecuzione, il servizio Batch non creerà il nuovo processo fino al termine del processo precedente. Se il processo precedente non viene completato entro il periodo startWindow della nuova ricorrenzaInterval, non verrà pianificato alcun nuovo processo per tale intervallo. Per i processi ricorrenti, è consigliabile specificare normalmente un jobManagerTask nel processoSpecification. Se non si usa jobManagerTask, è necessario un processo esterno per monitorare quando vengono creati processi, aggiungere attività ai processi e terminare i processi pronti per la ricorrenza successiva. Il valore predefinito è che la pianificazione non viene eseguita nuovamente: un processo viene creato, all'interno dell'avvioWindow dopo l'ora doNotRunUntil e la pianificazione viene completata non appena termina il processo. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
startWindow	string	Intervallo di tempo, a partire dal momento in cui la pianificazione indica che deve essere creato un processo, all'interno del quale deve essere creato un processo. Se un processo non viene creato all'interno dell'intervallo startWindow, la "opportunità" viene persa; nessun processo verrà creato fino alla successiva ricorrenza della pianificazione. Se la pianificazione è ricorrente e startWindow è più lungo dell'intervallo di ricorrenza, questo equivale a un inizio infinitoWindow, perché il processo "dovuto" in una ricorrenzaInterval non viene portato avanti nell'intervallo di ricorrenza successivo. Il valore predefinito è infinite. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

SecurityProfile

Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
encryptionAtHost	boolean	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.
securityType	SecurityTypes	Specifica il tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings.
uefiSettings	UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM, usate durante la creazione della macchina virtuale. Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM, usate durante la creazione della macchina virtuale.

SecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings.

Nome	Tipo	Descrizione
trustedLaunch	string	L'avvio attendibile protegge da tecniche di attacco avanzate e persistenti.

ServiceArtifactReference

Specifica l'ID riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'.

Nome	Tipo	Descrizione
id	string	ID riferimento dell'artefatto del servizio di ServiceArtifactReference ID riferimento dell'artefatto del servizio sotto forma di /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

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.

StorageAccountType

Tipo di account di archiviazione da usare per la creazione di dischi dati o disco del sistema operativo.

Nome	Tipo	Descrizione
premium_lrs	string	Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale Premium.
standard_lrs	string	Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale standard.
standardssd_lrs	string	Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale ssd standard.

TaskConstraints

Vincoli di esecuzione da applicare a un'attività.

Nome	Tipo	Descrizione
maxTaskRetryCount	integer	Numero massimo di tentativi di ripetizione dell'attività. Il servizio Batch esegue il tentativo di un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla in modo specifico il numero di tentativi per il file eseguibile dell'attività a causa di un codice di uscita diverso da zero. 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 riprova l'attività dopo il primo tentativo. Se il numero massimo di tentativi è -1, il servizio Batch esegue il tentativo dell'attività senza limiti, ma non è consigliabile per un'attività di avvio o per qualsiasi attività. Il valore predefinito è 0, ovvero nessun tentativo.
maxWallClockTime	string	Tempo massimo trascorso che l'attività può essere eseguita, misurata dal momento in cui viene avviata l'attività. Se l'attività non viene completata entro il limite di tempo, il servizio Batch lo termina. Se non viene specificato, non è previsto alcun limite di tempo per quanto tempo l'attività può essere eseguita.
retentionTime	string	Tempo minimo per conservare la directory attività nel nodo di calcolo in cui è stata eseguita, dal momento in cui viene completata l'esecuzione. Dopo questa volta, il servizio Batch può eliminare la directory attività e tutto il relativo contenuto. Il valore predefinito è 7 giorni, ad esempio la directory attività verrà mantenuta per 7 giorni a meno che il nodo di calcolo non venga rimosso o che il processo venga eliminato.

TaskContainerSettings

Impostazioni del contenitore per un'attività.

Nome	Tipo	Descrizione
containerRunOptions	string	Opzioni aggiuntive per il comando di creazione 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 si specifica per "docker pull". Se non viene fornito alcun tag come parte del nome immagine, il tag ":latest" viene usato come impostazione predefinita.
registry	ContainerRegistry	Registro privato contenente l'immagine del contenitore. Questa impostazione può essere omessa se è già stata fornita alla creazione del pool.
workingDirectory	ContainerWorkingDirectory	Percorso della directory di lavoro attività contenitore. Il valore predefinito è 'taskWorkingDirectory'.

TaskSchedulingPolicy

Specifica la modalità di distribuzione delle attività tra nodi di calcolo.

Nome	Tipo	Descrizione
nodeFillType	ComputeNodeFillType	Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è distribuito.

UefiSettings

Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM, usate durante la creazione della macchina virtuale.

Nome	Tipo	Descrizione
secureBootEnabled	boolean	Specifica se l'avvio protetto deve essere abilitato nella macchina virtuale.
vTpmEnabled	boolean	Specifica se vTPM deve essere abilitato nella macchina virtuale.

UserAccount

Proprietà usate per creare un utente usato per eseguire attività in un nodo di calcolo Azure Batch.

Nome	Tipo	Descrizione
elevationLevel	ElevationLevel	Livello di elevazione dell'account utente. Il valore predefinito è nonAdmin.
linuxUserConfiguration	LinuxUserConfiguration	Configurazione utente specifica di Linux per l'account utente. Questa proprietà viene ignorata se specificata in un pool di Windows. Se non specificato, l'utente viene creato con le opzioni predefinite.
name	string	Nome dell'account utente. I nomi possono contenere qualsiasi carattere Unicode fino a una lunghezza massima di 20.
password	string	Password per l'account utente.
windowsUserConfiguration	WindowsUserConfiguration	Configurazione utente specifica di Windows per l'account utente. Questa proprietà può essere specificata solo se l'utente si trova in un pool di Windows. Se non specificato e in un pool di Windows, l'utente viene creato con le opzioni predefinite.

UserIdentity

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

Nome	Tipo	Descrizione
autoUser	AutoUserSpecification	Utente automatico in cui viene eseguita l'attività. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificare 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 specificare uno ma non entrambi.

VirtualMachineConfiguration

Configurazione per i nodi di calcolo in un pool basato sull'infrastruttura di Macchine virtuali di Azure.

Nome	Tipo	Descrizione
containerConfiguration	ContainerConfiguration	Configurazione del contenitore per il pool. Se specificato, la configurazione viene eseguita in ogni nodo di calcolo nel pool per consentire l'esecuzione delle attività nei contenitori. Tutte le attività regolari e le attività di Gestione processi eseguite in questo pool devono specificare la proprietà containerSettings e tutte le altre attività possono specificarlo.
dataDisks	DataDisk[]	Configurazione per i dischi dati collegati ai nodi di calcolo nel pool. Questa proprietà deve essere specificata se i nodi di calcolo nel pool devono avere dischi dati vuoti collegati. Non è possibile aggiornare questa operazione. Ogni nodo di calcolo ottiene il proprio disco (il disco non è una condivisione file). I dischi esistenti non possono essere collegati, ogni disco collegato è vuoto. Quando il nodo di calcolo viene rimosso dal pool, il disco e tutti i dati associati vengono eliminati. Il disco non è formattato dopo essere collegato, deve essere formattato prima dell'uso. Per altre informazioni, vedere https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux e https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.
diskEncryptionConfiguration	DiskEncryptionConfiguration	Configurazione della crittografia del disco per il pool. Se specificato, la crittografia viene eseguita in ogni nodo del pool durante il provisioning dei nodi.
extensions	VMExtension[]	Estensione macchina virtuale per il pool. Se specificato, le estensioni indicate in questa configurazione verranno installate in ogni nodo.
imageReference	ImageReference	Riferimento all'immagine di Azure Macchine virtuali Marketplace o all'immagine di macchina virtuale personalizzata da usare.
licenseType	string	Tipo di licenza locale da usare durante la distribuzione del sistema operativo. Questo vale solo per le immagini che contengono il sistema operativo Windows e devono essere usate solo quando si contengono licenze locali valide per i nodi di calcolo che verranno distribuiti. Se omesso, non viene applicato alcun sconto sulle licenze locali. I valori possibili sono: Windows_Server: la licenza locale è per Windows Server. Windows_Client: la licenza locale è per il client Windows.
nodeAgentSKUId	string	SKU dell'agente del nodo di calcolo Batch da eseguire per il provisioning nei nodi di calcolo nel pool. L'agente 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 diverse implementazioni dell'agente nodo di calcolo, note come SKU, per sistemi operativi diversi. È necessario specificare uno SKU dell'agente del nodo di calcolo che corrisponde al riferimento all'immagine selezionata. Per ottenere l'elenco degli SKU dell'agente del nodo di calcolo supportati insieme all'elenco dei riferimenti di immagine verificati, vedere l'operazione "Sku dell'agente del nodo di calcolo supportati dall'elenco".
nodePlacementConfiguration	NodePlacementConfiguration	Configurazione del posizionamento dei nodi per il pool. Questa configurazione specifica regole sulla modalità di allocazione fisica dei nodi nel pool.
osDisk	OSDisk	Impostazioni per il disco del sistema operativo della macchina virtuale.
securityProfile	SecurityProfile	Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali. Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.
serviceArtifactReference	ServiceArtifactReference	Specifica l'ID riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'. ID riferimento dell'artefatto del servizio sotto forma di /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}
windowsConfiguration	WindowsConfiguration	Impostazioni del sistema operativo Windows nella macchina virtuale. Questa proprietà non deve essere specificata se la proprietà imageReference specifica un'immagine del sistema operativo Linux.

VMExtension

Configurazione per le estensioni della macchina virtuale.

Nome	Tipo	Descrizione
autoUpgradeMinorVersion	boolean	Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie, a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.
enableAutomaticUpgrade	boolean	Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.
name	string	Nome dell'estensione macchina virtuale.
protectedSettings	object	L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.
provisionAfterExtensions	string[]	Raccolta di nomi di estensione. Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione.
publisher	string	Nome del server di pubblicazione del gestore dell'estensione.
settings	object	Impostazioni pubbliche in formato JSON per l'estensione.
type	string	Il tipo di estensione.
typeHandlerVersion	string	Versione del gestore di script.

WindowsConfiguration

Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.

Nome	Tipo	Descrizione
enableAutomaticUpdates	boolean	Indica se gli aggiornamenti automatici sono abilitati nella macchina virtuale. Se omesso, il valore predefinito è true.

WindowsUserConfiguration

Proprietà usate per creare un account utente in un nodo di calcolo Windows.

Nome	Tipo	Descrizione
loginMode	LoginMode	Modalità di accesso per l'utente Il valore predefinito per i pool VirtualMachineConfiguration è "batch" e per i pool di CloudServiceConfiguration è "interattivo".