Job Schedule - List

Elenca tutte le pianificazioni dei processi nell'account specificato.

GET {batchUrl}/jobschedules?api-version=2022-01-01.15.0
GET {batchUrl}/jobschedules?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2022-01-01.15.0

Parametri dell'URI

Name In Required Type Description
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 OData $expand.

$filter
query
  • string

Clausola OData $filter. 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 di $select OData.

maxresults
query
  • integer
int32

Numero massimo di elementi da restituire nella risposta. È possibile restituire un massimo di 1000 Pianificazioni processi.

timeout
query
  • integer
int32

Tempo massimo per cui il server può trascorrere l'elaborazione della richiesta, in secondi. Il valore predefinito è 30 secondi.

Intestazione della richiesta

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

Name Required Type Description
client-request-id
  • string
uuid

Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id
  • boolean

Indica se il server deve restituire l'ID richiesta client nella risposta.

ocp-date
  • string
date-time-rfc1123

Ora di emissione della richiesta. Le librerie client in genere impostano l'ora dell'orologio del sistema corrente; impostarla in modo esplicito se si chiama direttamente l'API REST.

Risposte

Name Type Description
200 OK

Risposta contenente l'elenco di Pianificazioni processi.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

Errore dal servizio Batch.

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation Rappresentare l'account utente

Authorization

Type: apiKey
In: header

Esempio

JobSchedule list

Sample Request

GET account.region.batch.azure.com/jobschedules?api-version=2022-01-01.15.0


Sample Response

{
  "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

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

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 verrà usato 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 il disco temporaneo Impostazioni 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 Raccolta immagini condivise Image.

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 Raccolta immagini condivise. 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 Job Manager.

JobNetworkConfiguration

Configurazione di rete per il processo.

JobPreparationTask

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

JobReleaseTask

Attività versione 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 verranno eseguiti in 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 un pianificare.

LinuxUserConfiguration

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

LoginMode

Modalità di accesso per l'utente

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.

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 si trovano nello stato completato.

OnTaskFailure

L'azione che il servizio Batch deve eseguire quando qualsiasi 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 un pianificare 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

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

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.

TaskConstraints

Vincoli di esecuzione da applicare a un'attività.

TaskContainerSettings

Impostazioni del contenitore per un'attività.

TaskSchedulingPolicy

Specifica il modo in cui le attività devono essere distribuite tra nodi di calcolo.

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

Windows impostazioni del sistema operativo da applicare alla macchina virtuale.

WindowsUserConfiguration

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

ApplicationPackageReference

Riferimento a un pacchetto da distribuire nei nodi di calcolo.

Name Type Description
applicationId
  • string

ID dell'applicazione da distribuire.

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.

Name Type Description
access
  • string[]

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.

Name Type Description
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

Specifica pool per il pool automatico.

poolLifetimeOption

Durata minima dei pool automatici creati e modalità di assegnazione di più processi in un pianificare ai pool.

AutoUserScope

Ambito dell'utente automatico

Name Type Description
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.

Name Type Description
elevationLevel

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

scope

Ambito dell'utente automatico
Il valore predefinito è pool. Se il pool è in esecuzione Windows deve essere specificato un 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 Archiviazione di Azure usando BLOBfuse.

Name Type Description
accountKey
  • string

Chiave dell'account Archiviazione di Azure.
Questa proprietà si escludono a vicenda sia con sasKey che con identità; deve essere specificato esattamente uno.

accountName
  • string

Nome account Archiviazione di Azure.

blobfuseOptions
  • string

Opzioni aggiuntive della riga di comando da passare al comando di montaggio.
Queste sono le opzioni 'net use' nelle opzioni di Windows e 'mount' in Linux.

containerName
  • string

Nome del contenitore Archiviazione BLOB di Azure.

identityReference

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 Archiviazione di Azure.
Questa proprietà si escludono a vicenda sia con accountKey che con identità; deve essere specificato esattamente uno.

AzureFileShareConfiguration

Informazioni usate per connettersi a una condivisione file di Azure.

Name Type Description
accountKey
  • string

Chiave dell'account di Archiviazione di Azure.

accountName
  • string

Nome dell'account 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.

Name Type Description
code
  • string

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

message

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

values

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

BatchErrorDetail

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

Name Type Description
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.

Name Type Description
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.

Name Type Description
storeLocation

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 Windows nodi di calcolo, ovvero creati con cloudServiceConfiguration o con virtualMachineConfiguration usando un riferimento Windows Image. 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 Windows nodi di calcolo, ovvero creati con cloudServiceConfiguration o con virtualMachineConfiguration usando un riferimento Windows Image. 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
  • string[]

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.

Name Type Description
currentuser
  • string

I certificati devono essere installati nell'archivio certificati CurrentUser.

localmachine
  • string

I certificati devono essere installati nell'archivio certificati LocalMachine.

CIFSMountConfiguration

Informazioni utilizzate per connettersi a un file system CIFS.

Name Type Description
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.

Name Type Description
creationTime
  • string

Ora di creazione della pianificazione del processo.

displayName
  • string

Nome visualizzato per il pianificare.

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 ETag con una richiesta Di pianificazione del processo di aggiornamento per specificare che le modifiche devono essere effettive solo se nessuno altro ha modificato il pianificare nel frattempo.

executionInfo

Informazioni sui processi che sono stati e verranno eseguiti in questa pianificare.

id
  • string

Stringa che identifica in modo univoco la pianificare all'interno dell'account.

jobSpecification

Dettagli dei processi da creare in questa pianificare.

lastModified
  • string

Ora dell'ultima modifica della pianificazione del processo.
Si tratta dell'ultima volta in cui i dati a livello di pianificare, 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

Elenco di coppie nome-valore associate al pianificare come metadati.
Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.

previousState

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

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

state

Stato corrente della pianificazione del processo.

stateTransitionTime
  • string

Ora in cui la pianificazione del processo ha immesso lo stato corrente.

stats

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.

Name Type Description
odata.nextLink
  • string

URL per ottenere il set successivo di risultati.

value

Elenco di pianificazioni dei processi.

CloudServiceConfiguration

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

Name Type Description
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.

Name Type Description
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.

Name Type Description
resourceId
  • string

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

ContainerConfiguration

Configurazione per i pool abilitati per i contenitori.

Name Type Description
containerImageNames
  • string[]

Raccolta di nomi immagine contenitore.
Si tratta del riferimento completo all'immagine, come si specifica per "docker pull". Un'immagine verrà generata dal registro Docker predefinito, a meno che l'immagine non sia completamente qualificata con un registro alternativo.

containerRegistries

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

Tecnologia contenitore da usare.

ContainerRegistry

Un registro contenitori privato.

Name Type Description
identityReference

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.

Name Type Description
dockerCompatible
  • string

Per avviare i contenitori verrà usata una tecnologia contenitore compatibile con Docker.

ContainerWorkingDirectory

Percorso della directory di lavoro dell'attività contenitore.

Name Type Description
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 verrà usato 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.

Name Type Description
caching

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 associano più dischi, ognuno deve avere una lun distinta. Il valore deve essere compreso tra 0 e 63, incluso.

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.

Name Type Description
CacheDisk
  • string

Il disco del sistema operativo temporaneo viene archiviato nella cache della macchina virtuale.

DiffDiskSettings

Specifica il disco temporaneo Impostazioni per il disco del sistema operativo usato dal nodo di calcolo (VM).

Name Type Description
placement

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 temporanee, 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 Raccolta immagini condivise Image.

Name Type Description
targets
  • string[]

L'elenco delle destinazioni del disco del servizio Batch crittograferà nel nodo di calcolo.
Se omesso, non verranno crittografati dischi nei nodi di calcolo nel pool. Nel pool Linux è supportato solo "TemporaryDisk". nel pool Windows, è necessario specificare "OsDisk" e "TemporaryDisk".

DynamicVNetAssignmentScope

Ambito dell'assegnazione dinamica della rete virtuale.

Name Type Description
job
  • string

L'assegnazione dinamica della rete virtuale viene eseguita per processo.

none
  • string

Nessuna assegnazione dinamica della rete virtuale è abilitata.

ElevationLevel

Livello di elevazione dell'utente.

Name Type Description
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à.

Name Type Description
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.

Name Type Description
lang
  • string

Codice del linguaggio del messaggio di errore

value
  • string

Testo del messaggio.

HttpHeader

Coppia nome-valore intestazione HTTP

Name Type Description
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 Raccolta immagini condivise. Per ottenere l'elenco di tutti i riferimenti Azure Marketplace Immagine verificati da Azure Batch, vedere l'operazione 'Elenca immagini supportate'.

Name Type Description
exactVersion
  • string

Versione specifica dell'immagine della piattaforma o dell'immagine del marketplace usata per creare il nodo. Questo campo di sola lettura differisce da 'version' solo se il valore specificato per 'version' quando il pool è stato creato è stato '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 Raccolta immagini condivise. I nodi di calcolo nel pool verranno creati usando questo ID immagine. Si tratta del modulo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/version/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/{resourceGroup}/providers/Microsoft.Compute/gallerys/{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 Raccolta immagini condivise 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 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.

Name Type Description
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.

Name Type Description
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 e viene visualizzato il 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

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

Protocollo dell'endpoint.

IPAddressProvisioningType

Tipo di provisioning per indirizzi IP pubblici per il pool.

Name Type Description
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.

Name Type Description
maxTaskRetryCount
  • integer

Il numero massimo di volte in cui ogni attività può essere riprovata. Il servizio Batch esegue il tentativo di 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 tenta un'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non riprova attività. 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 (nessun tentativo)

maxWallClockTime
  • string

Tempo massimo trascorso che il processo può essere eseguito, 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 di terminazione sarà MaxWallClockTimeExpiry. Se questa proprietà non è specificata, non esiste alcun limite di tempo per quanto tempo può essere eseguito il processo.

JobManagerTask

Specifica i dettagli di un'attività di Job Manager.

Name Type Description
allowLowPriorityNode
  • boolean

Se l'attività Job Manager può essere eseguita in un nodo di calcolo con priorità spot/bassa.
Il valore predefinito è true.

applicationPackageReferences

Elenco dei pacchetti applicazione distribuiti dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando.
I pacchetti applicazione vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro attività. Pertanto, se un pacchetto 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 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

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 per il processo per aggiungere altre attività al processo o controllare lo stato del processo o di altre attività nel processo.

commandLine
  • string

Riga di comando dell'attività Job Manager.
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 (rispetto 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

Vincoli che si applicano all'attività Job Manager.

containerSettings

Impostazioni per il contenitore in cui viene eseguita l'attività Job Manager.
Se il pool che eseguirà questa attività dispone del set di contenitoriConfiguration, è necessario impostare anche questo oggetto. Se il pool che eseguirà questa attività non dispone del set di contenitoriConfiguration, 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 di Azure Batch nel nodo) vengono mappate nel contenitore, tutte le variabili di ambiente attività vengono mappate nel contenitore e la riga di comando attività viene eseguita nel contenitore. I file generati nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi nel disco host, ovvero che le API file batch non potranno accedere a tali file.

displayName
  • string

Nome visualizzato dell'attività Job Manager.
Non è necessario essere univoci e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

environmentSettings

Elenco delle impostazioni delle variabili di ambiente per l'attività Job Manager.

id
  • string

Stringa che identifica in modo univoco l'attività Job Manager 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

Se il completamento dell'attività Job Manager indica il completamento dell'intero processo.
Se true, al termine dell'attività Job Manager, il servizio Batch contrassegna il processo come completato. Se le attività sono ancora in esecuzione in questa fase (diversa dalla versione del processo), tali attività vengono terminate. Se false, il completamento dell'attività Job Manager non influisce sullo stato del processo. In questo caso, è consigliabile usare l'attributo onAllTasksComplete per terminare il processo o avere un client o un utente termina esplicitamente il processo. Un esempio di questo è se Job Manager 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à Job Manager solo per creare le attività per il processo (non per monitorare lo stato di avanzamento), è importante impostare killJobOnCompletion su false.

outputFiles

Elenco di file che il servizio Batch caricherà dal nodo di calcolo dopo l'esecuzione della riga di comando.
Per le attività a più istanze, 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 solo in un nodo di calcolo se il nodo dispone di slot di pianificazione gratuiti sufficienti. Per attività multiistanza, questa proprietà non è supportata e non deve essere specificata.

resourceFiles

Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando.
I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. È disponibile una dimensione massima per l'elenco dei file di risorse. Quando la dimensione massima viene superata, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta in dimensioni. Ciò può essere ottenuto usando i file .zip, i pacchetti applicazione o i contenitori Docker.

runExclusive
  • boolean

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 fino a quando gestione processi è in esecuzione. Se false, altre attività possono essere eseguite simultaneamente con Job Manager in un nodo di calcolo. L'attività Job Manager conta normalmente rispetto al limite di attività simultaneo del nodo di calcolo, pertanto è rilevante solo se il nodo di calcolo consente più attività simultanee. Il valore predefinito è true.

userIdentity

Identità utente in cui viene eseguita l'attività Job Manager.
Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

JobNetworkConfiguration

Configurazione di rete per il processo.

Name Type Description
subnetId
  • string

Identificatore della risorsa ARM della subnet di rete virtuale a cui i nodi di calcolo che eseguono attività dal processo verranno aggiunti per la durata dell'attività. Questo 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 indirizzi IP sufficienti per supportare il numero di nodi di calcolo che eseguiranno Attività dal processo. Questo 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. Questa operazione può essere verificata controllando se la rete virtuale specificata dispone di gruppi di sicurezza di rete associati. Se la comunicazione ai nodi nella subnet specificata viene negata da un gruppo di sicurezza di rete, il servizio Batch imposta lo stato dei nodi di calcolo su non utilizzabile. Si tratta del modulo /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/{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 Archiviazione di Azure. Per altre informazioni, vedere: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

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

Name Type Description
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 (rispetto 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

Vincoli che si applicano all'attività Preparazione processi.

containerSettings

Impostazioni per il contenitore in cui viene eseguita l'attività Preparazione processi.
Quando viene specificato, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) vengono mappate nel contenitore, tutte le variabili di ambiente attività vengono mappate nel contenitore e la riga di comando attività viene eseguita nel contenitore. I file generati nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi nel disco host, ovvero che le API file batch non potranno accedere a tali file.

environmentSettings

Elenco delle impostazioni delle variabili di ambiente per l'attività Preparazione processi.

id
  • string

Stringa che identifica in modo univoco l'attività preparazione 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. 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à preparazione processi. 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

Se il servizio Batch deve eseguire nuovamente l'attività preparazione processo dopo il riavvio di un nodo di calcolo.
L'attività preparazione processo viene sempre eseguita di nuovo se un nodo di calcolo è reimaged o se l'attività 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 del processo per essere idempotente e comportarsi correttamente se viene eseguita più volte. Il valore predefinito è true.

resourceFiles

Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando.
I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. È disponibile una dimensione massima per l'elenco dei file di risorse. Quando la dimensione massima viene superata, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta in dimensioni. Ciò può essere ottenuto usando i file .zip, i pacchetti applicazione o i contenitori Docker.

userIdentity

Identità utente in cui viene eseguita l'attività Preparazione processi.
Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività in Windows nodi di calcolo o un utente non amministrativo univoco per il pool nei nodi di calcolo Linux.

waitForSuccess
  • boolean

Se il servizio Batch deve attendere il completamento dell'attività preparazione processo prima di pianificare tutte le altre attività del processo nel nodo di calcolo. Un'attività di preparazione del processo è stata completata correttamente se termina con il codice di uscita 0.
Se true e l'attività preparazione processo non riesce in un nodo, il servizio Batch esegue il tentativo di ripetizione dell'attività di preparazione dei processi fino al numero massimo di tentativi ( come specificato nell'elemento vincoli). Se l'attività non è ancora stata completata dopo tutti i tentativi, il servizio Batch non pianificare attività del processo nel nodo. Il nodo rimane attivo e idoneo per eseguire attività di altri processi. Se false, il servizio Batch non attende il completamento dell'attività preparazione processi. In questo caso, altre attività del processo possono iniziare a eseguire nel nodo di calcolo mentre l'attività Preparazione processi è ancora in esecuzione; e anche se l'attività preparazione processo ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true.

JobReleaseTask

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

Name Type Description
commandLine
  • string

Riga di comando dell'attività Versione 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 (rispetto 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

Impostazioni per il contenitore in cui viene eseguita l'attività Rilascio processi.
Quando viene specificato, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) vengono mappate nel contenitore, tutte le variabili di ambiente attività vengono mappate nel contenitore e la riga di comando attività viene eseguita nel contenitore. I file generati nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi nel disco host, ovvero che le API file batch non potranno accedere a tali file.

environmentSettings

Elenco delle impostazioni delle variabili di ambiente per l'attività Versione processo.

id
  • string

Stringa che identifica in modo univoco l'attività Versione 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 di 'jobrelease'. Nessun'altra attività nel processo può avere lo stesso ID dell'attività Versione 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 che l'attività Rilascio processi può essere eseguita in un determinato nodo di calcolo, misurata dal momento in cui l'attività viene avviata. 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

Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. È disponibile una dimensione massima per l'elenco dei file di risorse. Quando la dimensione massima viene superata, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta in dimensioni. Ciò può essere ottenuto usando i file .zip, i pacchetti applicazione o i 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à Rilascio processi 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

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 verranno eseguiti in una pianificazione del processo.

Name Type Description
endTime
  • string

Ora in cui la pianificare è terminata.
Questa proprietà viene impostata solo se la pianificazione del processo è nello stato completato.

nextRunTime
  • string

Alla successiva creazione di un processo in questa pianificare.
Questa proprietà è significativa solo se l'pianificare è nello stato attivo quando viene eseguito il tempo. Ad esempio, se la pianificare è disabilitata, nessun processo verrà creato a nextRunTime, a meno che il processo non sia abilitato prima di allora.

recentJob

Informazioni sul processo più recente nella pianificazione dei processi.
Questa proprietà è presente solo se nell'pianificare è in esecuzione almeno un processo.

JobScheduleState

Stato della pianificazione del processo.

Name Type Description
active
  • string

La pianificazione dei processi è attiva e creerà processi in base al relativo pianificare.

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 pianificare, 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.

Name Type Description
kernelCPUTime
  • string

Tempo di CPU in modalità kernel totale (sommato in tutti i core e tutti i nodi di calcolo) utilizzato da tutte le attività in tutti i processi creati nella pianificare.

lastUpdateTime
  • string

Ora in cui sono state aggiornate le 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 nella pianificare. 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 nella pianificare. 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à create in tutti i processi creati nella pianificare.

readIOGiB
  • number

Il totale gibibyte letto dal disco da tutte le attività in tutti i processi creati nella pianificare.

readIOps
  • integer

Numero totale di operazioni di lettura disco eseguite da tutte le attività in tutti i processi creati nella pianificare.

startTime
  • string

Ora di inizio dell'intervallo di tempo coperto dalle statistiche.

url
  • string

URL delle statistiche.

userCPUTime
  • string

Tempo di 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 pianificare.

waitTime
  • string

Tempo di attesa totale di tutte le attività in tutti i processi creati nella pianificare. 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 riprovata a causa di errori, il tempo di attesa è l'ora dell'esecuzione dell'attività più recente.
Questo valore viene segnalato solo nelle statistiche sulla durata dell'account; non è incluso nelle statistiche del processo.

wallClockTime
  • string

Ora totale dell'orologio a parete di tutte le attività in tutti i processi creati nella pianificare.
Il tempo dell'orologio a parete è il tempo trascorso da quando l'attività è stata avviata in esecuzione in un nodo di calcolo a quando è stata completata (o all'ultima volta che le statistiche sono state aggiornate, se l'attività non è stata completata da allora). Se un'attività è stata ritrita, questo include l'ora dell'orologio a parete di tutti i tentativi dell'attività.

writeIOGiB
  • number

I gibibyte totali scritti su disco da tutte le attività in tutti i processi creati nella pianificare.

writeIOps
  • integer

Numero totale di operazioni di scrittura su disco eseguite da tutte le attività in tutti i processi creati nella pianificare.

JobSpecification

Specifica i dettagli dei processi da creare in un pianificare.

Name Type Default Value Description
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

Elenco delle impostazioni comuni delle variabili di ambiente. Queste variabili di ambiente sono impostate per tutte le attività nei processi creati in questa pianificare (tra cui Job Manager, Preparazione processi e attività di rilascio processi).
Le singole attività possono eseguire l'override di un'impostazione di ambiente specificata qui specificando lo stesso nome dell'impostazione con un valore diverso.

constraints

Vincoli di esecuzione per i processi creati in questa pianificare.

displayName
  • string

Nome visualizzato per i processi creati in questa pianificare.
Il nome non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

jobManagerTask

I dettagli di un'attività di Job Manager da avviare quando viene avviato un processo in questa pianificare.
Se il processo non specifica un'attività di Job Manager, l'utente deve aggiungere in modo esplicito Attività al processo usando l'API Attività. Se il processo specifica un'attività di Job Manager, il servizio Batch crea l'attività Job Manager quando viene creato il processo e tenterà di pianificare l'attività Job Manager prima di pianificare altre attività nel processo.

jobPreparationTask

Attività preparazione processi per i processi creati in questa pianificare.
Se un processo ha un'attività di preparazione del processo, il servizio Batch eseguirà l'attività preparazione processi in un nodo prima di avviare qualsiasi attività del processo in tale nodo di calcolo.

jobReleaseTask

Attività rilascio processo per i processi creati in questa pianificare.
Lo scopo principale dell'attività Versione processo è annullare le modifiche apportate ai nodi apportate 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 del processo senza specificare anche un'attività di preparazione del processo per il processo. Il servizio Batch esegue l'attività Rilascio processi nei nodi di calcolo che hanno eseguito l'attività Preparazione processi.

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

Elenco di coppie nome-valore associate a ogni processo creato in questa pianificare come metadati.
Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.

networkConfiguration

Configurazione di rete per il processo.

onAllTasksComplete

L'azione che il servizio Batch deve eseguire quando tutte le attività in un processo creato in questo pianificare 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

L'azione che il servizio Batch deve eseguire quando qualsiasi attività ha esito negativo in un processo creato in questa pianificare. 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

Il pool in cui il servizio Batch esegue le attività di processi create in questa pianificare.

priority
  • integer

Priorità dei processi creati in questa pianificare.
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.

Name Type Description
gid
  • integer

ID gruppo per l'account utente.
Le proprietà uid e gid devono essere specificate insieme o meno. Se non è specificato il sistema operativo sottostante, seleziona la 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). Questa operazione viene eseguita inserendo 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 meno. Se non è specificato il sistema operativo sottostante, seleziona l'interfaccia utente.

LoginMode

Modalità di accesso per l'utente

Name Type Description
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 in Windows pool VirtualMachineConfiguration. Se questa opzione viene usata con un'identità utente con privilegi elevati in un pool di Windows VirtualMachineConfiguration, la sessione utente non verrà elevata a meno che l'applicazione eseguita dalla riga di comando Attività sia configurata per richiedere sempre privilegi amministrativi o per richiedere sempre privilegi massimi.

MetadataItem

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

Name Type Description
name
  • string

Nome dell'elemento dei metadati.

value
  • string

Valore dell'elemento dei metadati.

MountConfiguration

File system da montare in ogni nodo.

Name Type Description
azureBlobFileSystemConfiguration

Contenitore Archiviazione di Azure da montare usando BLOB FUSE in ogni nodo.
Questa proprietà si escludono a vicenda con tutte le altre proprietà.

azureFileShareConfiguration

Condivisione file di Azure da montare in ogni nodo.
Questa proprietà si escludono a vicenda con tutte le altre proprietà.

cifsMountConfiguration

File system CIFS/SMB da montare in ogni nodo.
Questa proprietà si escludono a vicenda con tutte le altre proprietà.

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.

Name Type Description
dynamicVNetAssignmentScope

Ambito dell'assegnazione dinamica della rete virtuale.

endpointConfiguration

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

Configurazione di IPAddress pubblico per i nodi di calcolo nel pool di Batch.
La proprietà di configurazione DELL'INDIRIZZO IP pubblico è supportata solo nei 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 modulo /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/{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 per 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.

Name Type Description
access

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.

Name Type Description
allow
  • string

Consente l'accesso.

deny
  • string

Nega l'accesso.

NFSMountConfiguration

Informazioni utilizzate per connettersi a un file system NFS.

Name Type Description
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.

NodePlacementConfiguration

Configurazione del posizionamento dei nodi per un pool.

Name Type Description
policy

Tipo di criterio di posizionamento del nodo nei pool batch.
Criteri di allocazione usati dal servizio Batch per effettuare il provisioning dei nodi. Se non specificato, Batch userà i criteri regionali.

NodePlacementPolicyType

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

Name Type Description
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 si trovano nello stato completato.

Name Type Description
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. Il termine di JobReason è impostato su 'AllTasksComplete'.

OnTaskFailure

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

Name Type Description
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à. Questo può comunque causare l'esecuzione di alcuna azione, se si tratta di ciò che specifica l'attività.

OSDisk

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

Name Type Description
ephemeralOSDiskSettings

Specifica il Impostazioni disco temporaneo per il disco del sistema operativo usato dal 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à.

Name Type Description
destination

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% su Windows o $var in Linux) vengono espanse prima dell'applicazione del modello.

uploadOptions

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.

Name Type Description
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

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

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. Per altre informazioni, vedere Intestazioni di richiesta (tutti i tipi di BLOB).

OutputFileDestination

Destinazione in cui deve essere caricato un file.

Name Type Description
container

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.

Name Type Description
taskcompletion
  • string

Upload i file dopo l'uscita dal processo attività, indipendentemente dal codice di uscita.

taskfailure
  • string

Upload i file solo dopo l'uscita del processo attività con un codice di uscita diverso da zero.

tasksuccess
  • string

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

Name Type Description
uploadCondition

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.

Name Type Description
inboundNATPools

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 il codice di stato HTTP 400. Impossibile specificare se l'IPAddressProvisioningType è NoPublicIPAddresses.

PoolInformation

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

Name Type Description
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é non esiste il pool. È 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 un pianificare ai pool.

Name Type Description
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 'job' viene applicata a una pianificazione processo, il servizio Batch crea un nuovo pool automatico per ogni processo creato nel pianificare.

jobschedule
  • string

Il pool esiste per la durata della pianificazione del processo. Il servizio Batch crea il pool quando crea il primo processo nel pianificare. È possibile applicare questa opzione solo alle pianificazioni dei processi, non ai processi.

PoolSpecification

Specifica per la creazione di un nuovo pool.

Name Type Description
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

Elenco di pacchetti da installare in ogni nodo di calcolo nel pool.
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

Elenco dei certificati da installare in ogni nodo di calcolo nel pool.
Per Windows nodi, 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.

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

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

Elenco di file system da montare su ogni nodo nel pool.
Supporta File di Azure, NFS, CIFS/SMB e BLOBfuse.

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

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.

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

Elenco degli account utente da creare in ogni nodo di calcolo nel pool.

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.

Name Type Description
ipAddressIds
  • string[]

Elenco di indirizzi IP pubblici che il servizio Batch userà 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/Low-priority 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 è del modulo: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

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.

Name Type Description
id
  • string

ID del processo.

url
  • string

URL del processo.

ResourceFile

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

Name Type Description
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 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 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

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

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

Name Type Description
doNotRunAfter
  • string

Ora dopo la quale non verrà creato alcun processo in questa pianificazione del processo. Il pianificare passerà allo stato completato non appena questa scadenza è passata e non è presente 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, il pianificare diventa pronto 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 pianificare non viene eseguita nuovamente: un processo viene creato, all'interno dell'avvioWindow dopo l'ora doNotRunUntil e la pianificare viene completata non appena termina il processo. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta il pianificare 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 il pianificare 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 del pianificare. Se il pianificare è ricorrente e startWindow è più lungo dell'intervallo di ricorrenza, questo equivale a uno startWindow infinito, perché il processo "due" 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 il pianificare con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

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.

Name Type Description
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

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

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 (nessun tentativo)

resourceFiles

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

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 correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo inutilizzabile e non pianificare 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 iniziare a essere eseguite sul 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.

Name Type Description
premium_lrs
  • string

Il disco dati deve usare l'archiviazione con ridondanza locale Premium.

standard_lrs
  • string

Il disco dati deve usare l'archiviazione con ridondanza locale standard.

TaskConstraints

Vincoli di esecuzione da applicare a un'attività.

Name Type Description
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 (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 può essere eseguito l'attività.

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

Name Type Description
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

Registro privato contenente l'immagine del contenitore.
Questa impostazione può essere omessa se è già stata fornita alla creazione del pool.

workingDirectory

Percorso della directory di lavoro attività contenitore.
Il valore predefinito è 'taskWorkingDirectory'.

TaskSchedulingPolicy

Specifica il modo in cui le attività devono essere distribuite tra nodi di calcolo.

Name Type Description
nodeFillType

Modalità di distribuzione delle attività tra nodi di calcolo in un pool.
Se non specificato, il valore predefinito viene distribuito.

UserAccount

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

Name Type Description
elevationLevel

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

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.

password
  • string

Password per l'account utente.

windowsUserConfiguration

Configurazione utente specifica del 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à.

Name Type Description
autoUser

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.

Name Type Description
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

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

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

Estensione della macchina virtuale per il pool.
Se specificato, le estensioni indicate in questa configurazione verranno installate in ogni nodo.

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.
Questa operazione si applica solo alle 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 Windows Client.

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 di riferimenti di immagine verificati, vedere l'operazione "Sku dell'agente del nodo di calcolo supportati dall'elenco".

nodePlacementConfiguration

Configurazione del posizionamento del nodo per il pool.
Questa configurazione specifica le regole su come verranno allocati fisicamente i nodi nel pool.

osDisk

Impostazioni per il disco del sistema operativo della macchina virtuale.

windowsConfiguration

Windows impostazioni del sistema operativo 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.

Name Type Description
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.

name
  • string

Nome dell'estensione della 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 cui è necessario effettuare il provisioning di questa estensione.

publisher
  • string

Nome dell'autore del gestore dell'estensione.

settings
  • object

Impostazioni pubbliche formattate JSON per l'estensione.

type
  • string

Il tipo di estensione.

typeHandlerVersion
  • string

Versione del gestore di script.

WindowsConfiguration

Windows impostazioni del sistema operativo da applicare alla macchina virtuale.

Name Type Description
enableAutomaticUpdates
  • boolean

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 di Windows.

Name Type Description
loginMode

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