Job Schedule - List

Elenca tutte le pianificazioni dei processi nell'account specificato.

GET {batchUrl}/jobschedules?api-version=2024-07-01.20.0
GET {batchUrl}/jobschedules?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

Parametri dell'URI

Nome In Necessario Tipo Descrizione
batchUrl
path True

string

URL di base per tutte le richieste del servizio Azure Batch.

api-version
query True

string

Versione dell'API client.

$expand
query

string

Clausola di $expand OData.

$filter
query

string

Clausola di $filter OData. Per altre informazioni sulla creazione di questo filtro, vedere https://docs.microsoft.com/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 dei processi.

timeout
query

integer

int32

Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è maggiore di 30, verrà usato il valore predefinito.

Intestazione della richiesta

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

Nome Necessario Tipo Descrizione
client-request-id

string

uuid

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

return-client-request-id

boolean

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

ocp-date

string

date-time-rfc1123

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

Risposte

Nome Tipo Descrizione
200 OK

CloudJobScheduleListResult

Risposta contenente l'elenco delle pianificazioni dei processi.

Intestazioni

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

BatchError

Errore del servizio Batch.

Sicurezza

azure_auth

Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0

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

Ambiti

Nome Descrizione
user_impersonation Rappresentare l'account utente

Authorization

Tipo: apiKey
In: header

Esempio

JobSchedule list

Esempio di richiesta

GET account.region.batch.azure.com/jobschedules?api-version=2024-07-01.20.0


Risposta di esempio

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

Definizioni

Nome Descrizione
AccessScope

Risorse batch a cui il token concede l'accesso.

ApplicationPackageReference

Riferimento a un pacchetto da distribuire nei nodi di calcolo.

AuthenticationTokenSettings

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

AutomaticOSUpgradePolicy

Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.

AutoPoolSpecification

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

AutoUserScope

Ambito dell'utente automatico

AutoUserSpecification

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

AzureBlobFileSystemConfiguration

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

AzureFileShareConfiguration

Informazioni usate per connettersi a una condivisione file di Azure.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

BatchErrorDetail

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

CachingType

Tipo di memorizzazione nella cache da abilitare per il disco.

CertificateReference

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

CertificateStoreLocation

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

CertificateVisibility

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

CIFSMountConfiguration

Informazioni utilizzate per connettersi a un file system CIFS.

CloudJobSchedule

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

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.

ContainerHostBatchBindMountEntry

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

ContainerHostDataPath

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

ContainerRegistry

Registro contenitori privato.

ContainerType

Tecnologia contenitore da usare.

ContainerWorkingDirectory

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

DataDisk

Impostazioni che verranno usate dai dischi dati associati ai nodi di calcolo nel pool. Quando si usano dischi dati collegati, è necessario montare e formattare i dischi dall'interno di una macchina virtuale per usarli.

DiffDiskPlacement

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

DiffDiskSettings

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

DiskEncryptionConfiguration

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

DiskEncryptionTarget

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

DynamicVNetAssignmentScope

Ambito dell'assegnazione dinamica della rete virtuale.

ElevationLevel

Livello di elevazione dell'utente.

EnvironmentSetting

Variabile di ambiente da impostare in un processo task.

ErrorMessage

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

HttpHeader

Coppia nome-valore intestazione HTTP

ImageReference

Riferimento a un'immagine del Marketplace di macchine virtuali di Azure o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti alle immagini di Azure Marketplace 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 gli indirizzi IP pubblici per il pool.

JobConstraints

Vincoli di esecuzione per un processo.

JobManagerTask

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

JobNetworkConfiguration

Configurazione di rete per il processo.

JobPreparationTask

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

JobReleaseTask

Un'attività di rilascio del 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 di utilizzo delle risorse per una pianificazione del processo.

JobSpecification

Specifica i dettagli dei processi da creare in base a una pianificazione.

LinuxUserConfiguration

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

LoginMode

Modalità di accesso per l'utente

ManagedDisk
MetadataItem

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

MountConfiguration

File system da montare in ogni nodo.

NetworkConfiguration

Configurazione di rete per un pool.

NetworkSecurityGroupRule

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

NetworkSecurityGroupRuleAccess

Azione da eseguire per un indirizzo IP, un intervallo di subnet o un tag specificati.

NFSMountConfiguration

Informazioni utilizzate per connettersi a un file system NFS.

NodeCommunicationMode

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

NodePlacementConfiguration

Configurazione del posizionamento dei nodi per un pool.

NodePlacementPolicyType

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

OnAllTasksComplete

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

OnTaskFailure

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

OSDisk

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

OutputFile

Specifica per il caricamento di file da un nodo di calcolo di Azure Batch in un'altra posizione 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 caricare un file.

OutputFileUploadCondition

Condizioni in base alle quali deve essere caricato un file di output attività o un set di file.

OutputFileUploadOptions

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

PoolEndpointConfiguration

Configurazione dell'endpoint per un pool.

PoolInformation

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

PoolLifetimeOption

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

PoolSpecification

Specifica per la creazione di un nuovo pool.

PublicIPAddressConfiguration

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

RecentJob

Informazioni sul processo più recente da eseguire nella pianificazione del processo.

ResourceFile

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

RollingUpgradePolicy

Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.

Schedule

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

SecurityEncryptionTypes

Specifica encryptionType del disco gestito. È impostato su VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostata solo per le macchine virtuali riservate ed è necessaria quando si usano macchine virtuali riservate.

SecurityProfile

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

SecurityTypes

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

ServiceArtifactReference

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

StartTask

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

StorageAccountType

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

TaskConstraints

Vincoli di esecuzione da applicare a un'attività.

TaskContainerSettings

Impostazioni del contenitore per un'attività.

TaskSchedulingPolicy

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

UefiSettings

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

UpgradeMode

Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità.

I valori possibili sono:

manuale: è possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade.

automatico: tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.

in sequenza: il set di scalabilità esegue gli aggiornamenti in batch con un tempo di pausa facoltativo tra di loro.

UpgradePolicy

Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.

UserAccount

Proprietà usate per creare un utente usato per eseguire attività in un nodo di calcolo di 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.

VMDiskSecurityProfile

Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostata solo per le macchine virtuali riservate e necessarie quando si usano macchine virtuali riservate.

VMExtension

Configurazione per le estensioni della macchina virtuale.

WindowsConfiguration

Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.

WindowsUserConfiguration

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

AccessScope

Risorse batch a cui il token concede l'accesso.

Nome Tipo Descrizione
job

string

Concede l'accesso per eseguire tutte le operazioni sul processo contenente l'attività.

ApplicationPackageReference

Riferimento a un pacchetto da distribuire nei nodi di calcolo.

Nome Tipo Descrizione
applicationId

string

ID dell'applicazione da distribuire.
Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

version

string

Versione dell'applicazione da distribuire. Se omesso, viene distribuita la versione predefinita.
Se questo viene omesso in un pool e non viene specificata alcuna versione predefinita per questa applicazione, la richiesta ha esito negativo con il codice di errore InvalidApplicationPackageReferences e il codice di stato HTTP 409. Se questa operazione viene omessa in un'attività e non viene specificata alcuna versione predefinita per questa applicazione, l'attività ha esito negativo con un errore di pre-elaborazione.

AuthenticationTokenSettings

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

Nome Tipo Descrizione
access

AccessScope[]

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

AutomaticOSUpgradePolicy

Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.

Nome Tipo Descrizione
disableAutomaticRollback

boolean

Indica se la funzionalità di rollback dell'immagine del sistema operativo deve essere disabilitata.

enableAutomaticOSUpgrade

boolean

Indica se gli aggiornamenti del sistema operativo devono essere applicati automaticamente alle istanze del set di scalabilità in sequenza quando diventa disponibile una versione più recente dell'immagine del sistema operativo.

Se è impostato su true per i pool basati su Windows, WindowsConfiguration.enableAutomaticUpdates non può essere impostato su true.

osRollingUpgradeDeferral

boolean

Rinviare gli aggiornamenti del sistema operativo nelle macchine virtuali se eseguono attività.

useRollingUpgradePolicy

boolean

Indica se i criteri di aggiornamento in sequenza devono essere usati durante l'aggiornamento automatico del sistema operativo. L'aggiornamento automatico del sistema operativo eseguirà il fallback ai criteri predefiniti se non sono definiti criteri nel set di scalabilità di macchine virtuali.

AutoPoolSpecification

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

Nome Tipo Descrizione
autoPoolIdPrefix

string

Prefisso da aggiungere all'identificatore univoco quando viene creato automaticamente un pool.
Il servizio Batch assegna a ogni pool automatico un identificatore univoco alla creazione. Per distinguere i pool creati per scopi diversi, è possibile specificare questo elemento per aggiungere un prefisso all'ID assegnato. Il prefisso può contenere fino a 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 che la durata (come determinato dall'impostazione poolLifetimeOption) scade; ovvero quando viene completata la pianificazione del processo o del processo. Se true, il servizio Batch non elimina automaticamente il pool. Spetta all'utente eliminare i pool automatici creati con questa opzione.

pool

PoolSpecification

Specifica pool per il pool automatico.

poolLifetimeOption

PoolLifetimeOption

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

AutoUserScope

Ambito dell'utente automatico

Nome Tipo Descrizione
pool

string

Specifica che l'attività viene eseguita come account utente automatico comune creato in ogni nodo di calcolo in un pool.

task

string

Specifica che il servizio deve creare un nuovo utente per l'attività.

AutoUserSpecification

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

Nome Tipo Descrizione
elevationLevel

ElevationLevel

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

scope

AutoUserScope

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

AzureBlobFileSystemConfiguration

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

Nome Tipo Descrizione
accountKey

string

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

accountName

string

Nome dell'account di archiviazione di Azure.

blobfuseOptions

string

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

containerName

string

Nome del contenitore di Archiviazione BLOB di Azure.

identityReference

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere a containerName
Questa proprietà si escludono a vicenda sia con accountKey che con sasKey; deve essere specificato esattamente uno.

relativeMountPath

string

Percorso relativo nel nodo di calcolo in cui verrà montato il file system
Tutti i file system vengono montati in relazione alla directory dei montaggi batch, accessibili tramite la variabile di ambiente AZ_BATCH_NODE_MOUNTS_DIR.

sasKey

string

Token di firma di accesso condiviso di Archiviazione di Azure.
Questa proprietà si escludono a vicenda sia con accountKey che con l'identità; deve essere specificato esattamente uno.

AzureFileShareConfiguration

Informazioni usate per connettersi a una condivisione file di Azure.

Nome Tipo Descrizione
accountKey

string

Chiave dell'account di archiviazione di Azure.

accountName

string

Nome dell'account di archiviazione di Azure.

azureFileUrl

string

URL di 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' in Windows e 'mount' opzioni in Linux.

relativeMountPath

string

Percorso relativo nel nodo di calcolo in cui verrà montato il file system
Tutti i file system vengono montati in relazione alla directory dei montaggi batch, accessibili tramite la variabile di ambiente AZ_BATCH_NODE_MOUNTS_DIR.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome Tipo Descrizione
code

string

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

message

ErrorMessage

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

values

BatchErrorDetail[]

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

BatchErrorDetail

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

Nome Tipo Descrizione
key

string

Identificatore che specifica il significato della proprietà Value.

value

string

Informazioni aggiuntive incluse nella risposta di errore.

CachingType

Tipo di memorizzazione nella cache da abilitare per il disco.

Nome Tipo Descrizione
none

string

La modalità di memorizzazione nella cache per il disco non è abilitata.

readonly

string

La modalità di memorizzazione nella cache per il disco è di sola lettura.

readwrite

string

La modalità di memorizzazione nella cache per il disco è di lettura e scrittura.

CertificateReference

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

Nome Tipo Descrizione
storeLocation

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
Il valore predefinito è currentuser. Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

storeName

string

Nome dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows. I nomi comuni degli archivi includono: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ma è possibile usare anche qualsiasi nome di archivio personalizzato. Il valore predefinito è My.

thumbprint

string

Identificazione personale del certificato.

thumbprintAlgorithm

string

Algoritmo a cui è associata l'identificazione personale. Deve essere sha1.

visibility

CertificateVisibility[]

Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.
È possibile specificare più visibilità in questa raccolta. Il valore predefinito è tutti Gli account.

CertificateStoreLocation

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

Nome Tipo Descrizione
currentuser

string

I certificati devono essere installati nell'archivio certificati CurrentUser.

localmachine

string

I certificati devono essere installati nell'archivio certificati LocalMachine.

CertificateVisibility

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

Nome Tipo Descrizione
remoteuser

string

Il certificato deve essere visibile agli account utente in cui gli utenti accedono in remoto al nodo di calcolo.

starttask

string

Il certificato deve essere visibile all'account utente in cui viene eseguito StartTask. Si noti che se l'ambito dell'utente automatico è Pool sia per StartTask che per un'attività, questo certificato sarà visibile anche all'attività.

task

string

Il certificato deve essere visibile agli account utente in cui vengono eseguite le attività di processo.

CIFSMountConfiguration

Informazioni utilizzate per connettersi a un file system CIFS.

Nome Tipo Descrizione
mountOptions

string

Opzioni della riga di comando aggiuntive da passare al comando mount.
Queste sono le opzioni 'net use' in Windows e 'mount' opzioni 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 processo che consente processi ricorrenti specificando quando eseguire processi e una specifica usata per creare ogni processo.

Nome Tipo Descrizione
creationTime

string

Ora di creazione della pianificazione del processo.

displayName

string

Nome visualizzato per la pianificazione.

eTag

string

ETag della pianificazione del processo.
Si tratta di una stringa opaca. È possibile usarlo per rilevare se la pianificazione dei processi è stata modificata tra le richieste. In particolare, è possibile passare l'ETag con una richiesta di pianificazione processo di aggiornamento per specificare che le modifiche devono essere applicate solo se nessun altro ha modificato la pianificazione nel frattempo.

executionInfo

JobScheduleExecutionInformation

Informazioni sui processi che sono stati e verranno eseguiti in base a questa pianificazione.

id

string

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

jobSpecification

JobSpecification

Dettagli dei processi da creare in questa pianificazione.

lastModified

string

Ora dell'ultima modifica della pianificazione del processo.
Si tratta dell'ultima volta in cui i dati a livello di pianificazione, ad esempio la specifica del processo o le informazioni di ricorrenza, sono state modificate. Non influisce su modifiche a livello di processo, ad esempio la creazione di nuovi processi o la modifica dello stato dei processi.

metadata

MetadataItem[]

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

previousState

JobScheduleState

Stato precedente della pianificazione del processo.
Questa proprietà non è presente se la pianificazione del processo è nello stato attivo iniziale.

previousStateTransitionTime

string

Ora in cui la pianificazione del processo ha immesso lo stato precedente.
Questa proprietà non è presente se la pianificazione del processo è nello stato attivo iniziale.

schedule

Schedule

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

state

JobScheduleState

Stato corrente della pianificazione del processo.

stateTransitionTime

string

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

stats

JobScheduleStatistics

Statistiche di utilizzo delle risorse di durata per la pianificazione del processo. Le statistiche potrebbero non essere immediatamente disponibili. Il servizio Batch esegue un rollup periodico delle statistiche. Il ritardo tipico è di circa 30 minuti.

url

string

URL della pianificazione del processo.

CloudJobScheduleListResult

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

Nome Tipo Descrizione
odata.nextLink

string

URL per ottenere il set di risultati successivo.

value

CloudJobSchedule[]

Elenco di pianificazioni dei processi.

ComputeNodeFillType

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

Nome Tipo Descrizione
pack

string

Il maggior numero possibile di attività (taskSlotsPerNode) deve essere assegnato a ogni nodo di calcolo nel pool prima che tutte le attività vengano assegnate al nodo di calcolo successivo nel pool.

spread

string

Le attività devono essere assegnate in modo uniforme in tutti i nodi di calcolo nel pool.

ComputeNodeIdentityReference

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

Nome Tipo Descrizione
resourceId

string

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

ContainerConfiguration

Configurazione per i pool abilitati per i contenitori.

Nome Tipo Descrizione
containerImageNames

string[]

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

containerRegistries

ContainerRegistry[]

Registri privati aggiuntivi da cui è possibile eseguire il pull dei contenitori.
Se le immagini devono essere scaricate da un registro privato che richiede credenziali, è necessario specificare le credenziali qui.

type

ContainerType

Tecnologia contenitore da usare.

ContainerHostBatchBindMountEntry

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

Nome Tipo Descrizione
isReadOnly

boolean

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

source

ContainerHostDataPath

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

ContainerHostDataPath

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

Nome Tipo Descrizione
Applications

string

Percorso delle applicazioni.

JobPrep

string

Percorso dell'attività di preparazione del processo.

Shared

string

Percorso dell'attività a più istanze in cui condividere i propri file.

Startup

string

Percorso dell'attività di avvio.

Task

string

Percorso dell'attività.

VfsMounts

string

Il percorso contiene tutti i file system virtuali montati in questo nodo.

ContainerRegistry

Registro contenitori privato.

Nome Tipo Descrizione
identityReference

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password.
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

password

string

Password per accedere al server del Registro di sistema.

registryServer

string

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

username

string

Nome utente per accedere al server del Registro di sistema.

ContainerType

Tecnologia contenitore da usare.

Nome Tipo Descrizione
criCompatible

string

Per avviare i contenitori verrà usata una tecnologia basata su CRI.

dockerCompatible

string

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

ContainerWorkingDirectory

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

Nome Tipo Descrizione
containerImageDefault

string

Usare la directory di lavoro definita nell'immagine del contenitore. Tenere presente che questa directory non conterrà i file di risorse scaricati da Batch.

taskWorkingDirectory

string

Usare la directory di lavoro dell'attività del servizio Batch standard, che conterrà i file di risorse attività popolati da Batch.

DataDisk

Impostazioni che verranno usate dai dischi dati associati ai nodi di calcolo nel pool. Quando si usano dischi dati collegati, è necessario montare e formattare i dischi dall'interno di una macchina virtuale per usarli.

Nome Tipo Descrizione
caching

CachingType

Tipo di memorizzazione nella cache da abilitare per i dischi dati.
Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Dimensioni iniziali del disco in gigabyte.

lun

integer

Numero di unità logica.
Il lun viene usato per identificare in modo univoco ogni disco dati. Se si collegano più dischi, ognuno deve avere un lun distinto. Il valore deve essere compreso tra 0 e 63 inclusi.

storageAccountType

StorageAccountType

Tipo di account di archiviazione da usare per il disco dati.
Se omesso, il valore predefinito è "standard_lrs".

DiffDiskPlacement

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

Nome Tipo Descrizione
CacheDisk

string

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

DiffDiskSettings

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

Nome Tipo Descrizione
placement

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutte le macchine virtuali nel pool.
Questa proprietà può essere usata dall'utente nella richiesta per scegliere il percorso, ad esempio lo spazio su disco della cache per il provisioning temporaneo del disco del sistema operativo. Per altre informazioni sui requisiti delle dimensioni del disco del sistema operativo temporaneo, vedere Requisiti delle dimensioni del disco del sistema operativo temporaneo per le macchine virtuali Windows in https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e macchine virtuali Linux all'indirizzo https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

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

Nome Tipo Descrizione
targets

DiskEncryptionTarget[]

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

DiskEncryptionTarget

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

Nome Tipo Descrizione
osdisk

string

Il disco del sistema operativo nel nodo di calcolo è crittografato.

temporarydisk

string

Il disco temporaneo nel nodo di calcolo è crittografato. In Linux questa crittografia si applica ad altre partizioni (ad esempio quelle su dischi dati montati) quando la crittografia viene eseguita al momento dell'avvio.

DynamicVNetAssignmentScope

Ambito dell'assegnazione dinamica della rete virtuale.

Nome Tipo Descrizione
job

string

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

none

string

Non è abilitata alcuna assegnazione dinamica di rete virtuale.

ElevationLevel

Livello di elevazione dell'utente.

Nome Tipo Descrizione
admin

string

L'utente è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete.

nonadmin

string

L'utente è un utente standard senza accesso con privilegi elevati.

EnvironmentSetting

Variabile di ambiente da impostare in un processo task.

Nome Tipo Descrizione
name

string

Nome della variabile di ambiente.

value

string

Valore della variabile di ambiente.

ErrorMessage

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

Nome Tipo Descrizione
lang

string

Codice linguistico del messaggio di errore

value

string

Testo del messaggio.

HttpHeader

Coppia nome-valore intestazione HTTP

Nome Tipo Descrizione
name

string

Nome senza distinzione tra maiuscole e minuscole dell'intestazione da usare durante il caricamento dei file di output

value

string

Valore dell'intestazione da usare durante il caricamento dei file di output

ImageReference

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

Nome Tipo Descrizione
communityGalleryImageId

string

Identificatore univoco dell'immagine della raccolta community
Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta della community.

exactVersion

string

Versione specifica dell'immagine della piattaforma o dell'immagine del marketplace usata per creare il nodo. Questo campo di sola lettura è diverso da 'version' solo se il valore specificato per 'version' quando il pool è stato creato è stato 'latest'.

offer

string

Tipo di offerta dell'immagine marketplace di Macchine virtuali di Azure.
Ad esempio, UbuntuServer o WindowsServer.

publisher

string

Autore dell'immagine del Marketplace delle macchine virtuali di Azure.
Ad esempio, Canonical o MicrosoftWindowsServer.

sharedGalleryImageId

string

Identificatore univoco dell'immagine della raccolta condivisa
Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta condivisa.

sku

string

SKU dell'immagine del Marketplace delle macchine virtuali di Azure.
Ad esempio, 18.04-LTS o 2019-Datacenter.

version

string

Versione dell'immagine marketplace di Macchine virtuali di Azure.
È possibile specificare il valore 'latest' per selezionare la versione più recente di un'immagine. Se omesso, il valore predefinito è 'latest'.

virtualMachineImageId

string

Identificatore della risorsa ARM dell'immagine della raccolta di calcolo di Azure. I nodi di calcolo nel pool verranno creati usando questo ID immagine. Si tratta del formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} per l'impostazione predefinita alla versione più recente dell'immagine.
Questa proprietà si escludono a vicenda con altre proprietà ImageReference. L'immagine della raccolta di calcolo di Azure deve avere repliche nella stessa area e deve trovarsi nella stessa sottoscrizione dell'account Azure Batch. Se la versione dell'immagine non è specificata nell'imageId, verrà usata la versione più recente. Per informazioni sulle impostazioni del firewall per l'agente del nodo di calcolo Batch per comunicare con il servizio Batch, vedere https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Protocollo dell'endpoint.

Nome Tipo Descrizione
tcp

string

Usare TCP per l'endpoint.

udp

string

Usare UDP per l'endpoint.

InboundNATPool

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

Nome Tipo Descrizione
backendPort

integer

Numero di porta nel nodo di calcolo.
Deve essere univoco all'interno di un pool di Batch. I valori accettabili sono compresi tra 1 e 65535 ad eccezione di 22, 3389, 29876 e 29877, perché sono riservati. Se vengono forniti valori riservati, la richiesta ha esito negativo con codice di stato HTTP 400.

frontendPortRangeEnd

integer

Ultimo numero di porta nell'intervallo di porte esterne che verranno usate per fornire l'accesso in ingresso al back-endPort in singoli nodi di calcolo.
I valori accettabili sono compresi tra 1 e 65534 ad eccezione delle porte comprese tra 50000 e 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 77 caratteri. Se vengono forniti valori non validi, la richiesta ha esito negativo con codice di stato HTTP 400.

networkSecurityGroupRules

NetworkSecurityGroupRule[]

Elenco delle regole del gruppo di sicurezza di rete che verranno applicate all'endpoint.
Il numero massimo di regole che è possibile specificare in tutti gli endpoint in un pool di batch è 25. Se non vengono specificate regole del gruppo di sicurezza di rete, verrà creata una regola predefinita per consentire l'accesso in ingresso al back-endPort specificato. Se il numero massimo di regole del gruppo di sicurezza di rete viene superato, la richiesta ha esito negativo con codice di stato HTTP 400.

protocol

InboundEndpointProtocol

Protocollo dell'endpoint.

IPAddressProvisioningType

Tipo di provisioning per gli indirizzi IP pubblici per il pool.

Nome Tipo Descrizione
batchmanaged

string

Un indirizzo IP pubblico verrà creato e gestito da Batch. Possono essere presenti più indirizzi IP pubblici a seconda delle dimensioni del pool.

nopublicipaddresses

string

Non verrà creato alcun indirizzo IP pubblico.

usermanaged

string

Gli indirizzi IP pubblici vengono forniti dall'utente e verranno usati per effettuare il provisioning dei nodi di calcolo.

JobConstraints

Vincoli di esecuzione per un processo.

Nome Tipo Descrizione
maxTaskRetryCount

integer

Numero massimo di tentativi per ogni attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero.
Si noti che questo valore controlla in modo specifico il numero di tentativi. Il servizio Batch proverà ogni attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova un'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non riprova attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta attività senza limiti. 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 della terminazione sarà MaxWallClockTimeExpiry. Se questa proprietà non viene specificata, non è previsto alcun limite di tempo per quanto tempo può essere eseguito il processo.

JobManagerTask

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

Nome Tipo Descrizione
allowLowPriorityNode

boolean

Indica se l'attività di Gestione processi può essere eseguita in un nodo di calcolo spot/con priorità bassa.
Il valore predefinito è true.

applicationPackageReferences

ApplicationPackageReference[]

Elenco di pacchetti dell'applicazione che il servizio Batch distribuirà nel nodo di calcolo prima di eseguire la riga di comando.
I pacchetti dell'applicazione vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro attività. Pertanto, se un pacchetto dell'applicazione a cui si fa riferimento è già presente nel nodo di calcolo ed è aggiornato, non viene scaricato nuovamente; viene usata la copia esistente nel nodo di calcolo. Se non è possibile installare un pacchetto dell'applicazione a cui si fa riferimento, ad esempio perché il pacchetto è stato eliminato o perché il download non è riuscito, l'attività ha esito negativo.

authenticationTokenSettings

AuthenticationTokenSettings

Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch.
Se questa proprietà è impostata, il servizio Batch fornisce all'attività un token di autenticazione che può essere usato per autenticare le operazioni del servizio Batch senza richiedere una chiave di accesso dell'account. Il token viene fornito tramite la variabile di ambiente AZ_BATCH_AUTHENTICATION_TOKEN. Le operazioni che l'attività può eseguire usando il token dipendono dalle impostazioni. Ad esempio, un'attività può richiedere autorizzazioni di processo per aggiungere altre attività al processo o controllare lo stato del processo o di altre attività nel processo.

commandLine

string

Riga di comando dell'attività Gestione processi.
La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

constraints

TaskConstraints

Vincoli che si applicano all'attività Gestione processi.

containerSettings

TaskContainerSettings

Impostazioni per il contenitore in cui viene eseguita l'attività Gestione processi.
Se il pool che eseguirà questa attività ha impostato containerConfiguration, è necessario impostare anche questo valore. Se il pool che eseguirà questa attività non include containerConfiguration impostato, non deve essere impostato. Quando viene specificato questo parametro, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) nel contenitore, tutte le variabili di ambiente delle attività vengono mappate nel contenitore e la riga di comando Task viene eseguita nel contenitore. I file prodotti nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, ovvero le API di file batch non saranno in grado di accedere a tali file.

displayName

string

Nome visualizzato dell'attività Gestione processi.
Non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

environmentSettings

EnvironmentSetting[]

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

id

string

Stringa che identifica in modo univoco l'attività di Gestione processi all'interno del processo.
L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri.

killJobOnCompletion

boolean

Indica se il completamento dell'attività di Gestione processi indica il completamento dell'intero processo.
Se true, al termine dell'attività di Gestione processi, il servizio Batch contrassegna il processo come completato. Se le attività sono ancora in esecuzione in questo momento (diverse dalla versione del processo), tali attività vengono terminate. Se false, il completamento dell'attività di Gestione processi non influisce sullo stato del processo. In questo caso, è necessario usare l'attributo onAllTasksComplete per terminare il processo oppure terminare in modo esplicito un client o un utente. Un esempio è se Gestione processi crea un set di attività, ma non assume altro ruolo nell'esecuzione. Il valore predefinito è true. Se si usano gli attributi onAllTasksComplete e onTaskFailure per controllare la durata del processo e l'uso dell'attività di Gestione processi solo per creare le attività per il processo (non per monitorare lo stato di avanzamento), è importante impostare killJobOnCompletion su false.

outputFiles

OutputFile[]

Elenco di file che il servizio Batch caricherà dal nodo di calcolo dopo l'esecuzione della riga di comando.
Per le attività a istanze multiple, i file verranno caricati solo dal nodo di calcolo in cui viene eseguita l'attività primaria.

requiredSlots

integer

Numero di slot di pianificazione necessari per l'esecuzione dell'attività.
Il valore predefinito è 1. Un'attività può essere pianificata solo per l'esecuzione in un nodo di calcolo se il nodo dispone di slot di pianificazione gratuiti sufficienti. Per le attività a istanze multiple, questa proprietà non è supportata e non deve essere specificata.

resourceFiles

ResourceFile[]

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à. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker.

runExclusive

boolean

Indica se l'attività Job Manager richiede l'uso esclusivo del nodo di calcolo in cui viene eseguito.
Se true, nessun'altra attività verrà eseguita nello stesso nodo purché gestione processi sia in esecuzione. Se false, altre attività possono essere eseguite contemporaneamente con Gestione processi in un nodo di calcolo. L'attività di Gestione processi viene conteggiato normalmente rispetto al limite di attività simultanee del nodo di calcolo, quindi questo è rilevante solo se il nodo di calcolo consente più attività simultanee. Il valore predefinito è true.

userIdentity

UserIdentity

Identità utente con cui viene eseguita l'attività Gestione processi.
Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

JobNetworkConfiguration

Configurazione di rete per il processo.

Nome Tipo Descrizione
skipWithdrawFromVNet

boolean

Se ritirare i nodi di calcolo dalla rete virtuale in DNC quando il processo viene terminato o eliminato.
Se true, i nodi rimarranno aggiunti alla rete virtuale a DNC. Se false, i nodi verranno ritirati automaticamente al termine del processo. Il valore predefinito è false.

subnetId

string

Identificatore di risorsa ARM della subnet di rete virtuale a cui verranno aggiunti i nodi di calcolo che eseguono attività dal processo per la durata dell'attività.
La rete virtuale deve trovarsi nella stessa area e nella stessa sottoscrizione dell'account Azure Batch. La subnet specificata deve avere un numero sufficiente di indirizzi IP liberi per contenere il numero di nodi di calcolo che eseguiranno Attività dal processo. Può essere fino al numero di nodi di calcolo nel pool. L'entità servizio "MicrosoftAzureBatch" deve avere il ruolo "Collaboratore macchina virtuale classica" Role-Based controllo di accesso per la rete virtuale specificata in modo che il servizio Azure Batch possa pianificare le attività nei nodi. Questa operazione può essere verificata controllando se la rete virtuale specificata dispone di gruppi di sicurezza di rete (NSG) associati. Se la comunicazione con i nodi nella subnet specificata viene negata da un gruppo di sicurezza di rete, il servizio Batch imposta lo stato dei nodi di calcolo su inutilizzabile. Si tratta del formato /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Se la rete virtuale specificata dispone di gruppi di sicurezza di rete (NSG) 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. È necessaria anche la porta 443 per le connessioni in uscita per le comunicazioni con Archiviazione di Azure. Per altri dettagli, vedere: https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

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

Nome Tipo Descrizione
commandLine

string

Riga di comando dell'attività di preparazione del processo.
La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

constraints

TaskConstraints

Vincoli che si applicano all'attività di preparazione del processo.

containerSettings

TaskContainerSettings

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

environmentSettings

EnvironmentSetting[]

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

id

string

Stringa che identifica in modo univoco l'attività di preparazione del processo all'interno del processo.
L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri. Se non si specifica questa proprietà, il servizio Batch assegna un valore predefinito "jobpreparation". Nessun'altra attività nel processo può avere lo stesso ID dell'attività di preparazione del processo. Se si tenta di inviare un'attività con lo stesso ID, il servizio Batch rifiuta la richiesta con codice di errore TaskIdSameAsJobPreparationTask; se si chiama direttamente l'API REST, il codice di stato HTTP è 409 (conflitto).

rerunOnNodeRebootAfterSuccess

boolean

Indica se il servizio Batch deve eseguire nuovamente l'attività di preparazione del processo dopo il riavvio di un nodo di calcolo.
L'attività preparazione processo viene sempre rieseguita se viene ricreata l'immagine di un nodo di calcolo o se l'attività di preparazione del 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

ResourceFile[]

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à. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker.

userIdentity

UserIdentity

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

waitForSuccess

boolean

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

JobReleaseTask

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

Nome Tipo Descrizione
commandLine

string

Riga di comando dell'attività Rilascio processo.
La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

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

environmentSettings

EnvironmentSetting[]

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

id

string

Stringa che identifica in modo univoco l'attività di rilascio del processo all'interno del processo.
L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri. Se non si specifica questa proprietà, il servizio Batch assegna un valore predefinito "jobrelease". Nessun'altra attività nel processo può avere lo stesso ID dell'attività di rilascio del 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 durante il quale l'attività di rilascio del processo può essere eseguita in un determinato nodo di calcolo, misurata dal momento in cui viene avviata l'attività. Se l'attività non viene completata entro il limite di tempo, il servizio Batch lo termina. Il valore predefinito è 15 minuti. Non è possibile specificare un timeout più lungo di 15 minuti. In tal caso, il servizio Batch lo rifiuta con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

resourceFiles

ResourceFile[]

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

retentionTime

string

Tempo minimo per conservare la directory Attività per l'attività Rilascio processo nel nodo di calcolo. Dopo questo periodo, il servizio Batch può eliminare la directory Attività e tutto il relativo contenuto.
Il valore predefinito è 7 giorni, ad esempio la directory Attività verrà mantenuta per 7 giorni, a meno che il nodo di calcolo non venga rimosso o che il processo venga eliminato.

userIdentity

UserIdentity

Identità utente con cui viene eseguita l'attività Rilascio processo.
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.

Nome Tipo Descrizione
endTime

string

Ora di fine della pianificazione.
Questa proprietà viene impostata solo se la pianificazione del processo è nello stato completato.

nextRunTime

string

Alla successiva creazione di un processo in base a questa pianificazione.
Questa proprietà è significativa solo se la pianificazione è nello stato attivo quando arriva il momento. Ad esempio, se la pianificazione è disabilitata, non verrà creato alcun processo in nextRunTime, a meno che il processo non sia abilitato prima di allora.

recentJob

RecentJob

Informazioni sul processo più recente nella pianificazione dei processi.
Questa proprietà è presente solo se almeno un processo è stato eseguito in base alla pianificazione.

JobScheduleState

Stato della pianificazione del processo.

Nome Tipo Descrizione
active

string

La pianificazione processo è attiva e creerà i processi in base alla pianificazione.

completed

string

La pianificazione del processo è stata terminata, raggiungendo l'ora di fine o terminandola in modo esplicito 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 processo e eliminerà eventuali processi e attività esistenti nella pianificazione processo, incluso qualsiasi processo attivo. La pianificazione processo verrà eliminata quando sono stati eliminati tutti i processi e le attività nella pianificazione del processo.

disabled

string

L'utente ha disabilitato la pianificazione del processo. L'utilità di pianificazione non avvierà nuovi processi in questa pianificazione, ma qualsiasi processo attivo esistente continuerà a essere eseguito.

terminating

string

La pianificazione del processo non ha più lavoro da eseguire o è stata terminata in modo esplicito dall'utente, ma l'operazione di terminazione è ancora in corso. L'utilità di pianificazione non avvierà nuovi processi per questa pianificazione processo, né è attivo alcun processo esistente.

JobScheduleStatistics

Statistiche di utilizzo delle risorse per una pianificazione del processo.

Nome Tipo Descrizione
kernelCPUTime

string

Tempo totale cpu in modalità kernel (sommato tra tutti i core e tutti i nodi di calcolo) utilizzato da tutte le attività in tutti i processi creati in base alla pianificazione.

lastUpdateTime

string

Ora dell'ultimo aggiornamento delle statistiche. Tutte le statistiche sono limitate all'intervallo tra startTime e lastUpdateTime.

numFailedTasks

integer

Numero totale di attività non riuscite durante l'intervallo di tempo specificato in Processi creati in base alla pianificazione. Un'attività ha esito negativo se esaurisce il numero massimo di tentativi senza restituire il codice di uscita 0.

numSucceededTasks

integer

Numero totale di attività completate durante l'intervallo di tempo specificato in Processi creati in base alla pianificazione. Un'attività viene completata correttamente se restituisce il codice di uscita 0.

numTaskRetries

integer

Numero totale di tentativi durante l'intervallo di tempo specificato in tutte le attività in tutti i processi creati in base alla pianificazione.

readIOGiB

number

I gibibyte totali letti dal disco da tutte le attività in tutti i processi creati in base alla pianificazione.

readIOps

integer

Numero totale di operazioni di lettura su disco eseguite da tutte le attività in tutti i processi creati in base alla pianificazione.

startTime

string

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

url

string

URL delle statistiche.

userCPUTime

string

Tempo totale cpu in modalità utente (sommato in tutti i core e tutti i nodi di calcolo) utilizzato da tutte le attività in tutti i processi creati in base alla pianificazione.

waitTime

string

Tempo di attesa totale di tutte le attività in tutti i processi creati in base alla pianificazione. Il tempo di attesa per un'attività viene definito come tempo trascorso tra la creazione dell'attività e l'inizio dell'esecuzione dell'attività. Se l'attività viene ritentata a causa di errori, il tempo di attesa è l'ora dell'esecuzione più recente dell'attività.
Questo valore viene segnalato solo nelle statistiche sulla durata dell'account; non è incluso nelle statistiche del processo.

wallClockTime

string

Tempo totale di clock totale di tutte le attività in tutti i processi creati in base alla pianificazione.
Il tempo di tempo trascorso è il tempo trascorso da quando l'attività è stata avviata in esecuzione su 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 ritentata, questo include l'ora dell'orologio del muro di tutti i tentativi di attività.

writeIOGiB

number

I gibibyte totali scritti su disco da tutte le attività in tutti i processi creati in base alla pianificazione.

writeIOps

integer

Numero totale di operazioni di scrittura su disco eseguite da tutte le attività in tutti i processi creati in base alla pianificazione.

JobSpecification

Specifica i dettagli dei processi da creare in base a una pianificazione.

Nome Tipo Valore predefinito Descrizione
allowTaskPreemption

boolean

Indica se le attività in questo processo possono essere annullate da altri processi con priorità alta
Se il valore è impostato su True, altri processi con priorità alta inviati al sistema avranno la precedenza e saranno in grado di rieseguere le attività da questo processo. È possibile aggiornare allowTaskPreemption di un processo dopo che è stato creato usando l'API del processo di aggiornamento.

commonEnvironmentSettings

EnvironmentSetting[]

Elenco delle impostazioni comuni delle variabili di ambiente. Queste variabili di ambiente vengono impostate per tutte le attività in Processi creati in questa pianificazione (inclusi Gestione processi, 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 di impostazione con un valore diverso.

constraints

JobConstraints

Vincoli di esecuzione per i processi creati in questa pianificazione.

displayName

string

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

jobManagerTask

JobManagerTask

Dettagli di un'attività di Gestione processi da avviare quando un processo viene avviato in base a questa pianificazione.
Se il processo non specifica un'attività di Gestione processi, l'utente deve aggiungere in modo esplicito attività al processo usando l'API attività. Se il processo specifica un'attività di Gestione processi, il servizio Batch crea l'attività Gestione processi quando viene creato il processo e tenterà di pianificare l'attività di Gestione processi prima di pianificare altre attività nel processo.

jobPreparationTask

JobPreparationTask

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

jobReleaseTask

JobReleaseTask

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

maxParallelTasks

integer

-1

Numero massimo di attività che è possibile eseguire 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, ovvero non esiste alcun limite al numero di attività che possono essere eseguite contemporaneamente. È possibile aggiornare maxParallelTasks di un processo dopo che è stato creato usando l'API del processo di aggiornamento.

metadata

MetadataItem[]

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

networkConfiguration

JobNetworkConfiguration

Configurazione di rete per il processo.

onAllTasksComplete

OnAllTasksComplete

L'azione che il servizio Batch deve eseguire quando tutte le attività in un processo creato in questa pianificazione sono 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à di Gestione processi; Se si vuole usare la terminazione automatica dei processi senza Gestione processi, è necessario impostare inizialmente onAllTasksComplete su noaction e aggiornare le proprietà job per impostare onAllTasksComplete su terminatejob dopo aver completato l'aggiunta di Attività. Il valore predefinito è noaction.

onTaskFailure

OnTaskFailure

L'azione che il servizio Batch deve eseguire quando un'attività ha esito negativo in un processo creato in questa pianificazione. Un'attività viene considerata non riuscita se ha esito negativo se ha un valore failureInfo. Un failureInfo viene impostato se l'attività viene completata con un codice di uscita diverso da zero dopo aver esaurito il numero di tentativi oppure se si è verificato un errore durante l'avvio dell'attività, ad esempio a causa di un errore di download del file di risorse.
Il valore predefinito è noaction.

poolInfo

PoolInformation

Pool in cui il servizio Batch esegue le attività dei processi creati in base a questa pianificazione.

priority

integer

Priorità dei processi creati in base a questa pianificazione.
I valori di priorità possono variare da -1000 a 1000, con -1000 la priorità più bassa e 1000 come priorità più alta. Il valore predefinito è 0. Questa priorità viene usata come predefinita per tutti i processi nella pianificazione del processo. È possibile aggiornare la priorità di un processo dopo che è stata creata usando l'API processo di aggiornamento.

usesTaskDependencies

boolean

Indica se le attività nel processo possono definire le dipendenze l'una dall'altra. Il valore predefinito è false.

LinuxUserConfiguration

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

Nome Tipo Descrizione
gid

integer

ID gruppo per l'account utente.
Le proprietà uid e gid devono essere specificate insieme o non affatto. Se non specificato, il sistema operativo sottostante seleziona il gid.

sshPrivateKey

string

Chiave privata SSH per l'account utente.
La chiave privata non deve essere protetta da password. La chiave privata viene usata per configurare automaticamente l'autenticazione basata su chiave asimmetrica per SSH tra nodi di calcolo in un pool Linux quando la proprietà enableInterNodeCommunication del pool è true (viene ignorata se enableInterNodeCommunication è false). A tale scopo, posizionare la coppia di chiavi nella directory .ssh dell'utente. Se non specificato, SSH senza password non è configurato tra nodi di calcolo (non viene eseguita alcuna modifica della directory .ssh dell'utente).

uid

integer

ID utente dell'account utente.
Le proprietà uid e gid devono essere specificate insieme o non affatto. Se non specificato, il sistema operativo sottostante seleziona l'uid.

LoginMode

Modalità di accesso per l'utente

Nome Tipo Descrizione
batch

string

La LOGON32_LOGON_BATCH modalità di accesso Win32. La modalità di accesso batch è consigliata per i processi paralleli a esecuzione prolungata.

interactive

string

La LOGON32_LOGON_INTERACTIVE modalità di accesso Win32. Controllo dell'account utente è abilitato nei pool di Windows. Se questa opzione viene usata con un'identità utente con privilegi elevati in un pool di Windows, la sessione utente non verrà elevata a meno che l'applicazione eseguita dalla riga di comando Attività non sia configurata per richiedere sempre privilegi amministrativi o richiedere sempre privilegi massimi.

ManagedDisk

Nome Tipo Descrizione
securityProfile

VMDiskSecurityProfile

Specifica le impostazioni del profilo di sicurezza per il disco gestito.
Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostata solo per le macchine virtuali riservate e necessarie quando si usano macchine virtuali riservate.

storageAccountType

StorageAccountType

Tipo di account di archiviazione per il disco gestito.

MetadataItem

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

Nome Tipo Descrizione
name

string

Nome dell'elemento di metadati.

value

string

Valore dell'elemento di metadati.

MountConfiguration

File system da montare in ogni nodo.

Nome Tipo Descrizione
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

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

azureFileShareConfiguration

AzureFileShareConfiguration

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

cifsMountConfiguration

CIFSMountConfiguration

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

nfsMountConfiguration

NFSMountConfiguration

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

NetworkConfiguration

Configurazione di rete per un pool.

Nome Tipo Descrizione
dynamicVNetAssignmentScope

DynamicVNetAssignmentScope

Ambito dell'assegnazione dinamica della rete virtuale.

enableAcceleratedNetworking

boolean

Indica se il pool deve abilitare la rete accelerata.
La rete accelerata consente la virtualizzazione di I/O radice singola (SR-IOV) a una macchina virtuale, con un miglioramento delle prestazioni di rete. Per altri dettagli, vedere: https://video2.skills-academy.com/azure/virtual-network/accelerated-networking-overview.

endpointConfiguration

PoolEndpointConfiguration

Configurazione per gli endpoint nei nodi di calcolo nel pool di Batch.

publicIPAddressConfiguration

PublicIPAddressConfiguration

Configurazione IPAddress pubblica per i nodi di calcolo nel pool di batch.
Configurazione dell'indirizzo IP pubblico della configurazione di rete di un pool.

subnetId

string

Identificatore di risorsa ARM della subnet di rete virtuale a cui verranno aggiunti i nodi di calcolo del pool. Si tratta del formato /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.
La rete virtuale deve trovarsi nella stessa area e nella stessa sottoscrizione dell'account Azure Batch. La subnet specificata deve avere un numero sufficiente di indirizzi IP liberi per contenere il numero di nodi di calcolo nel pool. Se la subnet non dispone di un numero sufficiente di indirizzi IP gratuiti, 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 le attività nei nodi. Questa operazione può essere verificata controllando se la rete virtuale specificata dispone di gruppi di sicurezza di rete (NSG) associati. Se la comunicazione con i nodi nella subnet specificata viene negata da un gruppo di sicurezza di rete, il servizio Batch imposta lo stato dei nodi di calcolo su inutilizzabile. Sono supportate solo le reti virtuali ARM ('Microsoft.Network/virtualNetworks'). Se la rete virtuale specificata dispone di gruppi di sicurezza di rete (NSG) associati, è necessario abilitare alcune porte di sistema riservate per la comunicazione in ingresso. Abilitare le porte 29876 e 29877, nonché la porta 22 per Linux e la porta 3389 per Windows. Abilitare anche le connessioni in uscita ad Archiviazione di Azure sulla porta 443. Per altri dettagli, vedere: https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

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

Nome Tipo Descrizione
access

NetworkSecurityGroupRuleAccess

Azione da eseguire 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à. Minore è il numero maggiore della priorità. Ad esempio, è possibile specificare regole con numeri di ordine pari a 150, 250 e 350. La regola con il numero di ordine 150 ha la precedenza sulla regola con un ordine pari a 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), 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 con 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 altre voci (un intervallo o una singola porta). Se vengono forniti altri valori, la richiesta ha esito negativo con codice di stato HTTP 400. Il valore predefinito è ''.

NetworkSecurityGroupRuleAccess

Azione da eseguire per un indirizzo IP, un intervallo di subnet o un tag specificati.

Nome Tipo Descrizione
allow

string

Consentire l'accesso.

deny

string

Negare l'accesso.

NFSMountConfiguration

Informazioni utilizzate per connettersi a un file system NFS.

Nome Tipo Descrizione
mountOptions

string

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

relativeMountPath

string

Percorso relativo nel nodo di calcolo in cui verrà montato il file system
Tutti i file system vengono montati in relazione alla directory dei montaggi batch, accessibili tramite la variabile di ambiente AZ_BATCH_NODE_MOUNTS_DIR.

source

string

URI del file system da montare.

NodeCommunicationMode

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

Nome Tipo Descrizione
classic

string

I nodi che usano la modalità di comunicazione classica richiedono la comunicazione TCP in ingresso sulle porte 29876 e 29877 da "BatchNodeManagement. Tag del servizio {region}" e comunicazione TCP in uscita sulla porta 443 per "Storage.region" e "BatchNodeManagement. Tag del servizio {region}".

default

string

La modalità di comunicazione del nodo viene impostata automaticamente dal servizio Batch.

simplified

string

I nodi che usano la modalità di comunicazione semplificata richiedono la comunicazione TCP in uscita sulla porta 443 a "BatchNodeManagement. Tag del servizio {region}". Non sono necessarie porte in ingresso aperte.

NodePlacementConfiguration

Configurazione del posizionamento dei nodi per un pool.

Nome Tipo Descrizione
policy

NodePlacementPolicyType

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

NodePlacementPolicyType

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

Nome Tipo Descrizione
regional

string

Tutti i nodi nel pool verranno allocati nella stessa area.

zonal

string

I nodi nel pool verranno distribuiti in zone di disponibilità diverse con il bilanciamento ottimale.

OnAllTasksComplete

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

Nome Tipo Descrizione
noaction

string

Non fare nulla. Il processo rimane attivo a meno che non venga terminato o disabilitato da altri mezzi.

terminatejob

string

Terminare il processo. TerminateReason del processo è impostato su 'AllTasksComplete'.

OnTaskFailure

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

Nome Tipo Descrizione
noaction

string

Non fare nulla. 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 Task nell'insieme exitConditions dell'attività. Questo può comunque comportare l'esecuzione di alcuna azione, se questa è l'opzione specificata dall'attività.

OSDisk

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

Nome Tipo Descrizione
caching

CachingType

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: Nessuno, ReadOnly, ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
Il valore predefinito per la memorizzazione nella cache non è nessuno. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Dimensioni iniziali del disco in GB durante la creazione di un nuovo disco del sistema operativo.

ephemeralOSDiskSettings

DiffDiskSettings

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

managedDisk

ManagedDisk

Parametri del disco gestito.

writeAcceleratorEnabled

boolean

Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

OutputFile

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

Nome Tipo Descrizione
destination

OutputFileDestination

Destinazione dei file di output.

filePattern

string

Modello che indica quali file caricare.
Sono supportati entrambi i percorsi relativi e 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 il modello abc* corrisponde a abc o abcdef), ** corrisponde a qualsiasi directory, ? corrisponde a qualsiasi carattere singolo, [abc] corrisponde a un carattere tra parentesi quadre e [a-c] corrisponde a un carattere nell'intervallo. Le parentesi quadre possono includere una negazione che corrisponda 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 confrontato specificandolo in modo esplicito (ad esempio .gif non corrisponderà .a.gif, ma ..gif). Un semplice esempio:.txt corrisponde a qualsiasi file che non inizia in '.' e termina con .txt nella directory di lavoro attività o in qualsiasi sottodirectory. Se il nome file contiene un carattere jolly, può essere preceduto da caratteri di escape usando parentesi quadre (ad esempio abc[] corrisponde a un file denominato abc). Si noti che sia \ che / vengono considerati come separatori di directory in Windows, ma solo / è in Linux. Le variabili di ambiente (%var% in Windows o $var in Linux) vengono espanse prima dell'applicazione del modello.

uploadOptions

OutputFileUploadOptions

Opzioni aggiuntive per l'operazione di caricamento, incluse le condizioni per eseguire il caricamento.

OutputFileBlobContainerDestination

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

Nome Tipo Descrizione
containerUrl

string

URL del contenitore all'interno di Archiviazione BLOB di Azure in cui caricare i file.
Se non si usa un'identità gestita, l'URL deve includere una firma di accesso condiviso che concede le autorizzazioni di scrittura al contenitore.

identityReference

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere all'archiviazione BLOB di Azure specificata da containerUrl
L'identità deve avere accesso in scrittura al contenitore di Archiviazione BLOB di Azure

path

string

BLOB di destinazione o directory virtuale all'interno del contenitore di Archiviazione di Azure.
Se filePattern fa riferimento a un file specifico (ad esempio non contiene caratteri jolly), il percorso è il nome del BLOB in cui caricare il file. Se filePattern contiene uno o più caratteri jolly (e pertanto può corrispondere a più file), il percorso è il nome della directory virtuale BLOB (anteposto a ogni nome di BLOB) in cui caricare i file. Se omesso, i file vengono caricati nella radice del contenitore con un nome BLOB corrispondente al nome del file.

uploadHeaders

HttpHeader[]

Elenco di coppie nome-valore per le intestazioni da usare nel caricamento dei file di output
Queste intestazioni verranno specificate durante il caricamento di file in Archiviazione di Azure. Documento ufficiale sulle intestazioni consentite durante il caricamento di BLOB: https://docs.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Destinazione in cui caricare un file.

Nome Tipo Descrizione
container

OutputFileBlobContainerDestination

Percorso nell'archivio BLOB di Azure in cui vengono caricati i file.

OutputFileUploadCondition

Condizioni in base alle quali deve essere caricato un file di output attività o un set di file.

Nome Tipo Descrizione
taskcompletion

string

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

taskfailure

string

Caricare i file solo dopo che il processo attività viene chiuso con un codice di uscita diverso da zero.

tasksuccess

string

Caricare i file solo dopo la chiusura del processo attività con un codice di uscita pari a 0.

OutputFileUploadOptions

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

Nome Tipo Descrizione
uploadCondition

OutputFileUploadCondition

Condizioni in base alle quali deve essere caricato il file o il set di file di output dell'attività.
Il valore predefinito è taskcompletion.

PoolEndpointConfiguration

Configurazione dell'endpoint per un pool.

Nome Tipo Descrizione
inboundNATPools

InboundNATPool[]

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

PoolInformation

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

Nome Tipo Descrizione
autoPoolSpecification

AutoPoolSpecification

Caratteristiche per un "pool automatico" temporaneo. Il servizio Batch creerà questo pool automatico quando viene inviato il 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à errore di pianificazione del processo. Il servizio Batch gestisce la durata (sia la creazione che, a meno che keepAlive non sia specificato, eliminazione) del pool automatico. Tutte le azioni utente che influiscono sulla durata del pool automatico mentre il processo è attivo comporterà un comportamento imprevisto. È necessario specificare l'ID pool o la specifica del pool automatico, ma non entrambi.

poolId

string

ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.
È necessario assicurarsi che il pool a cui fa riferimento questa proprietà esista. Se il pool non esiste al momento in cui il servizio Batch tenta di pianificare un processo, nessuna attività per il processo verrà eseguita fino a quando non si crea un pool con tale ID. Si noti che il servizio Batch non rifiuterà la richiesta di processo; non eseguirà semplicemente attività finché il pool non esiste. È necessario specificare l'ID pool o la specifica del pool automatico, ma non entrambi.

PoolLifetimeOption

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

Nome Tipo Descrizione
job

string

Il pool esiste per la durata del processo a cui è dedicato. Il servizio Batch crea il pool quando crea il processo. Se l'opzione "processo" viene applicata a una pianificazione processo, il servizio Batch crea un nuovo pool automatico per ogni processo creato nella pianificazione.

jobschedule

string

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

PoolSpecification

Specifica per la creazione di un nuovo pool.

Nome Tipo Descrizione
applicationPackageReferences

ApplicationPackageReference[]

Elenco di pacchetti da installare in ogni nodo di calcolo nel pool.
Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto in un determinato pool.

autoScaleEvaluationInterval

string

Intervallo di tempo in cui modificare 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. È necessario se enableAutoScale è impostato su true. La formula viene verificata la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore.

certificateReferences

CertificateReference[]

Elenco di certificati da installare in ogni nodo di calcolo nel pool.
Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece 'estensione Azure KeyVault.

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, è necessario l'elemento autoScaleFormula. Il pool viene ridimensionato automaticamente in base alla formula. Il valore predefinito è false.

enableInterNodeCommunication

boolean

Indica se il pool consente la comunicazione diretta tra nodi di calcolo.
L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false.

metadata

MetadataItem[]

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

mountConfiguration

MountConfiguration[]

Elenco di file system da montare in ogni nodo del pool.
Supporta File di Azure, NFS, CIFS/SMB e Blobfuse.

networkConfiguration

NetworkConfiguration

Configurazione di rete per il pool.
Configurazione di rete per un pool.

resizeTimeout

string

Timeout per l'allocazione dei nodi di calcolo al pool.
Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch rifiuta la richiesta con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

resourceTags

object

Tag specificati dall'utente associati al pool.
Tag definiti dall'utente da associare al pool di Azure Batch. Se specificato, questi tag vengono propagati alle risorse di Azure di backup associate al pool. Questa proprietà può essere specificata solo quando l'account Batch è stato creato con la proprietà poolAllocationMode impostata su 'UserSubscription'.

startTask

StartTask

Un'attività da eseguire in ogni nodo di calcolo quando viene aggiunto al pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando il nodo di calcolo viene riavviato.
Batch ritenta attività quando viene attivata un'operazione di ripristino in un nodo. 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 dell'host. I tentativi dovuti alle operazioni di ripristino sono indipendenti da e non vengono conteggiati in base a maxTaskRetryCount. Anche se maxTaskRetryCount è 0, può verificarsi un nuovo tentativo interno a causa di un'operazione di ripristino. Per questo motivo, 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 di nuovo anche se il nodo di calcolo non è stato riavviato. Prestare particolare attenzione per evitare StartTasks che creano processi di interruzione o installano/avviano i servizi dalla directory di lavoro StartTask, in quanto questo impedisce a Batch di essere in grado di eseguire nuovamente StartTask.

targetDedicatedNodes

integer

Numero desiderato di nodi di calcolo dedicati nel pool.
Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

targetLowPriorityNodes

integer

Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool.
Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

targetNodeCommunicationMode

NodeCommunicationMode

Modalità di comunicazione del nodo desiderata per il pool.
Se omesso, il valore predefinito è Default.

taskSchedulingPolicy

TaskSchedulingPolicy

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

taskSlotsPerNode

integer

Numero di slot di attività che possono essere usati 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 di vmSize del pool o 256.

upgradePolicy

UpgradePolicy

Criteri di aggiornamento per il pool.
Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.

userAccounts

UserAccount[]

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

virtualMachineConfiguration

VirtualMachineConfiguration

Configurazione della macchina virtuale per il pool.
Questa proprietà deve essere specificata.

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 una dimensione di macchina virtuale per i nodi di calcolo in un pool di Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

PublicIPAddressConfiguration

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

Nome Tipo Descrizione
ipAddressIds

string[]

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

provision

IPAddressProvisioningType

Tipo di provisioning per gli indirizzi IP pubblici per il pool.
Il valore predefinito è BatchManaged.

RecentJob

Informazioni sul processo più recente da eseguire nella pianificazione del processo.

Nome Tipo Descrizione
id

string

ID del processo.

url

string

URL del processo.

ResourceFile

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

Nome Tipo Descrizione
autoStorageContainerName

string

Nome del contenitore di archiviazione nell'account di archiviazione automatico.
Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata.

blobPrefix

string

Prefisso BLOB da usare durante il download di BLOB da un contenitore di Archiviazione di Azure. Verranno scaricati solo i BLOB i cui nomi iniziano con il prefisso specificato.
La proprietà è valida solo quando si usa autoStorageContainerName o storageContainerUrl. Questo prefisso può essere un nome file parziale o una sottodirectory. Se non viene specificato un prefisso, verranno scaricati tutti i file nel contenitore.

fileMode

string

Attributo della modalità di autorizzazione file in formato ottale.
Questa proprietà si applica solo ai file scaricati nei nodi di calcolo Linux. Verrà ignorato se viene specificato per un oggetto resourceFile che verrà scaricato in un nodo di calcolo Windows. Se questa proprietà non viene specificata per un nodo di calcolo Linux, al file viene applicato il valore predefinito 0770.

filePath

string

Percorso nel nodo di calcolo in cui scaricare i file rispetto alla directory di lavoro dell'attività.
Se viene specificata la proprietà httpUrl, filePath è obbligatorio e descrive il percorso in cui verrà scaricato il file, incluso il nome file. In caso contrario, se si specifica la proprietà autoStorageContainerName o storageContainerUrl, filePath è facoltativo ed è la directory in cui scaricare i file. Nel caso in cui filePath venga usato come directory, qualsiasi struttura di directory già associata ai dati di input verrà mantenuta in modo completo e accodato alla directory filePath specificata. Il percorso relativo specificato non può uscire dalla directory di lavoro dell'attività, ad esempio tramite '..'.

httpUrl

string

URL del file da scaricare.
Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Se l'URL punta ad Archiviazione BLOB di Azure, deve essere leggibile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un BLOB nell'archiviazione di Azure: includere una firma di accesso condiviso (SAS) che concede le autorizzazioni di lettura per il BLOB, usare un'identità gestita con autorizzazione di lettura o impostare l'ACL per il BLOB o il relativo contenitore per consentire l'accesso pubblico.

identityReference

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere all'archiviazione BLOB di Azure specificata da storageContainerUrl o httpUrl
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

storageContainerUrl

string

URL del contenitore BLOB all'interno di Archiviazione BLOB di Azure.
Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Questo URL deve essere leggibile ed elencabile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un contenitore nell'archiviazione di Azure: includere una firma di accesso condiviso che concede autorizzazioni di lettura ed elenco per il contenitore, usare un'identità gestita con autorizzazioni di lettura ed elenco o impostare l'ACL per il contenitore per consentire l'accesso pubblico.

RollingUpgradePolicy

Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.

Nome Tipo Descrizione
enableCrossZoneUpgrade

boolean

Consentire al set di scalabilità di macchine virtuali di ignorare i limiti az durante la creazione di batch di aggiornamento. Prendere in considerazione il dominio di aggiornamento e maxBatchInstancePercent per determinare le dimensioni del batch. Questo campo può essere impostato su true o false solo quando si usa NodePlacementConfiguration come Zonal.

maxBatchInstancePercent

integer

Percentuale massima delle istanze totali di macchine virtuali che verranno aggiornate contemporaneamente dall'aggiornamento in sequenza in un unico batch. Poiché si tratta di un valore massimo, le istanze non integre nei batch precedenti o futuri possono causare la diminuzione della percentuale di istanze in un batch per garantire una maggiore affidabilità. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent.

maxUnhealthyInstancePercent

integer

Percentuale massima delle istanze totali della macchina virtuale nel set di scalabilità che possono essere contemporaneamente non integre, in seguito all'aggiornamento o rilevate in uno stato non integro dai controlli di integrità della macchina virtuale prima dell'interruzione dell'aggiornamento in sequenza. Questo vincolo verrà controllato prima di avviare qualsiasi batch. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent.

maxUnhealthyUpgradedInstancePercent

integer

Percentuale massima di istanze di macchina virtuale aggiornate che possono essere trovate in uno stato non integro. Questo controllo verrà eseguito dopo l'aggiornamento di ogni batch. Se questa percentuale viene mai superata, l'aggiornamento in sequenza viene interrotto. Il valore di questo campo deve essere compreso tra 0 e 100 inclusi.

pauseTimeBetweenBatches

string

Tempo di attesa tra il completamento dell'aggiornamento per tutte le macchine virtuali in un batch e l'avvio del batch successivo. La durata dell'ora deve essere specificata nel formato ISO 8601.

prioritizeUnhealthyInstances

boolean

Aggiornare tutte le istanze non integre in un set di scalabilità prima di qualsiasi istanza integra.

rollbackFailedInstancesOnPolicyBreach

boolean

Il rollback delle istanze non riuscite nel modello precedente se i criteri di aggiornamento in sequenza vengono violati.

Schedule

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

Nome Tipo Descrizione
doNotRunAfter

string

Ora dopo la quale non verrà creato alcun processo in questa pianificazione processo. La pianificazione passerà allo stato completato non appena questa scadenza è scaduta e non è presente alcun processo attivo in questa pianificazione processo.
Se non si specifica un'ora doNotRunAfter e si sta creando una pianificazione dei processi ricorrente, la pianificazione dei processi rimarrà attiva fino a quando non verrà terminata in modo esplicito.

doNotRunUntil

string

La prima volta in cui qualsiasi processo può essere creato in base alla pianificazione del processo.
Se non si specifica un'ora doNotRunUntil, la pianificazione diventa pronta per creare immediatamente i processi.

recurrenceInterval

string

Intervallo di tempo tra le ore di inizio di due processi successivi nella pianificazione del processo. Una pianificazione dei processi può avere al massimo un processo attivo in qualsiasi momento.
Poiché una pianificazione processo può avere al massimo un processo attivo in un determinato momento, se è il momento 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, in genere è consigliabile specificare un jobManagerTask nel processoSpecification. Se non si usa jobManagerTask, sarà necessario un processo esterno per monitorare quando vengono creati processi, aggiungere Attività ai processi e terminare i processi pronti per la ricorrenza successiva. L'impostazione predefinita è che la pianificazione non si verifica nuovamente: viene creato un processo, all'interno di startWindow dopo l'ora doNotRunUntil e la pianificazione viene completata non appena termina il processo. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

startWindow

string

Intervallo di tempo, a partire dal momento in cui la pianificazione indica che deve essere creato un processo, entro il quale deve essere creato un processo.
Se un processo non viene creato entro l'intervallo startWindow, la "opportunità" viene persa; nessun processo verrà creato fino alla successiva ricorrenza della pianificazione. Se la pianificazione è ricorrente e startWindow è più lungo dell'intervallo di ricorrenza, questo equivale a un oggetto startWindow infinito, perché il processo "dovuto" in una ricorrenzaInterval non viene portato avanti nell'intervallo di ricorrenza successivo. Il valore predefinito è infinito. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

SecurityEncryptionTypes

Specifica encryptionType del disco gestito. È impostato su VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostata solo per le macchine virtuali riservate ed è necessaria quando si usano macchine virtuali riservate.

Nome Tipo Descrizione
NonPersistedTPM

string

VMGuestStateOnly

string

SecurityProfile

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

Nome Tipo Descrizione
encryptionAtHost

boolean

Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Per altre informazioni sulla crittografia nei requisiti dell'host, vedere https://video2.skills-academy.com/azure/virtual-machines/disk-encryption#supported-vm-sizes.

securityType

SecurityTypes

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

uefiSettings

UefiSettings

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

SecurityTypes

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

Nome Tipo Descrizione
confidentialVM

string

Il confidential computing di Azure offre macchine virtuali riservate per i tenant con requisiti di sicurezza e riservatezza elevati. Queste macchine virtuali offrono un limite sicuro e imposto dall'hardware per soddisfare le esigenze di sicurezza. È possibile usare macchine virtuali riservate per le migrazioni senza apportare modifiche al codice, con la piattaforma che protegge lo stato della macchina virtuale dalla lettura o dalla modifica.

trustedLaunch

string

L'avvio attendibile protegge da tecniche di attacco avanzate e persistenti.

ServiceArtifactReference

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

Nome Tipo Descrizione
id

string

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

StartTask

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

Nome Tipo Descrizione
commandLine

string

Riga di comando di StartTask.
La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Impostazioni per il contenitore in cui viene eseguito StartTask.
Quando viene specificato questo parametro, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) nel contenitore, tutte le variabili di ambiente delle attività vengono mappate nel contenitore e la riga di comando Task viene eseguita nel contenitore. I file prodotti nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, ovvero le API di file batch non saranno in grado di accedere a tali file.

environmentSettings

EnvironmentSetting[]

Elenco delle impostazioni delle variabili di ambiente per StartTask.

maxTaskRetryCount

integer

Numero massimo di tentativi dell'attività.
Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla in modo specifico il numero di tentativi. Il servizio Batch proverà l'attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova l'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non ritenta l'attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta l'attività senza limite, ma non è consigliabile per un'attività di avvio o per qualsiasi attività. Il valore predefinito è 0 (nessun tentativo).

resourceFiles

ResourceFile[]

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

userIdentity

UserIdentity

Identità utente con cui viene eseguito StartTask.
Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

waitForSuccess

boolean

Indica se il servizio Batch deve attendere il completamento di StartTask( ovvero uscire con il codice di uscita 0) prima di pianificare qualsiasi attività nel nodo di calcolo.
Se true e StartTask non riesce in un nodo, il servizio Batch ritenta l'avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo inutilizzabile e non pianifica attività. Questa condizione può essere rilevata tramite lo stato del nodo di calcolo e i dettagli dell'errore. Se false, il servizio Batch non attenderà il completamento di StartTask. In questo caso, è possibile avviare l'esecuzione di altre attività nel nodo di calcolo mentre StartTask è ancora in esecuzione; e anche se StartTask ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true.

StorageAccountType

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

Nome Tipo Descrizione
premium_lrs

string

Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale Premium.

standard_lrs

string

Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale standard.

standardssd_lrs

string

Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale ssd standard.

TaskConstraints

Vincoli di esecuzione da applicare a un'attività.

Nome Tipo Descrizione
maxTaskRetryCount

integer

Numero massimo di tentativi dell'attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero.
Si noti che questo valore controlla in modo specifico il numero di tentativi per l'eseguibile task a causa di un codice di uscita diverso da zero. Il servizio Batch proverà l'attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova l'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non ritenta l'attività dopo il primo tentativo. 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).

maxWallClockTime

string

Tempo massimo trascorso che l'attività può essere eseguita, misurata dal momento in cui viene avviata l'attività. Se l'attività non viene completata entro il limite di tempo, il servizio Batch lo termina.
Se non viene specificato, non è previsto alcun limite di tempo per quanto tempo l'attività può essere eseguita.

retentionTime

string

Tempo minimo per conservare la directory Task nel nodo di calcolo in cui è stata eseguita, dal momento in cui viene completata l'esecuzione. Dopo questo periodo, il servizio Batch può eliminare la directory Attività e tutto il relativo contenuto.
Il valore predefinito è 7 giorni, ad esempio la directory Attività verrà mantenuta per 7 giorni, a meno che il nodo di calcolo non venga rimosso o che il processo venga eliminato.

TaskContainerSettings

Impostazioni del contenitore per un'attività.

Nome Tipo Descrizione
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

Percorsi da montare nell'attività contenitore.
Se questa matrice è null o non è presente, l'attività contenitore monta l'intera unità disco temporanea in Windows (o AZ_BATCH_NODE_ROOT_DIR in Linux). Se questa matrice è impostata come vuota, non verrà montato alcun percorso dati nel contenitore.

containerRunOptions

string

Opzioni aggiuntive per il comando create del contenitore.
Queste opzioni aggiuntive vengono fornite come argomenti al comando "docker create", oltre a quelli controllati dal servizio Batch.

imageName

string

Immagine da usare per creare il contenitore in cui verrà eseguita l'attività.
Si tratta del riferimento completo all'immagine, come specificato in "docker pull". Se non viene specificato alcun tag come parte del nome dell'immagine, il tag ":latest" viene usato come valore predefinito.

registry

ContainerRegistry

Registro privato che contiene l'immagine del contenitore.
Questa impostazione può essere omessa se è già stata specificata durante la creazione del pool.

workingDirectory

ContainerWorkingDirectory

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

TaskSchedulingPolicy

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

Nome Tipo Descrizione
nodeFillType

ComputeNodeFillType

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

UefiSettings

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

Nome Tipo Descrizione
secureBootEnabled

boolean

Specifica se l'avvio protetto deve essere abilitato nella macchina virtuale.

vTpmEnabled

boolean

Specifica se vTPM deve essere abilitato nella macchina virtuale.

UpgradeMode

Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità.

I valori possibili sono:

manuale: è possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade.

automatico: tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.

in sequenza: il set di scalabilità esegue gli aggiornamenti in batch con un tempo di pausa facoltativo tra di loro.

Nome Tipo Descrizione
automatic

string

Tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.

manual

string

È possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade.

rolling

string

Le istanze esistenti in un set di scalabilità vengono abbassate in batch da aggiornare. Al termine del batch aggiornato, le istanze inizieranno a riprendere il traffico e il batch successivo inizierà. Questo continua fino a quando tutte le istanze non hanno portato up-to-date.

UpgradePolicy

Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.

Nome Tipo Descrizione
automaticOSUpgradePolicy

AutomaticOSUpgradePolicy

Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.
Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.

mode

UpgradeMode

Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità.

I valori possibili sono:

manuale: è possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade.

automatico: tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.

in sequenza: il set di scalabilità esegue gli aggiornamenti in batch con un tempo di pausa facoltativo tra di loro.

rollingUpgradePolicy

RollingUpgradePolicy

Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.
Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.

UserAccount

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

Nome Tipo Descrizione
elevationLevel

ElevationLevel

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

linuxUserConfiguration

LinuxUserConfiguration

Configurazione utente specifica di Linux per l'account utente.
Questa proprietà viene ignorata se specificata in un pool di Windows. Se non specificato, l'utente viene creato con le opzioni predefinite.

name

string

Nome dell'account utente. I nomi possono contenere qualsiasi carattere Unicode fino a una lunghezza massima di 20.

password

string

Password per l'account utente.

windowsUserConfiguration

WindowsUserConfiguration

Configurazione utente specifica di Windows per l'account utente.
Questa proprietà può essere specificata solo se l'utente si trova in un pool di Windows. Se non specificato e in un pool di Windows, l'utente viene creato con le opzioni predefinite.

UserIdentity

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

Nome Tipo Descrizione
autoUser

AutoUserSpecification

Utente automatico con cui viene eseguita l'attività.
Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.

username

string

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

VirtualMachineConfiguration

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

Nome Tipo Descrizione
containerConfiguration

ContainerConfiguration

Configurazione del contenitore per il pool.
Se specificato, il programma di installazione viene eseguito in ogni nodo di calcolo nel pool per consentire l'esecuzione delle attività nei contenitori. Tutte le attività normali e di gestione processi eseguite in questo pool devono specificare la proprietà containerSettings e tutte le altre attività possono specificarla.

dataDisks

DataDisk[]

Configurazione per i dischi dati collegati ai nodi di calcolo nel pool.
Questa proprietà deve essere specificata se i nodi di calcolo nel pool devono avere dischi dati vuoti collegati. Non è possibile aggiornarlo. 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, vengono eliminati anche il disco e tutti i dati associati. Il disco non è formattato dopo essere stato collegato, deve essere formattato prima dell'uso. Per altre informazioni, vedere https://docs.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux e https://docs.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

diskEncryptionConfiguration

DiskEncryptionConfiguration

Configurazione della crittografia del disco per il pool.
Se specificato, la crittografia viene eseguita in ogni nodo del pool durante il provisioning dei nodi.

extensions

VMExtension[]

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

imageReference

ImageReference

Riferimento all'immagine del Marketplace delle macchine virtuali di Azure o all'immagine di macchina virtuale personalizzata da usare.

licenseType

string

Tipo di licenza locale da usare durante la distribuzione del sistema operativo.
Questo vale solo per le immagini che contengono il sistema operativo Windows e devono essere usate solo quando si contengono licenze locali valide per i nodi di calcolo che verranno distribuiti. Se omesso, non viene applicato alcun sconto sulle licenze locali. I valori sono:

Windows_Server: la licenza locale è per Windows Server. Windows_Client: la licenza locale è per il client Windows.

nodeAgentSKUId

string

SKU dell'agente del nodo di calcolo Batch di cui eseguire il provisioning nei nodi di calcolo nel pool.
L'agente del 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 implementazioni diverse dell'agente del nodo di calcolo, note come SKU, per sistemi operativi diversi. È necessario specificare uno SKU dell'agente del nodo di calcolo corrispondente al riferimento immagine selezionato. Per ottenere l'elenco degli SKU dell'agente del nodo di calcolo supportati insieme al relativo elenco di riferimenti alle immagini verificate, vedere l'operazione "Elenca gli SKU dell'agente del nodo di calcolo supportati".

nodePlacementConfiguration

NodePlacementConfiguration

Configurazione del posizionamento del nodo per il pool.
Questa configurazione specificherà le regole sulla modalità di allocazione fisica dei nodi nel pool.

osDisk

OSDisk

Impostazioni per il disco del sistema operativo della macchina virtuale.

securityProfile

SecurityProfile

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

serviceArtifactReference

ServiceArtifactReference

Specifica l'ID di riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'.
ID riferimento dell'artefatto del servizio sotto forma di /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

windowsConfiguration

WindowsConfiguration

Impostazioni del sistema operativo Windows nella macchina virtuale.
Questa proprietà non deve essere specificata se la proprietà imageReference specifica un'immagine del sistema operativo Linux.

VMDiskSecurityProfile

Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostata solo per le macchine virtuali riservate e necessarie quando si usano macchine virtuali riservate.

Nome Tipo Descrizione
securityEncryptionType

SecurityEncryptionTypes

Specifica encryptionType del disco gestito. È impostato su VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostata solo per le macchine virtuali riservate ed è necessaria quando si usano macchine virtuali riservate.

VMExtension

Configurazione per le estensioni della macchina virtuale.

Nome Tipo Descrizione
autoUpgradeMinorVersion

boolean

Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.

enableAutomaticUpgrade

boolean

Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.

name

string

Nome dell'estensione macchina virtuale.

protectedSettings

object

L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.

provisionAfterExtensions

string[]

Raccolta di nomi di estensione.
Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione.

publisher

string

Nome del server di pubblicazione del gestore dell'estensione.

settings

object

Impostazioni pubbliche in formato JSON per l'estensione.

type

string

Tipo dell'estensione.

typeHandlerVersion

string

Versione del gestore di script.

WindowsConfiguration

Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.

Nome Tipo Descrizione
enableAutomaticUpdates

boolean

Indica se gli aggiornamenti automatici sono abilitati nella macchina virtuale.
Se omesso, il valore predefinito è true.

WindowsUserConfiguration

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

Nome Tipo Descrizione
loginMode

LoginMode

Modalità di accesso per l'utente
Il valore predefinito è "batch".