Jobs - Create Job

Servizio:

Batch Service

Versione API:

2025-06-01

Crea un lavoro sull'account specificato.
Il servizio Batch supporta due modi per controllare il lavoro svolto come parte di un Lavoro. Nel primo approccio, l'utente specifica un Task del Job Manager. Il servizio batch avvia questo Task quando è pronto per iniziare il Job. Il Task del Job Manager controlla tutti gli altri Task che vengono eseguiti sotto questo Job, utilizzando le API del Task. Nel secondo approccio, l'utente controlla direttamente l'esecuzione dei Task sotto un Job attivo, utilizzando le API dei Task. Nota: quando si nominano i Job, evita di includere informazioni sensibili come nomi utente o progetti segreti. Queste informazioni possono essere visualizzate nei log di telemetria accessibili ai tecnici del supporto Tecnico Microsoft.

POST {endpoint}/jobs?api-version=2025-06-01

Con parametri facoltativi:

POST {endpoint}/jobs?api-version=2025-06-01&timeOut={timeOut}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Endpoint dell'account Batch (ad esempio: https://batchaccount.eastus2.batch.azure.com).
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
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 è superiore a 30, verrà utilizzato il valore predefinito.".

Intestazione della richiesta

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

Nome	Necessario	Tipo	Descrizione
client-request-id		string	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-rfc7231)	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.

Corpo della richiesta

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

Nome	Necessario	Tipo	Descrizione
id	True	string	Stringa che identifica in modo univoco il processo all'interno dell'account. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID all'interno di un account che differisce solo per caso.
poolInfo	True	BatchPoolInfo	Pool in cui il servizio Batch esegue le attività del processo.
allowTaskPreemption		boolean	Indica se le attività in questo processo possono essere annullate da altri processi con priorità alta. Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare l'assistenza Se il valore è impostato su True, gli altri processi ad alta priorità inviati al sistema avranno la precedenza e saranno in grado di rimettere in coda 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à del processo,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		BatchJobConstraints	Vincoli di esecuzione per il processo.
displayName		string	Nome visualizzato del processo. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
jobManagerTask		BatchJobManagerTask	Dettagli di un'attività di Gestione processi da avviare all'avvio del processo. Se il processo non specifica un'attività di Gestione processi, l'utente deve aggiungere in modo esplicito attività al processo. 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. Lo scopo tipico dell'attività di Gestione processi è controllare e/o monitorare l'esecuzione del processo, ad esempio decidendo quali attività aggiuntive eseguire, determinando quando il lavoro è completo e così via .Tuttavia, un'attività di Gestione processi non è limitata a queste attività, ovvero un'attività completamente completa nel sistema ed eseguire le azioni necessarie per il processo. Ad esempio, un'attività di Gestione processi potrebbe scaricare un file specificato come parametro, analizzare il contenuto del file e inviare attività aggiuntive in base a tali contenuti.
jobPreparationTask		BatchJobPreparationTask	Attività di preparazione del processo. 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		BatchJobReleaseTask	Attività Di rilascio 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 che hanno eseguito l'attività di preparazione del processo. Lo scopo principale dell'attività di rilascio del processo è annullare le modifiche apportate ai nodi di calcolo 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.
maxParallelTasks		integer (int32)	Numero massimo di attività che è possibile eseguire in parallelo per il processo. Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare il supporto tecnico) 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		BatchMetadataItem[]	Elenco di coppie nome-valore associate al processo come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
networkConfiguration		BatchJobNetworkConfiguration	Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare l'assistenza) La configurazione di rete per il processo.
onAllTasksComplete		BatchAllTasksCompleteMode	L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo 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		BatchTaskFailureMode	L'azione che il servizio Batch deve eseguire quando un'attività nel processo ha esito negativo. Un'attività viene considerata non riuscita 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.
priority		integer (int32)	Priorità del processo. 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.
usesTaskDependencies		boolean	Indica se le attività nel processo possono definire le dipendenze l'una dall'altra. Il valore predefinito è false.

Risposte

Nome	Tipo	Descrizione
201 Created		La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa. Intestazioni DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Risposta di errore imprevista.

Sicurezza

OAuth2Auth

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

Ambiti

Nome	Descrizione
https://batch.core.windows.net//.default

Esempio

Creates a basic job

Creates a complex job

Creates a basic job

Esempio di richiesta

HTTP

POST {endpoint}/jobs?api-version=2025-06-01



{
  "id": "jobId",
  "priority": 0,
  "poolInfo": {
    "poolId": "poolId"
  }
}

Risposta di esempio

Codice di stato:

201

Creates a complex job

Esempio di richiesta

HTTP

POST {endpoint}/jobs?api-version=2025-06-01



{
  "id": "jobId",
  "priority": 100,
  "constraints": {
    "maxWallClockTime": "PT1H",
    "maxTaskRetryCount": -1
  },
  "jobManagerTask": {
    "id": "taskId",
    "commandLine": "myprogram.exe",
    "resourceFiles": [
      {
        "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
        "filePath": "myprogram.exe"
      },
      {
        "storageContainerUrl": "http://mystorage1.blob.core.windows.net/data?sas",
        "filePath": "datafolder"
      }
    ],
    "environmentSettings": [
      {
        "name": "myvariable",
        "value": "myvalue"
      }
    ],
    "constraints": {
      "maxWallClockTime": "PT1H",
      "maxTaskRetryCount": 0,
      "retentionTime": "PT1H"
    },
    "requiredSlots": 2,
    "killJobOnCompletion": false,
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "admin"
      }
    },
    "runExclusive": true
  },
  "poolInfo": {
    "autoPoolSpecification": {
      "autoPoolIdPrefix": "mypool",
      "poolLifetimeOption": "job",
      "pool": {
        "vmSize": "Standard_D2ds_v5",
        "virtualMachineConfiguration": {
          "imageReference": {
            "publisher": "MicrosoftWindowsServer",
            "offer": "WindowsServer",
            "sku": "2025-datacenter-smalldisk",
            "version": "latest"
          },
          "nodeAgentSKUId": "batch.node.windows amd64",
          "windowsConfiguration": {
            "enableAutomaticUpdates": false
          },
          "nodePlacementConfiguration": {
            "policy": "zonal"
          }
        },
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 3,
        "targetLowPriorityNodes": 0,
        "taskSlotsPerNode": 2,
        "taskSchedulingPolicy": {
          "nodeFillType": "spread"
        },
        "enableAutoScale": false,
        "enableInterNodeCommunication": true,
        "startTask": {
          "commandLine": "myprogram2.exe",
          "resourceFiles": [
            {
              "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram2.exe?sas",
              "filePath": "myprogram2.exe"
            }
          ],
          "environmentSettings": [
            {
              "name": "myvariable",
              "value": "myvalue"
            }
          ],
          "userIdentity": {
            "autoUser": {
              "scope": "task",
              "elevationLevel": "admin"
            }
          },
          "maxTaskRetryCount": 2,
          "waitForSuccess": true
        },
        "metadata": [
          {
            "name": "myproperty",
            "value": "myvalue"
          }
        ]
      }
    }
  },
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Risposta di esempio

Codice di stato:

201

Definizioni

Nome	Descrizione
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.
AutoUserScope	Enum AutoUserScope
AutoUserSpecification	Specifica le opzioni per l'utente automatico che esegue un'attività di Azure 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.
BatchAccessScope	Enum BatchAccessScope
BatchAllTasksCompleteMode	L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo sono nello stato completato.
BatchApplicationPackageReference	Riferimento a un pacchetto da distribuire nei nodi di calcolo.
BatchAutoPoolSpecification	Specifica le caratteristiche di un "pool automatico" temporaneo. Il servizio Batch creerà questo pool automatico quando viene inviato il processo.
BatchContainerConfiguration	Configurazione per i pool abilitati per i contenitori.
BatchDiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal nodo di calcolo (VM).
BatchError	Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail	Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
BatchErrorMessage	Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
BatchInboundNatPool	Pool NAT in ingresso che può essere usato per gestire porte specifiche nei nodi di calcolo in un pool di Batch esternamente.
BatchJobConstraints	Vincoli di esecuzione per un processo.
BatchJobCreateOptions	Parametri per la creazione di un processo di Azure Batch.
BatchJobDefaultOrder	Enum di BatchJobDefaultOrder
BatchJobManagerTask	Specifica i dettagli di un'attività di Gestione processi. L'attività Gestione processi viene avviata automaticamente al momento della creazione del processo. Il servizio Batch tenta di pianificare l'attività di Gestione processi prima di qualsiasi altra attività nel processo. Quando si riduce un pool, il servizio Batch tenta di mantenere i nodi in cui le attività di Gestione processi vengono eseguite il più a lungo possibile, ovvero i nodi di calcolo che eseguono attività "normali" vengono rimossi prima che i nodi di calcolo eseguano attività di Gestione processi. Quando un'attività di Gestione processi ha esito negativo e deve essere riavviata, il sistema tenta di pianificarlo con la priorità più alta. Se non sono disponibili nodi di calcolo inattivi, il sistema può terminare una delle attività in esecuzione nel pool e restituirla alla coda per fare spazio al riavvio dell'attività di Gestione processi. Si noti che un'attività di Gestione processi in un processo non ha la priorità su Attività in altri processi. In Tutti i processi vengono osservate solo le priorità a livello di lavoro. Ad esempio, se è necessario riavviare un processo con priorità 0 in un processo con priorità 0, le attività di un processo con priorità 1 non verranno spostate. 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.
BatchJobNetworkConfiguration	Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare l'assistenza) La configurazione di rete per il processo.
BatchJobPreparationTask	Un'attività di preparazione processo da eseguire prima di qualsiasi attività del processo in qualsiasi nodo di calcolo specificato. È possibile usare Preparazione processo per preparare un nodo per eseguire attività per il processo. Le attività comunemente eseguite nella preparazione dei processi includono: il download di file di risorse comuni usati da tutte le attività nel processo. L'attività preparazione processo può scaricare questi file di risorse comuni nel percorso condiviso nel nodo. (AZ_BATCH_NODE_ROOT_DIR\shared) o l'avvio di un servizio locale nel nodo in modo che tutte le attività di tale processo possano comunicare con esso. Se l'attività di preparazione del processo ha esito negativo, ovvero esaurisce il numero di tentativi prima di uscire con il codice di uscita 0, Batch non eseguirà Attività di questo processo nel nodo. Il nodo di calcolo rimane ineleggibile per eseguire attività di questo processo fino a quando non viene ricreata l'immagine. Il nodo di calcolo rimane attivo e può essere usato per altri processi. L'attività di preparazione del processo può essere eseguita più volte nello stesso nodo. Pertanto, è necessario scrivere l'attività preparazione processo per gestire la riesezione. Se il nodo viene riavviato, l'attività di preparazione processo viene nuovamente eseguita nel nodo di calcolo prima di pianificare qualsiasi altra attività del processo, se rerunOnNodeRebootAfterSuccess è true o se l'attività di preparazione del processo non è stata completata in precedenza. Se il nodo viene ricreato l'immagine, l'attività di preparazione processo viene eseguita di nuovo prima di pianificare un'attività del processo. 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.
BatchJobReleaseTask	Un'attività di rilascio del processo da eseguire al completamento del processo in qualsiasi nodo di calcolo in cui è stato eseguito il processo. L'attività Di rilascio processo viene eseguita al termine del processo, a causa di una delle operazioni seguenti: l'utente chiama l'API Termina processo o l'API Elimina processo mentre il processo è ancora attivo, viene raggiunto il vincolo di tempo massimo di tempo del processo e processo è ancora attivo oppure l'attività Di gestione processi completata e il processo viene configurato per terminare al termine del processo. L'attività di rilascio processo viene eseguita in ogni nodo in cui sono state eseguite le attività del processo e l'attività di preparazione del processo è stata eseguita e completata. Se si ricrea l'immagine di un nodo dopo l'esecuzione dell'attività di preparazione del processo e il processo termina senza altre attività del processo in esecuzione su tale nodo (e di conseguenza l'attività preparazione processo non viene rieseguita), l'attività di rilascio del processo non viene eseguita in tale nodo di calcolo. Se un nodo viene riavviato mentre l'attività di rilascio del processo è ancora in esecuzione, l'attività di rilascio del processo viene eseguita di nuovo all'avvio del nodo di calcolo. Il processo non viene contrassegnato come completato fino al completamento di tutte le attività di rilascio del processo. L'attività Di rilascio processo viene eseguita in background. Non occupa uno slot di pianificazione; ovvero, non viene conteggiato per il limite taskSlotsPerNode specificato nel pool.
BatchMetadataItem	Il servizio Batch non assegna alcun significato a questi metadati; è esclusivamente per l'uso del codice utente.
BatchNodeFillType	Enum BatchNodeFillType
BatchNodeIdentityReference	Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
BatchNodePlacementConfiguration	Per il posizionamento a livello di area, i nodi nel pool verranno allocati nella stessa area. Per il posizionamento a livello di zona, i nodi nel pool verranno distribuiti in diverse zone con il bilanciamento del carico ottimale.
BatchNodePlacementPolicyType	Enum BatchNodePlacementPolicyType.
BatchOsDisk	Impostazioni per il disco del sistema operativo del nodo di calcolo (VM).
BatchPoolEndpointConfiguration	Configurazione dell'endpoint per un pool.
BatchPoolIdentityReference	Riferimento di una delle identità del pool per crittografare il disco. Questa identità verrà usata per accedere all'insieme di credenziali delle chiavi.
BatchPoolInfo	Specifica la modalità di assegnazione di un processo a un pool.
BatchPoolLifetimeOption	Enum di BatchPoolLifetimeOption
BatchPoolSpecification	Specifica per la creazione di un nuovo pool.
BatchPublicIpAddressConfiguration	Configurazione dell'indirizzo IP pubblico della configurazione di rete di un pool.
BatchStartTask	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.
BatchTaskConstraints	Vincoli di esecuzione da applicare a un'attività.
BatchTaskContainerSettings	Impostazioni del contenitore per un'attività.
BatchTaskFailureMode	Enum TaskFailure
BatchTaskSchedulingPolicy	Specifica la modalità di distribuzione delle attività tra i nodi di calcolo.
BatchUefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale.
BatchVmDiskSecurityProfile	Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate ed è necessario quando si utilizzano macchine virtuali riservate.
BatchVmImageReference	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".
CachingType	Enum CachingType
CifsMountConfiguration	Informazioni utilizzate per connettersi a un file system CIFS.
ContainerHostBatchBindMountEntry	Voce di percorso e modalità di montaggio da montare nel contenitore di attività.
ContainerHostDataPath	Percorsi che verranno montati nel contenitore dell'attività contenitore.
ContainerRegistryReference	Registro contenitori privato.
ContainerType	Enum ContainerType
ContainerWorkingDirectory	ContainerWorkingDirectory enums
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 la posizione effimera del disco del sistema operativo per tutti i nodi di calcolo (VM) nel pool. Questa proprietà può essere utilizzata dall'utente nella richiesta per scegliere il percorso in cui deve trovarsi il sistema operativo. ad esempio, spazio su disco della cache per il provisioning dei dischi del sistema operativo temporaneo. Per maggiori informazioni sui requisiti di dimensione del disco di Ephemeral OS, si prega di consultare i requisiti di dimensione del disco di Ephemeral OS per le VM Windows in https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e le VM Linux in https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements
DiskCustomerManagedKey	Riferimento alla chiave gestita dal cliente per crittografare il disco.
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.
DiskEncryptionSetParameters	ID risorsa ARM del set di crittografia del disco.
DiskEncryptionTarget	Enums DiskEncryptionTarget
DynamicVNetAssignmentScope	DynamicVNetAssignmentScope enums
ElevationLevel	Enum di ElevationLevel
EnvironmentSetting	Variabile di ambiente da impostare in un processo task.
HostEndpointSettings	Specifica determinate impostazioni dell'endpoint host.
HostEndpointSettingsModeTypes	HostEndpointSettingsModeTypes enums
InboundEndpointProtocol	InboundEndpointProtocol enums
IpAddressProvisioningType	IPAddressProvisioningType enums
IPFamily	Le famiglie di IP utilizzate per specificare le versioni IP disponibili per il pool.
IPTag	Contiene il tag IP associato all'indirizzo IP pubblico.
LinuxUserConfiguration	Proprietà usate per creare un account utente in un nodo di calcolo Linux.
LoginMode	Enum LoginMode
ManagedDisk	Parametri del disco gestito.
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	NetworkSecurityGroupRuleAccess enums
NfsMountConfiguration	Informazioni utilizzate per connettersi a un file system NFS.
OutputFile	In ogni caricamento di file, il servizio Batch scrive due file di log nel nodo di calcolo, 'fileuploadout.txt' e 'fileuploaderr.txt'. Questi file di log vengono usati per altre informazioni su un errore specifico.
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	OutputFileUploadCondition enums
OutputFileUploadConfig	Opzioni per un'operazione di caricamento del file di output, incluse le condizioni per eseguire il caricamento.
OutputFileUploadHeader	Coppia nome-valore intestazione HTTP
ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale.
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.
SecurityEncryptionTypes	Enums SecurityEncryptionTypes
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'.
StorageAccountType	Enumerazioni StorageAccountType
UpgradeMode	Enum UpgradeMode
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à. Specificare la proprietà userName o autoUser, ma non entrambe.
VirtualMachineConfiguration	Configurazione per i nodi di calcolo in un pool basato sull'infrastruttura di macchine virtuali di Azure.
VMExtension	Configurazione per le estensioni della macchina virtuale.
WindowsConfiguration	Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.
WindowsUserConfiguration	Proprietà usate per creare un account utente in un nodo di calcolo Windows.

AuthenticationTokenSettings

Oggetto

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

Nome	Tipo	Descrizione
access	BatchAccessScope[]	Le risorse batch a cui il token concede accesso. Il token di autenticazione concede l'accesso a un insieme limitato di operazioni di servizio Batch. Attualmente l'unico valore supportato per la proprietà di accesso è 'job', che concede l'accesso a tutte le operazioni relative al Job che contiene il Task.

AutomaticOsUpgradePolicy

Oggetto

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.

AutoUserScope

Enumerazione

Enum AutoUserScope

Valore	Descrizione
task	Specifica che il servizio dovrebbe creare un nuovo utente per il Task.
pool	Specifica che il Task viene eseguito come il comune account utente automatico creato su ogni Nodo di Calcolo in un Pool.

AutoUserSpecification

Oggetto

Specifica le opzioni per l'utente automatico che esegue un'attività di Azure Batch.

Nome	Tipo	Descrizione
elevationLevel	ElevationLevel	Livello di elevazione dell'utente automatico. Il valore predefinito è nonAdmin.
scope	AutoUserScope	Ambito dell'utente automatico. Il valore predefinito è pool. Se il pool esegue Windows, è necessario specificare il valore Task se è necessario un isolamento più rigoroso tra le attività. Ad esempio, se l'attività modifica il Registro di sistema in un modo che potrebbe influire su altre attività.

AzureBlobFileSystemConfiguration

Oggetto

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

Nome	Tipo	Descrizione
accountKey	string (password)	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	Il 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	BatchNodeIdentityReference	Il riferimento all'identità assegnata dall'utente da utilizzare per accedere a ContainerName. Questa proprietà si escludono a vicenda sia con accountKey che con sasKey; deve essere specificato esattamente uno.
relativeMountPath	string	Il percorso relativo sul nodo di calcolo dove sarà 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 (password)	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

Oggetto

Informazioni usate per connettersi a una condivisione file di Azure.

Nome	Tipo	Descrizione
accountKey	string (password)	Chiave dell'account di archiviazione di Azure.
accountName	string	Nome dell'account di archiviazione di Azure.
azureFileUrl	string (uri)	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	Il percorso relativo sul nodo di calcolo dove sarà 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.

BatchAccessScope

Enumerazione

Enum BatchAccessScope

Valore	Descrizione
job	Concede l'accesso per eseguire tutte le operazioni sul Lavoro che contiene il Compito.

BatchAllTasksCompleteMode

Enumerazione

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

Valore	Descrizione
noaction	Non eseguire alcuna operazione. Il lavoro rimane attivo a meno che non venga licenziato o disabilitato in qualche altro modo.
terminatejob	Rinunciare al lavoro. Il motivo di terminazione del lavoro è impostato su 'TuttiCompitiCompletati'.

BatchApplicationPackageReference

Oggetto

Riferimento a un pacchetto da distribuire nei nodi di calcolo.

Nome	Tipo	Descrizione
applicationId	string	L'ID dell'applicazione da distribuire. Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
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 una versione predefinita per questa applicazione, la richiesta fallisce con il codice di errore InvalidApplicationPackageReferences e il codice di stato HTTP 409. Se questo viene omesso in un Task e non è specificata una versione predefinita per questa applicazione, il Task fallisce con un errore di pre-elaborazione.

BatchAutoPoolSpecification

Oggetto

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	Un prefisso da aggiungere all'identificatore unico quando viene creato automaticamente un Pool. Il servizio Batch assegna a ogni auto Pool un identificatore unico alla creazione. Per distinguere tra Pool creati per scopi diversi, puoi specificare questo elemento per aggiungere un prefisso all'ID assegnato. Il prefisso può essere lungo fino a 20 caratteri.
keepAlive	boolean	Se mantenere vivo un auto pool dopo la scadenza della sua vita. Se falso, il servizio Batch elimina il Pool una volta scaduto la sua vita (come determinato dall'impostazione poolLifetimeOption); cioè, quando il Lavoro o il Programma di Lavoro si completa. Se è vero, il servizio Batch non elimina automaticamente il Pool. Spetta all'utente eliminare gli auto pool creati con questa opzione.
pool	BatchPoolSpecification	La specifica del pool per l'auto pool.
poolLifetimeOption	BatchPoolLifetimeOption	La durata minima di vita degli auto pool creati e come più lavori in una tabella di lavoro vengono assegnati ai pool.

BatchContainerConfiguration

Oggetto

Configurazione per i pool abilitati per i contenitori.

Nome	Tipo	Descrizione
containerImageNames	string[]	La raccolta dei nomi delle immagini dei contenitori. Questa è la referenza completa all'Image, come specificato per "docker pull". Un'immagine sarà proveniente dal registro Docker predefinito a meno che l'immagine non sia pienamente qualificata con un registro alternativo.
containerRegistries	ContainerRegistryReference[]	Registri privati aggiuntivi da cui è possibile eseguire il pull dei contenitori. Se devono essere scaricate immagini da un registro privato che richiede credenziali, allora tali credenziali devono essere fornite qui.
type	ContainerType	Tecnologia contenitore da usare.

BatchDiffDiskSettings

Oggetto

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://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e macchine virtuali Linux all'indirizzo https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

BatchError

Oggetto

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

Oggetto

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.

BatchErrorMessage

Oggetto

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

Nome	Tipo	Descrizione
lang	string	Il codice linguistico del messaggio di errore.
value	string	Testo del messaggio.

BatchInboundNatPool

Oggetto

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 (int32)	Il numero di porta sul Nodo di Calcolo. Questo deve essere unico all'interno di un Batch Pool. I valori accettabili sono compresi tra 1 e 65535 ad eccezione del 29876 e del 29877, perché sono riservati. Se vengono forniti valori riservati, la richiesta ha esito negativo con codice di stato HTTP 400.
frontendPortRangeEnd	integer (int32)	L'ultimo numero di porta nell'intervallo delle porte esterne che saranno utilizzate per fornire accesso in entrata al backendPort sui 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 i range all'interno di un Pool devono essere distinti e non possono sovrapporsi. Ogni gamma 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 (int32)	Il primo numero di porta nell'intervallo delle porte esterne che saranno usate per fornire accesso in entrata al backendPort sui singoli nodi di calcolo. I valori accettabili sono compresi tra 1 e 65534, ad eccezione delle porte da 50000 a 55000 riservate. Tutti i range all'interno di un Pool devono essere distinti e non possono sovrapporsi. Ogni gamma 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 unico all'interno di un Batch Pool, può contenere lettere, numeri, sottoline, 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 possono essere specificate su tutti gli endpoint di un Batch Pool è 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.

BatchJobConstraints

Oggetto

Vincoli di esecuzione per un processo.

Nome	Tipo	Descrizione
maxTaskRetryCount	integer (int32)	Il numero massimo di volte per ogni Compito può essere ripetuto. 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 Task una volta e potrà poi riprovare fino a questo limite. Ad esempio, se il conteggio massimo dei ritentativi è 3, il Batch tenta un compito fino a 4 volte (un primo tentativo e 3 tentativi). Se il conteggio massimo dei tentativi è 0, il servizio Batch non ritenta Task. Se il conteggio massimo dei ritenti è -1, il servizio batch riprova Task senza limite. Il valore predefinito è 0 (nessun tentativo).
maxWallClockTime	string (duration)	Il tempo massimo trascorso che il Job può eseguire, misurato dal momento in cui il Job viene creato. Se il Job non viene completato entro il limite di tempo, il servizio Batch lo termina insieme a eventuali Task ancora in esecuzione. In questo caso, la motivazione della cessazione sarà MaxWallClockTimeExpiry. Se questa proprietà non è specificata, non c'è limite di tempo su quanto tempo il Lavoro può durare.

BatchJobCreateOptions

Oggetto

Parametri per la creazione di un processo di Azure Batch.

Nome	Tipo	Valore predefinito	Descrizione
allowTaskPreemption	boolean		Indica se le attività in questo processo possono essere annullate da altri processi con priorità alta. Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare l'assistenza Se il valore è impostato su True, gli altri processi ad alta priorità inviati al sistema avranno la precedenza e saranno in grado di rimettere in coda 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à del processo,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	BatchJobConstraints		Vincoli di esecuzione per il processo.
displayName	string		Nome visualizzato del processo. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
id	string		Stringa che identifica in modo univoco il processo all'interno dell'account. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID all'interno di un account che differisce solo per caso.
jobManagerTask	BatchJobManagerTask		Dettagli di un'attività di Gestione processi da avviare all'avvio del processo. Se il processo non specifica un'attività di Gestione processi, l'utente deve aggiungere in modo esplicito attività al processo. 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. Lo scopo tipico dell'attività di Gestione processi è controllare e/o monitorare l'esecuzione del processo, ad esempio decidendo quali attività aggiuntive eseguire, determinando quando il lavoro è completo e così via .Tuttavia, un'attività di Gestione processi non è limitata a queste attività, ovvero un'attività completamente completa nel sistema ed eseguire le azioni necessarie per il processo. Ad esempio, un'attività di Gestione processi potrebbe scaricare un file specificato come parametro, analizzare il contenuto del file e inviare attività aggiuntive in base a tali contenuti.
jobPreparationTask	BatchJobPreparationTask		Attività di preparazione del processo. 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	BatchJobReleaseTask		Attività Di rilascio 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 che hanno eseguito l'attività di preparazione del processo. Lo scopo principale dell'attività di rilascio del processo è annullare le modifiche apportate ai nodi di calcolo 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.
maxParallelTasks	integer (int32)	-1	Numero massimo di attività che è possibile eseguire in parallelo per il processo. Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare il supporto tecnico) 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	BatchMetadataItem[]		Elenco di coppie nome-valore associate al processo come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
networkConfiguration	BatchJobNetworkConfiguration		Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare l'assistenza) La configurazione di rete per il processo.
onAllTasksComplete	BatchAllTasksCompleteMode		L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo 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	BatchTaskFailureMode		L'azione che il servizio Batch deve eseguire quando un'attività nel processo ha esito negativo. Un'attività viene considerata non riuscita 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	BatchPoolInfo		Pool in cui il servizio Batch esegue le attività del processo.
priority	integer (int32)		Priorità del processo. 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.
usesTaskDependencies	boolean		Indica se le attività nel processo possono definire le dipendenze l'una dall'altra. Il valore predefinito è false.

BatchJobDefaultOrder

Enumerazione

Enum di BatchJobDefaultOrder

Valore	Descrizione
none	Le attività dovrebbero essere programmate uniformemente da tutti i lavori di uguale priorità per il pool.
creationtime	Se i lavori hanno la stessa priorità, i compiti di lavori creati in precedenza dovrebbero essere programmati per primi.

BatchJobManagerTask

Oggetto

Specifica i dettagli di un'attività di Gestione processi. L'attività Gestione processi viene avviata automaticamente al momento della creazione del processo. Il servizio Batch tenta di pianificare l'attività di Gestione processi prima di qualsiasi altra attività nel processo. Quando si riduce un pool, il servizio Batch tenta di mantenere i nodi in cui le attività di Gestione processi vengono eseguite il più a lungo possibile, ovvero i nodi di calcolo che eseguono attività "normali" vengono rimossi prima che i nodi di calcolo eseguano attività di Gestione processi. Quando un'attività di Gestione processi ha esito negativo e deve essere riavviata, il sistema tenta di pianificarlo con la priorità più alta. Se non sono disponibili nodi di calcolo inattivi, il sistema può terminare una delle attività in esecuzione nel pool e restituirla alla coda per fare spazio al riavvio dell'attività di Gestione processi. Si noti che un'attività di Gestione processi in un processo non ha la priorità su Attività in altri processi. In Tutti i processi vengono osservate solo le priorità a livello di lavoro. Ad esempio, se è necessario riavviare un processo con priorità 0 in un processo con priorità 0, le attività di un processo con priorità 1 non verranno spostate. 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.

Nome	Tipo	Descrizione
allowLowPriorityNode	boolean	Se il Task del Job Manager può essere eseguito su un nodo di calcolo Spot/Low-priority. Il valore predefinito è true.
applicationPackageReferences	BatchApplicationPackageReference[]	Un elenco dei Pacchetti Applicativi che il servizio Batch distribuirà al Nodo di Calcolo prima di eseguire la riga di comando. I pacchetti applicativo vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro Task. Pertanto, se un Pacchetto Application di riferimento è già presente nel Nodo di Calcolo ed è aggiornato, non viene riscaricato; viene utilizzata la copia esistente sul Nodo di Calcolo. Se un Application Package di riferimento non può essere installato, ad esempio perché il pacchetto è stato eliminato o perché il download è fallito, il Task fallisce.
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 al Task un token di autenticazione che può essere utilizzato per autenticare le operazioni del servizio Batch senza richiedere una chiave di accesso all'account. Il token viene fornito tramite la variabile di ambiente AZ_BATCH_AUTHENTICATION_TOKEN. Le operazioni che il Task può eseguire utilizzando il token dipendono dalle impostazioni. Ad esempio, un Task può richiedere permessi di Job per aggiungere altri Task al Job, o verificare lo stato del Job o di altri Task sotto il Job.
commandLine	string	La riga di comando del Task del Job Manager. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
constraints	BatchTaskConstraints	Vincoli che si applicano al Task del Job Manager.
containerSettings	BatchTaskContainerSettings	Le impostazioni del contenitore sotto cui viene eseguito il Task del Job Manager. Se il Pool che eseguirà questo Task ha containerConfiguration impostato, anche questo deve essere impostato. Se il Pool che eseguirà questo Task non ha containerConfiguration impostato, questo non deve essere impostato. Quando questo viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle directory Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.
displayName	string	Il nome visualizzato del Task del Job Manager. Non deve essere necessariamente unica e può contenere qualsiasi caratteri Unicode fino a una lunghezza massima di 1024.
environmentSettings	EnvironmentSetting[]	Un elenco delle impostazioni delle variabili ambientali per il compito Job Manager.
id	string	Una stringa che identifica in modo unico il Task del Job Manager all'interno del Job. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e sottoline, e non può contenere più di 64 caratteri.
killJobOnCompletion	boolean	Se completare il compito del Responsabile del Lavoro significa il completamento dell'intero Lavoro. Se è vero, quando il compito del Job Manager si completa, il servizio batch segna il lavoro come completato. Se ci sono ancora Task in esecuzione in questo momento (a parte il rilascio del lavoro), quei Task vengono terminati. Se falso, il completamento del compito del Job Manager non influenza lo stato del Job. In questo caso, dovresti usare l'attributo onAllTasksComplete per terminare il Job, oppure far terminare esplicitamente il Job da un client o un utente. Un esempio di ciò è se il Job Manager crea un insieme di Task ma poi non assume più alcun ruolo nella loro esecuzione. Il valore predefinito è true. Se stai usando gli attributi onAllTasksComplete e onTaskFailure per controllare la durata della vita del lavoro, e usi il Task del Job Manager solo per creare i Task per il Job (non per monitorare i progressi), allora è importante impostare killJobOnCompletion su false.
outputFiles	OutputFile[]	Un elenco dei file che il servizio Batch caricherà dal Nodo di Calcolo dopo aver eseguito la riga di comando. Per i Task multi-istanza, i file verranno caricati solo dal Nodo di Calcolo su cui viene eseguito il Task principale.
requiredSlots	integer (int32)	Il numero di slot di programmazione che il Task richiede per essere eseguito. Il valore predefinito è 1. Un Task può essere programmato per essere eseguito su un nodo di calcolo solo se il nodo dispone di abbastanza slot di programmazione liberi. Per i compiti multi-istanza, 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	Se il Task del Job Manager richieda l'uso esclusivo del Nodo di Calcolo in cui viene eseguito. Se è vero, nessun altro Task verrà eseguito sullo stesso nodo finché il Job Manager è in esecuzione. Se falso, altri Task possono essere eseguiti contemporaneamente con il Job Manager su un nodo di calcolo. Il Task del Job Manager viene normalmente conteggiato rispetto al limite di compito concorrente del Nodo di Calcolo, quindi questo è rilevante solo se il Nodo di Calcolo consente più compiti concorrenti. Il valore predefinito è true.
userIdentity	UserIdentity	L'identità utente sotto cui viene eseguito il Task del Job Manager. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task.

BatchJobNetworkConfiguration

Oggetto

Questa proprietà non è disponibile per impostazione predefinita. Per ulteriori informazioni, contattare l'assistenza) La 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 è falso.
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://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

BatchJobPreparationTask

Oggetto

Un'attività di preparazione processo da eseguire prima di qualsiasi attività del processo in qualsiasi nodo di calcolo specificato. È possibile usare Preparazione processo per preparare un nodo per eseguire attività per il processo. Le attività comunemente eseguite nella preparazione dei processi includono: il download di file di risorse comuni usati da tutte le attività nel processo. L'attività preparazione processo può scaricare questi file di risorse comuni nel percorso condiviso nel nodo. (AZ_BATCH_NODE_ROOT_DIR\shared) o l'avvio di un servizio locale nel nodo in modo che tutte le attività di tale processo possano comunicare con esso. Se l'attività di preparazione del processo ha esito negativo, ovvero esaurisce il numero di tentativi prima di uscire con il codice di uscita 0, Batch non eseguirà Attività di questo processo nel nodo. Il nodo di calcolo rimane ineleggibile per eseguire attività di questo processo fino a quando non viene ricreata l'immagine. Il nodo di calcolo rimane attivo e può essere usato per altri processi. L'attività di preparazione del processo può essere eseguita più volte nello stesso nodo. Pertanto, è necessario scrivere l'attività preparazione processo per gestire la riesezione. Se il nodo viene riavviato, l'attività di preparazione processo viene nuovamente eseguita nel nodo di calcolo prima di pianificare qualsiasi altra attività del processo, se rerunOnNodeRebootAfterSuccess è true o se l'attività di preparazione del processo non è stata completata in precedenza. Se il nodo viene ricreato l'immagine, l'attività di preparazione processo viene eseguita di nuovo prima di pianificare un'attività del processo. 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.

Nome	Tipo	Descrizione
commandLine	string	La riga di comando del compito di Preparazione del Lavoro. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
constraints	BatchTaskConstraints	Vincoli che si applicano al compito di preparazione al lavoro.
containerSettings	BatchTaskContainerSettings	Le impostazioni del contenitore sotto cui si svolge il Task di Preparazione del Lavoro. Quando questo viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle directory Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.
environmentSettings	EnvironmentSetting[]	Un elenco delle impostazioni delle variabili ambientali per il compito di Preparazione al lavoro.
id	string	Una stringa che identifica in modo unico il compito di preparazione del lavoro all'interno del lavoro. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e sottoline, e non può contenere più di 64 caratteri. Se non specifichi questa proprietà, il servizio Batch assegna un valore predefinito di 'jobpreparation'. Nessun altro compito nel Lavoro può avere lo stesso ID del Compito di Preparazione del Lavoro. Se provi a inviare un Task con lo stesso id, il servizio Batch rifiuta la richiesta con il codice di errore TaskIdSameAsJobPreparationTask; se stai chiamando direttamente l'API REST, il codice di stato HTTP è 409 (Conflitto).
rerunOnNodeRebootAfterSuccess	boolean	Se il servizio Batch debba rieseguire il compito di preparazione del lavoro dopo il riavvio di un nodo di calcolo. Il compito di preparazione del lavoro viene sempre rieseguito se un nodo di calcolo viene riimagomato, o se il compito di preparazione del lavoro non è stato completato (ad esempio perché il riavvio è avvenuto mentre il compito era in esecuzione). Pertanto, dovresti sempre scrivere un compito di preparazione del lavoro per essere idempotente e comportarsi correttamente se eseguito 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	L'identità utente con cui viene eseguito il Task di Preparazione del Lavoro. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task sui Nodi di Calcolo di Windows, oppure come utente non amministrativo unico per il Pool dei Nodi di Calcolo Linux.
waitForSuccess	boolean	Se il servizio Batch debba aspettare che il Task di Preparazione del Lavoro venga completato con successo prima di programmare qualsiasi altro Task del Job sul Nodo di Calcolo. Un compito di preparazione del lavoro è stato completato con successo se esce con codice di uscita 0. Se è vero e il compito di preparazione del lavoro fallisce su un nodo, il servizio batch riprova il compito di preparazione del lavoro fino al suo massimo numero di ritentativi (come specificato nell'elemento vincicoli). Se il Task non è stato completato con successo dopo tutti i tentativi, allora il servizio Batch non programmerà i Task del Job al Nodo. Il Nodo rimane attivo e idoneo a eseguire Task di altri Lavori. Se falso, il servizio batch non attenderà il completamento del compito di preparazione del lavoro. In questo caso, altri Compiti del Lavoro possono iniziare a eseguire sul Nodo di Calcolo mentre il Compito di Preparazione del Lavoro è ancora in esecuzione; e anche se il compito di preparazione del lavoro fallisce, nuovi compiti continueranno a essere programmati sul nodo di calcolo. Il valore predefinito è true.

BatchJobReleaseTask

Oggetto

Un'attività di rilascio del processo da eseguire al completamento del processo in qualsiasi nodo di calcolo in cui è stato eseguito il processo. L'attività Di rilascio processo viene eseguita al termine del processo, a causa di una delle operazioni seguenti: l'utente chiama l'API Termina processo o l'API Elimina processo mentre il processo è ancora attivo, viene raggiunto il vincolo di tempo massimo di tempo del processo e processo è ancora attivo oppure l'attività Di gestione processi completata e il processo viene configurato per terminare al termine del processo. L'attività di rilascio processo viene eseguita in ogni nodo in cui sono state eseguite le attività del processo e l'attività di preparazione del processo è stata eseguita e completata. Se si ricrea l'immagine di un nodo dopo l'esecuzione dell'attività di preparazione del processo e il processo termina senza altre attività del processo in esecuzione su tale nodo (e di conseguenza l'attività preparazione processo non viene rieseguita), l'attività di rilascio del processo non viene eseguita in tale nodo di calcolo. Se un nodo viene riavviato mentre l'attività di rilascio del processo è ancora in esecuzione, l'attività di rilascio del processo viene eseguita di nuovo all'avvio del nodo di calcolo. Il processo non viene contrassegnato come completato fino al completamento di tutte le attività di rilascio del processo. L'attività Di rilascio processo viene eseguita in background. Non occupa uno slot di pianificazione; ovvero, non viene conteggiato per il limite taskSlotsPerNode specificato nel pool.

Nome	Tipo	Descrizione
commandLine	string	La riga di comando del compito di rilascio del lavoro. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	BatchTaskContainerSettings	Le impostazioni del contenitore sotto cui viene eseguita la Task di rilascio del lavoro. Quando questo viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle directory Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.
environmentSettings	EnvironmentSetting[]	Un elenco delle impostazioni delle variabili ambientali per il compito di rilascio del lavoro.
id	string	Una stringa che identifica in modo unico il Compito di Rilascio del Lavoro all'interno del Lavoro. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e sottoline, e non può contenere più di 64 caratteri. Se non specifichi questa proprietà, il servizio Batch assegna un valore predefinito di 'jobrelease'. Nessun altro Compito nel Lavoro può avere lo stesso ID del Compito di Rilascio del Lavoro. Se provi a inviare un Task con lo stesso id, il servizio Batch rifiuta la richiesta con il codice di errore TaskIdSameAsJobReleaseTask; se stai chiamando direttamente l'API REST, il codice di stato HTTP è 409 (Conflitto).
maxWallClockTime	string (duration)	Il tempo massimo trascorso che il Task di Rilascio del Lavoro può eseguire su un dato Nodo di Calcolo, misurato dal momento in cui il Compito inizia. Se il Task non viene completato entro il limite di tempo, il servizio Batch lo termina. Il valore predefinito è 15 minuti. Non puoi specificare un timeout superiore a 15 minuti. Se lo fai, il servizio batch lo rifiuta con un errore; se stai chiamando direttamente l'API REST, il codice di stato HTTP è 400 (Richiesta Mala).
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 (duration)	Il tempo minimo per mantenere la directory Task per il Task di rilascio del lavoro sul nodo di calcolo. Dopo questo periodo, il servizio Batch può eliminare la cartella Task e tutto il suo contenuto. Il valore predefinito è 7 giorni, cioè la directory Task verrà mantenuta per 7 giorni a meno che il Nodo di Calcolo non venga rimosso o il Lavoro venga eliminato.
userIdentity	UserIdentity	L'identità utente sotto cui viene eseguita la Task di Rilascio del Lavoro. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task.

BatchMetadataItem

Oggetto

Il servizio Batch non assegna alcun significato a questi metadati; è esclusivamente per l'uso del codice utente.

Nome	Tipo	Descrizione
name	string	Nome dell'elemento di metadati.
value	string	Valore dell'elemento di metadati.

BatchNodeFillType

Enumerazione

Enum BatchNodeFillType

Valore	Descrizione
spread	I compiti dovrebbero essere assegnati equamente su tutti i Nodi di Calcolo nel Pool.
pack	Il maggior numero possibile di Task (taskSlotsPerNode) dovrebbe essere assegnato a ogni Nodo di Calcolo del Pool prima che eventuali Compiti vengano assegnati al successivo Nodo di Calcolo del Pool.

BatchNodeIdentityReference

Oggetto

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 (arm-id)	ID risorsa ARM dell'identità assegnata dall'utente.

BatchNodePlacementConfiguration

Oggetto

Per il posizionamento a livello di area, i nodi nel pool verranno allocati nella stessa area. Per il posizionamento a livello di zona, i nodi nel pool verranno distribuiti in diverse zone con il bilanciamento del carico ottimale.

Nome	Tipo	Descrizione
policy	BatchNodePlacementPolicyType	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.

BatchNodePlacementPolicyType

Enumerazione

Enum BatchNodePlacementPolicyType.

Valore	Descrizione
regional	Tutti i nodi nel pool verranno allocati nella stessa area.
zonal	I nodi del pool saranno distribuiti su diverse zone di disponibilità con il miglior bilanciamento degli sforzi.

BatchOsDisk

Oggetto

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.
diskSizeGB	integer (int32)	Dimensioni iniziali del disco in GB durante la creazione di un nuovo disco del sistema operativo.
ephemeralOSDiskSettings	BatchDiffDiskSettings	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.

BatchPoolEndpointConfiguration

Oggetto

Configurazione dell'endpoint per un pool.

Nome	Tipo	Descrizione
inboundNATPools	BatchInboundNatPool[]	Un elenco di NAT Pool in entrata che possono essere utilizzati per indirizzare porte specifiche su un singolo Nodo di Calcolo esternamente. Il numero massimo di NAT Pool in entrata per Batch Pool è 5. Se il numero massimo di NAT Pool in entrata viene superato, la richiesta fallisce con il codice di stato HTTP 400. Non è possibile specificare se IPAddressProvisioningType è NoPublicIPAddresses.

BatchPoolIdentityReference

Oggetto

Riferimento di una delle identità del pool per crittografare il disco. Questa identità verrà usata per accedere all'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
resourceId	string (arm-id)	ID risorsa ARM dell'identità assegnata dall'utente. Questo riferimento deve essere incluso nelle identità del pool.

BatchPoolInfo

Oggetto

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

Nome	Tipo	Descrizione
autoPoolSpecification	BatchAutoPoolSpecification	Caratteristiche per un 'auto pool' temporaneo. Il servizio Batch creerà questo pool automatico quando viene inviato il processo. Se la creazione automatica del pool fallisce, il servizio batch sposta il Job in uno stato completato e l'errore di creazione del Pool viene impostato nella proprietà di errore di programmazione del Job. Il servizio Batch gestisce la durata (sia la creazione che, salvo specifico keepAlive, la cancellazione) dell'auto Pool. Qualsiasi azione dell'utente che influenzi la durata dell'auto Pool mentre il Lavoro è attivo comporterà comportamenti inaspettati. Devi specificare o l'ID del Pool o la specifica dell'auto Pool, ma non entrambe.
poolId	string	L'ID di un Pool esistente. Tutti i Compiti del Lavoro verranno eseguiti sul Pool specificato. Devi assicurarti che il Pool a cui fa riferimento questa proprietà esista. Se il Pool non esiste al momento in cui il servizio Batch cerca di programmare un Job, nessun Task per il Job non verrà eseguito finché non creerai un Pool con quell'id. Si noti che il servizio Batch non rifiuterà la richiesta di lavoro; semplicemente non eseguirà i Task finché il Pool non esiste. Devi specificare o l'ID del Pool o la specifica dell'auto Pool, ma non entrambe.

BatchPoolLifetimeOption

Enumerazione

Enum di BatchPoolLifetimeOption

Valore	Descrizione
jobschedule	Il Pool esiste per tutta la durata del Programma di Lavoro. Il Servizio Batch crea il Pool quando crea il primo Job nel calendario. Puoi applicare questa opzione solo agli Orari dei Lavori, non ai Lavori.
job	La Piscina esiste per tutta la vita del Lavoro a cui è dedicata. Il servizio batch crea il Pool quando crea il Job. Se l'opzione 'lavoro' viene applicata a un Job Schedule, il servizio Batch crea un nuovo auto Pool per ogni Job creato nel schedule.

BatchPoolSpecification

Oggetto

Specifica per la creazione di un nuovo pool.

Nome	Tipo	Descrizione
applicationPackageReferences	BatchApplicationPackageReference[]	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 (duration)	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.
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	BatchMetadataItem[]	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.
resizeTimeout	string (duration)	Timeout per l'allocazione dei nodi di calcolo al pool. Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch rifiuta la richiesta con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
startTask	BatchStartTask	Un'attività da eseguire in ogni nodo di calcolo quando viene aggiunto al pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando il nodo di calcolo viene riavviato.
targetDedicatedNodes	integer (int32)	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 (int32)	Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.
taskSchedulingPolicy	BatchTaskSchedulingPolicy	Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è spread.
taskSlotsPerNode	integer (int32)	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. È necessario specificare questa proprietà.
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://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

BatchPublicIpAddressConfiguration

Oggetto

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

Nome	Tipo	Descrizione
ipAddressIds	string[] (arm-id)	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}.
ipFamilies	IPFamily[]	Le famiglie di IP utilizzate per specificare le versioni IP disponibili per il pool. Le famiglie IP vengono utilizzate per determinare pool single-stack o dual-stack. Per uno stack singolo, il valore previsto è IPv4. Per dual stack, i valori previsti sono IPv4 e IPv6.
ipTags	IPTag[]	Elenco di tag IP associati agli indirizzi IP pubblici del pool. I tag IP vengono utilizzati per classificare e filtrare gli indirizzi IP pubblici a scopo di fatturazione e gestione.
provision	IpAddressProvisioningType	Tipo di provisioning per gli indirizzi IP pubblici per il pool. Il valore predefinito è BatchManaged.

BatchStartTask

Oggetto

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.

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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	BatchTaskContainerSettings	Le impostazioni del contenitore sotto cui viene eseguita la StartTask. Quando questo viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle directory Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.
environmentSettings	EnvironmentSetting[]	Elenco delle impostazioni delle variabili di ambiente per StartTask.
maxTaskRetryCount	integer (int32)	Numero massimo di tentativi dell'attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla in modo specifico il numero di tentativi. Il servizio Batch proverà l'attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova l'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non ritenta l'attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta l'attività senza limite, ma non è consigliabile per un'attività di avvio o per qualsiasi attività. Il valore predefinito è 0 (nessun tentativo).
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	L'identità utente sotto cui viene eseguito il StartTask. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task.
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 è vero.

BatchTaskConstraints

Oggetto

Vincoli di esecuzione da applicare a un'attività.

Nome	Tipo	Descrizione
maxTaskRetryCount	integer (int32)	Numero massimo di tentativi dell'attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente 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 conteggio massimo dei ritentativi è 0, il servizio Batch non ritenta il Task 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 (duration)	Il tempo massimo trascorso che il compito può eseguire, misurato dal momento in cui il compito inizia. Se il Task non viene completato entro il limite di tempo, il servizio Batch lo termina. Se questo non viene specificato, non c'è limite di tempo su quanto tempo il Task può durare in corso.
retentionTime	string (duration)	Il tempo minimo per mantenere la directory Task sul Nodo di Calcolo in cui è stato eseguito, dal momento in cui completa l'esecuzione. Dopo questo periodo, il servizio Batch può eliminare la cartella Task e tutto il suo contenuto. Il valore predefinito è 7 giorni, cioè la directory Task verrà mantenuta per 7 giorni a meno che il Nodo di Calcolo non venga rimosso o il Lavoro venga eliminato.

BatchTaskContainerSettings

Oggetto

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	L'immagine da usare per creare il contenitore in cui verrà eseguito il Task. Questa è la referenza completa all'Image, come specificato per "docker pull". Se non viene fornito alcun tag come parte del nome dell'Immagine, il tag ":latest" viene usato come predefinito.
registry	ContainerRegistryReference	Il registro privato che contiene l'immagine del contenitore. Questa impostazione può essere omessa se era già stata fornita alla creazione del Pool.
workingDirectory	ContainerWorkingDirectory	La posizione della directory di lavoro Task del container. Il valore predefinito è 'taskWorkingDirectory'.

BatchTaskFailureMode

Enumerazione

Enum TaskFailure

Valore	Descrizione
noaction	Non eseguire alcuna operazione. Il lavoro rimane attivo a meno che non venga licenziato o disabilitato in qualche altro modo.
performexitoptionsjobaction	Rinunciare al lavoro. Il motivo di terminazione del lavoro è impostato su 'TuttiCompitiCompletati'.

BatchTaskSchedulingPolicy

Oggetto

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

Nome	Tipo	Valore predefinito	Descrizione
jobDefaultOrder	BatchJobDefaultOrder	none	L'ordine per la programmazione delle attività da processi diversi con la stessa priorità. Se non viene specificato, il valore predefinito è nessuno.
nodeFillType	BatchNodeFillType		Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è spread.

BatchUefiSettings

Oggetto

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.

BatchVmDiskSecurityProfile

Oggetto

Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate ed è necessario quando si utilizzano 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 impostato solo per le macchine virtuali riservate ed è necessario quando si utilizzano macchine virtuali riservate.

BatchVmImageReference

Oggetto

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	L'immagine della galleria comunitaria identifica l'unico indicatore. Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta della community.
exactVersion	string	La versione specifica dell'immagine della piattaforma o dell'immagine marketplace utilizzata per creare il nodo. Questo campo di sola lettura differisce da 'version' solo se il valore specificato per 'version' al momento della creazione del pool era 'latest'.
offer	string	Il tipo di offerta dell'immagine Azure Virtual Machines Marketplace. Ad esempio, UbuntuServer o WindowsServer.
publisher	string	L'editore dell'immagine Azure Virtual Machines Marketplace. Ad esempio, Canonical o MicrosoftWindowsServer.
sharedGalleryImageId	string	L'immagine della galleria condivisa identifica unico. Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta condivisa.
sku	string	La SKU dell'immagine Azure Virtual Machines Marketplace. Ad esempio, 18.04-LTS o 2019-Datacenter.
version	string	La versione dell'immagine Azure Virtual Machines Marketplace. Un valore 'latest' può essere specificato per selezionare l'ultima versione di un'Immagine. Se omesso, il valore predefinito è 'latest'.
virtualMachineImageId	string (arm-id)	Identificatore della risorsa ARM dell'immagine della raccolta di calcolo di Azure. I nodi di calcolo nel Pool saranno creati utilizzando questo ID Immagine. Questo è della forma /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} oppure /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} per utilizzare sempre l'ultima versione dell'immagine. Questa proprietà è mutuamente esclusiva con le altre proprietà di ImageReference. L'immagine Azure Compute Gallery deve avere repliche nella stessa regione e deve essere nello stesso abbonamento dell'account batch Azure. Se la versione dell'immagine non è specificata nell'imageId, verrà utilizzata l'ultima versione. Per informazioni sulle impostazioni del firewall per l'agente Batch Compute Node per comunicare con il servizio Batch, vedi https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

CachingType

Enumerazione

Enum CachingType

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

CifsMountConfiguration

Oggetto

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)	Password da usare per l'autenticazione nel file system CIFS.
relativeMountPath	string	Il percorso relativo sul nodo di calcolo dove sarà 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.

ContainerHostBatchBindMountEntry

Oggetto

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

Enumerazione

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

Valore	Descrizione
Shared	Percorso dell'attività a più istanze in cui condividere i propri file.
Startup	Percorso dell'attività di avvio.
VfsMounts	Il percorso contiene tutti i file system virtuali montati in questo nodo.
Task	Percorso dell'attività.
JobPrep	Percorso dell'attività di preparazione del processo.
Applications	Percorso delle applicazioni.

ContainerRegistryReference

Oggetto

Registro contenitori privato.

Nome	Tipo	Descrizione
identityReference	BatchNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password.
password	string (password)	Password per accedere al server del Registro di sistema.
registryServer	string (uri)	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

Enumerazione

Enum ContainerType

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

ContainerWorkingDirectory

Enumerazione

ContainerWorkingDirectory enums

Valore	Descrizione
taskWorkingDirectory	Usa la directory standard di lavoro Task di servizio Batch, che conterrà i File Risorsa Task popolati per Batch.
containerImageDefault	Usa la directory di lavoro definita nell'immagine del container. Attenzione che questa directory non conterrà i File Risorse scaricati da Batch.

DataDisk

Oggetto

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 (int32)	Dimensioni iniziali del disco in gigabyte.
lun	integer (int32)	Numero di unità logica. LogicalUnitNumber viene usato per identificare in modo univoco ogni disco dati. Se si collegano più dischi, ognuno deve avere un valore logicalUnitNumber distinto. Il valore deve essere compreso tra 0 e 63 inclusi.
managedDisk	ManagedDisk	Parametri del disco gestito.
storageAccountType	StorageAccountType	Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs".

DiffDiskPlacement

Enumerazione

Specifica la posizione effimera del disco del sistema operativo per tutti i nodi di calcolo (VM) nel pool. Questa proprietà può essere utilizzata dall'utente nella richiesta per scegliere il percorso in cui deve trovarsi il sistema operativo. ad esempio, spazio su disco della cache per il provisioning dei dischi del sistema operativo temporaneo. Per maggiori informazioni sui requisiti di dimensione del disco di Ephemeral OS, si prega di consultare i requisiti di dimensione del disco di Ephemeral OS per le VM Windows in https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e le VM Linux in https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

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

DiskCustomerManagedKey

Oggetto

Riferimento alla chiave gestita dal cliente per crittografare il disco.

Nome	Tipo	Descrizione
identityReference	BatchPoolIdentityReference	Riferimento di una delle identità del pool per crittografare il disco. Questa identità verrà usata per accedere a KeyVault.
keyUrl	string	URL chiave con versione completa che punta a una chiave in KeyVault. Il segmento di versione dell'URL è obbligatorio indipendentemente dal valore rotationToLatestKeyVersionEnabled.
rotationToLatestKeyVersionEnabled	boolean	Impostare questo flag su true per abilitare l'aggiornamento automatico della crittografia del disco alla versione più recente della chiave. Il valore predefinito è false.

DiskEncryptionConfiguration

Oggetto

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
customerManagedKey	DiskCustomerManagedKey	Riferimento alla chiave gestita dal cliente per crittografare il disco del sistema operativo. La chiave gestita dal cliente crittograferà il disco del sistema operativo tramite EncryptionAtRest e, per impostazione predefinita, crittograferà anche il disco dati. Può essere utilizzato solo quando il pool è configurato con un'identità e OsDisk è impostato come una delle destinazioni di DiskEncryption.
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.

DiskEncryptionSetParameters

Oggetto

ID risorsa ARM del set di crittografia del disco.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa ARM del set di crittografia del disco. La risorsa deve trovarsi nella stessa sottoscrizione dell'account Batch.

DiskEncryptionTarget

Enumerazione

Enums DiskEncryptionTarget

Valore	Descrizione
osdisk	Il disco del sistema operativo nel nodo di calcolo è crittografato.
temporarydisk	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

Enumerazione

DynamicVNetAssignmentScope enums

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

ElevationLevel

Enumerazione

Enum di ElevationLevel

Valore	Descrizione
nonadmin	L'utente è un utente standard senza accesso con privilegi elevati.
admin	L'utente è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete.

EnvironmentSetting

Oggetto

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.

HostEndpointSettings

Oggetto

Specifica determinate impostazioni dell'endpoint host.

Nome	Tipo	Descrizione
inVMAccessControlProfileReferenceId	string	Specifica il riferimento all'ID risorsa InVMAccessControlProfileVersion nel formato /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}.
mode	HostEndpointSettingsModeTypes	Specifica la modalità di esecuzione dei criteri di controllo di accesso.

HostEndpointSettingsModeTypes

Enumerazione

HostEndpointSettingsModeTypes enums

Valore	Descrizione
Audit	In modalità di controllo, il sistema agisce come se applicasse i criteri di controllo di accesso, inclusa l'emissione di voci di rifiuto di accesso nei log, ma non nega effettivamente le richieste agli endpoint host.
Enforce	La modalità di applicazione è la modalità di funzionamento raccomandata e il sistema farà rispettare la politica di controllo accessi. Questa proprietà non può essere usata insieme a 'inVMAccessControlControlProfileReferenceId'.

InboundEndpointProtocol

Enumerazione

InboundEndpointProtocol enums

Valore	Descrizione
tcp	Usare TCP per l'endpoint.
udp	Usare UDP per l'endpoint.

IpAddressProvisioningType

Enumerazione

IPAddressProvisioningType enums

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

IPFamily

Enumerazione

Le famiglie di IP utilizzate per specificare le versioni IP disponibili per il pool.

Valore	Descrizione
IPv4	IPv4 è disponibile per il pool.
IPv6	IPv6 è disponibile per il pool.

IPTag

Oggetto

Contiene il tag IP associato all'indirizzo IP pubblico.

Nome	Tipo	Descrizione
ipTagType	string	Il tipo di tag IP. Esempio: FirstPartyUsage.
tag	string	Valore del tag IP associato all'indirizzo IP pubblico. Esempio: SQL.

LinuxUserConfiguration

Oggetto

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

Nome	Tipo	Descrizione
gid	integer (int32)	L'ID del 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 (password)	La chiave privata SSH per l'account utente. La chiave privata non deve essere protetta da password. La chiave privata viene utilizzata 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 è vera (viene ignorata se enableInterNodeCommunication è falso). A tale scopo, posizionare la coppia di chiavi nella directory .ssh dell'utente. Se non specificato, l'SSH senza password non è configurato tra i Nodi di Calcolo (non viene effettuata alcuna modifica della directory .ssh dell'utente).
uid	integer (int32)	L'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

Enumerazione

Enum LoginMode

Valore	Descrizione
batch	La LOGON32_LOGON_BATCH modalità di accesso Win32. La modalità di accesso batch è consigliata per i processi paralleli a esecuzione prolungata.
interactive	La LOGON32_LOGON_INTERACTIVE modalità di accesso Win32. UAC è abilitato nei pool di configurazione VirtualMachinePool di Windows. Se questa opzione viene utilizzata con un'identità utente elevata in un VirtualMachineConfiguration Pool di Windows, la sessione utente non sarà elevata a meno che l'applicazione eseguita dalla riga di comando Task non sia configurata per richiedere sempre privilegi amministrativi o per richiedere sempre il massimo privilegio.

ManagedDisk

Oggetto

Parametri del disco gestito.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito. Può essere impostato solo in modalità UserSubscription.
securityProfile	BatchVmDiskSecurityProfile	Specifica le impostazioni del profilo di sicurezza per il disco gestito.
storageAccountType	StorageAccountType	Tipo di account di archiviazione per il disco gestito.

MountConfiguration

Oggetto

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

Oggetto

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://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration	BatchPoolEndpointConfiguration	La configurazione per gli endpoint sui Nodi di Calcolo nel Batch Pool.
publicIPAddressConfiguration	BatchPublicIpAddressConfiguration	Configurazione IPAddress pubblica per i nodi di calcolo nel pool di batch.
subnetId	string	L'identificatore della risorsa ARM della subnet di rete virtuale a cui si uniranno 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 dovrebbe avere abbastanza indirizzi IP liberi per ospitare il numero di Nodi di Calcolo nel Pool. Se la subnet non ha abbastanza indirizzi IP liberi, il Pool allocerà 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 batch di Azure per poter programmare i Compiti sui 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 il VNet specificato ha eventuali Network Security Groups (NSG) associati, allora alcune porte di sistema riservate devono essere abilitate per la comunicazione in entrata, incluse le porte 29876 e 29877. Abilitare anche le connessioni in uscita ad Archiviazione di Azure sulla porta 443. Per altri dettagli, vedere: https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Oggetto

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 (int32)	Priorità per questa regola. Le priorità all'interno di un Pool devono essere uniche e 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 0 - 65535), una porta specifica (cioè 22) o un intervallo di porte (cioè 100-200). Le porte devono essere nell'intervallo da 0 a 65535. Ogni voce di questa raccolta non deve sovrapporsi a nessun'altra voce (né un intervallo né una singola porta). Se vengono forniti altri valori, la richiesta fallisce con codice di stato HTTP 400. Il valore predefinito è ''.

NetworkSecurityGroupRuleAccess

Enumerazione

NetworkSecurityGroupRuleAccess enums

Valore	Descrizione
allow	Consentire l'accesso.
deny	Negare l'accesso.

NfsMountConfiguration

Oggetto

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	Il percorso relativo sul nodo di calcolo dove sarà 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.

OutputFile

Oggetto

In ogni caricamento di file, il servizio Batch scrive due file di log nel nodo di calcolo, 'fileuploadout.txt' e 'fileuploaderr.txt'. Questi file di log vengono usati per altre informazioni su un errore specifico.

Nome	Tipo	Descrizione
destination	OutputFileDestination	La destinazione per il/i file/i di output.
filePattern	string	Uno schema che indica quale file/i caricare. Sono supportati sia i percorsi relativi che quelli assoluti. I percorsi relativi sono relativi alla directory di lavoro Task. Sono supportate le seguenti carte jolly: * corrisponde a 0 o più caratteri (ad esempio il pattern abc* corrisponderebbe ad abc o abcdef), ** corrisponde a qualsiasi directory, ? corrisponde a un singolo carattere, [ABC] corrisponde a un carattere tra parentesi, e [A-C] corrisponde a un carattere nell'intervallo. I parentesi possono includere una negazione che corrisponde a qualsiasi carattere non specificato (ad esempio [!abc] corrisponde a qualsiasi carattere tranne a, b o c). Se un nome di file inizia con "." viene ignorato di default ma può essere abbinato specificandolo esplicitamente (ad esempio .gif non corrisponderà .a.gif, ma.gif sì). Un esempio semplice: ***.txt corrisponde a qualsiasi file che non inizia con '.' e termina con .txt nella directory di lavoro Task o in qualsiasi sottodirectory. Se il nome del file contiene un personaggio jolly, può essere sfuggito usando parentesi (ad esempio abc[] corrisponderebbe a un file chiamato abc). Nota che sia \ che / sono trattati come separatori di directory su Windows, ma solo / è su Linux. Le variabili ambientali (%var% su Windows o $var su Linux) vengono espanse prima che il pattern venga applicato.
uploadOptions	OutputFileUploadConfig	Opzioni aggiuntive per l'operazione di upload, incluse le condizioni in cui effettuare il caricamento.

OutputFileBlobContainerDestination

Oggetto

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

Nome	Tipo	Descrizione
containerUrl	string (uri)	L'URL del container all'interno di Azure Blob Storage su cui caricare il/i file/i. Se non si utilizza un'identità gestita, l'URL deve includere una Firma di Accesso Condiviso (SAS) che concede permessi di scrittura al container.
identityReference	BatchNodeIdentityReference	Il riferimento all'identità assegnata dall'utente da utilizzare per accedere a Azure Blob Storage specificato da containerUrl. L'identità deve avere accesso di scrittura al container Azure Blob Storage.
path	string	Il blob di destinazione o la directory virtuale all'interno del contenitore Azure Storage. Se filePattern si riferisce a un file specifico (cioè non contiene wildcard), allora path è il nome del blob su cui caricare quel file. Se filePattern contiene una o più wildcard (e quindi può corrispondere a più file), allora path è il nome della cartella virtuale del blob (che viene preattaccato a ciascun nome del blob) su cui caricare il/i file/i. Se omesso, i file/i vengono caricati alla radice del container con un nome di blob corrispondente al nome del loro file.
uploadHeaders	OutputFileUploadHeader[]	Un elenco di coppie nome-valore per le intestazioni da utilizzare nel caricamento dei file di output. Queste intestazioni saranno specificate durante il caricamento dei file su Azure Storage. Documento ufficiale sulle intestazioni consentite durante il caricamento dei blob: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types.

OutputFileDestination

Oggetto

Destinazione in cui caricare un file.

Nome	Tipo	Descrizione
container	OutputFileBlobContainerDestination	Una posizione nello storage blob di Azure dove vengono caricati i file.

OutputFileUploadCondition

Enumerazione

OutputFileUploadCondition enums

Valore	Descrizione
tasksuccess	Carica il/i file/i solo dopo che il processo Task esce con un codice di uscita pari a 0.
taskfailure	Carica il/i file/i solo dopo che il processo Task esce con un codice di uscita diverso da zero.
taskcompletion	Carica il/i file/i dopo che il processo Task si è chiuso, indipendentemente dal codice di uscita.

OutputFileUploadConfig

Oggetto

Opzioni per un'operazione di caricamento del file di output, incluse le condizioni per eseguire il caricamento.

Nome	Tipo	Descrizione
uploadCondition	OutputFileUploadCondition	Le condizioni in cui il file di output o l'insieme di file di Task devono essere caricati. Il modo predefinito è il completamento del compito.

OutputFileUploadHeader

Oggetto

Coppia nome-valore intestazione HTTP

Nome	Tipo	Descrizione
name	string	Il nome insensibile a maiuscole dell'intestazione da utilizzare durante il caricamento dei file di output.
value	string	Il valore dell'intestazione da utilizzare durante il caricamento dei file di output.

ProxyAgentSettings

Oggetto

Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale.

Nome	Tipo	Descrizione
enabled	boolean	Specifica se la funzionalità Protocollo di sicurezza dei metadati deve essere abilitata nella macchina virtuale o nel set di scalabilità di macchine virtuali. Il valore predefinito è False.
imds	HostEndpointSettings	Impostazioni per l'endpoint IMDS.
wireServer	HostEndpointSettings	Impostazioni per l'endpoint WireServer.

ResourceFile

Oggetto

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

Nome	Tipo	Descrizione
autoStorageContainerName	string	Il nome del container di archiviazione nell'account di auto storage. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata.
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 su Linux Compute Nodes. Verrà ignorato se viene specificato per un file di risorsa che verrà scaricato su un nodo di calcolo di Windows. Se questa proprietà non è specificata per un nodo Linux Compute, allora viene applicato un valore predefinito 0770 al file.
filePath	string	La posizione sul Nodo di Calcolo su cui scaricare il/i file/i, rispetto alla directory operativa del Task. Se viene specificata la proprietà httpUrl, filePath è obbligatorio e descrive il percorso in cui verrà scaricato il file, incluso il nome file. In caso contrario, se si specifica la proprietà autoStorageContainerName o storageContainerUrl, filePath è facoltativo ed è la directory in cui scaricare i file. Nel caso in cui filePath venga usato come directory, qualsiasi struttura di directory già associata ai dati di input verrà mantenuta in modo completo e accodato alla directory filePath specificata. Il percorso relativo specificato non può uscire dalla directory di lavoro del Task (ad esempio usando '..').
httpUrl	string (uri)	URL del file da scaricare. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Se l'URL punta ad Archiviazione BLOB di Azure, deve essere leggibile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un BLOB nell'archiviazione di Azure: includere una firma di accesso condiviso (SAS) che concede le autorizzazioni di lettura per il BLOB, usare un'identità gestita con autorizzazione di lettura o impostare l'ACL per il BLOB o il relativo contenitore per consentire l'accesso pubblico.
identityReference	BatchNodeIdentityReference	Il riferimento all'identità assegnata dall'utente da utilizzare per accedere a Azure Blob Storage specificato da storageContainerUrl o httpUrl.
storageContainerUrl	string (uri)	URL del contenitore BLOB all'interno di Archiviazione BLOB di Azure. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Questo URL deve essere leggibile ed elencabile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un contenitore nell'archiviazione di Azure: includere una firma di accesso condiviso che concede autorizzazioni di lettura ed elenco per il contenitore, usare un'identità gestita con autorizzazioni di lettura ed elenco o impostare l'ACL per il contenitore per consentire l'accesso pubblico.

RollingUpgradePolicy

Oggetto

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 (int32)	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 (int32)	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 (int32)	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 (duration)	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.

SecurityEncryptionTypes

Enumerazione

Enums SecurityEncryptionTypes

Valore	Descrizione
DiskWithVMGuestState	EncryptionType del disco gestito è impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState. Non è supportata nei dischi dati.
NonPersistedTPM	EncryptionType del disco gestito è impostato su NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState.
VMGuestStateOnly	EncryptionType del disco gestito è impostato su VMGuestStateOnly per la crittografia del solo BLOB VMGuestState.

SecurityProfile

Oggetto

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://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes.
proxyAgentSettings	ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale.
securityType	SecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings.
uefiSettings	BatchUefiSettings	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

Enumerazione

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

Valore	Descrizione
trustedLaunch	L'avvio attendibile protegge da tecniche di attacco avanzate e persistenti.
confidentialvm	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.

ServiceArtifactReference

Oggetto

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	L'ID riferimento artefatto di 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}

StorageAccountType

Enumerazione

Enumerazioni StorageAccountType

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

UpgradeMode

Enumerazione

Enum UpgradeMode

Valore	Descrizione
automatic	Tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.
manual	È possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade.
rolling	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

Oggetto

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.

UserAccount

Oggetto

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

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

UserIdentity

Oggetto

Definizione dell'identità utente in cui viene eseguita l'attività. Specificare la proprietà userName o autoUser, ma non entrambe.

Nome	Tipo	Descrizione
autoUser	AutoUserSpecification	L'utente automatico sotto cui viene eseguito il Task. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.
username	string	Il nome dell'identità utente con cui viene eseguito il Task. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.

VirtualMachineConfiguration

Oggetto

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

Nome	Tipo	Descrizione
containerConfiguration	BatchContainerConfiguration	La configurazione del container per il Pool. Se specificato, la configurazione viene effettuata su ogni Nodo di Calcolo nel Pool per permettere ai Task di eseguire nei container. Tutte le normali Task e le Task del Job Manager che vengono eseguite su questo Pool devono specificare la proprietà containerSettings, e tutte le altre Task possono specificarla.
dataDisks	DataDisk[]	La 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 a loro. Non è possibile aggiornarlo. Ogni Nodo di Calcolo ha il proprio disco (il disco non è una condivisione file). I dischi esistenti non possono essere collegati, ogni disco collegato è vuoto. Quando il Nodo di Calcolo viene rimosso dal Pool, il disco e tutti i dati ad esso associati vengono eliminati. Il disco non viene formattato dopo essere stato collegato, deve essere formattato prima dell'uso - per ulteriori informazioni vedi https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux e https://learn.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	BatchVmImageReference	Riferimento all'immagine del Marketplace delle macchine virtuali di Azure o all'immagine di macchina virtuale personalizzata da usare.
licenseType	string	Questo vale solo per le Immagini che contengono il sistema operativo Windows e dovrebbe essere usato solo quando si possiedono licenze on-premises 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	BatchNodePlacementConfiguration	Configurazione del posizionamento del nodo per il pool. Questa configurazione specificherà le regole sulla modalità di allocazione fisica dei nodi nel pool.
osDisk	BatchOsDisk	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.
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 Linux OS.

VMExtension

Oggetto

Configurazione per le estensioni della macchina virtuale.

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

WindowsConfiguration

Oggetto

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

Oggetto

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

Nome	Tipo	Descrizione
loginMode	LoginMode	La modalità di accesso per l'utente. Il predefinito è 'batch'.