Pool - Add
Aggiunge un pool all'account specificato.
Quando si assegnano nomi ai pool, evitare di includere informazioni riservate, ad esempio nomi utente o nomi di progetto segreti. Queste informazioni possono essere visualizzate nei log di telemetria accessibili ai tecnici del supporto Tecnico Microsoft.
POST {batchUrl}/pools?api-version=2024-07-01.20.0
POST {batchUrl}/pools?timeout={timeout}&api-version=2024-07-01.20.0
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
batch
|
path | True |
string |
URL di base per tutte le richieste del servizio Azure Batch. |
api-version
|
query | True |
string |
Versione dell'API client. |
timeout
|
query |
integer int32 |
Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è maggiore di 30, verrà usato il valore predefinito. |
Intestazione della richiesta
Media Types: "application/json; odata=minimalmetadata"
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
client-request-id |
string uuid |
Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Indica se il server deve restituire l'ID richiesta client nella risposta. |
|
ocp-date |
string date-time-rfc1123 |
Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST. |
Corpo della richiesta
Media Types: "application/json; odata=minimalmetadata"
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
id | True |
string |
Stringa che identifica in modo univoco il pool all'interno dell'account. |
vmSize | True |
string |
Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni. |
applicationPackageReferences |
Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. |
||
autoScaleEvaluationInterval |
string |
Intervallo di tempo in cui modificare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica. |
|
autoScaleFormula |
string |
Formula per il numero desiderato di nodi di calcolo nel pool. |
|
certificateReferences |
Elenco di certificati da installare in ogni nodo di calcolo nel pool. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece 'estensione Azure KeyVault. |
||
displayName |
string |
Nome visualizzato del pool. |
|
enableAutoScale |
boolean |
Indica se le dimensioni del pool devono essere regolate automaticamente nel tempo. |
|
enableInterNodeCommunication |
boolean |
Indica se il pool consente la comunicazione diretta tra nodi di calcolo. |
|
metadata |
Elenco di coppie nome-valore associate al pool come metadati. |
||
mountConfiguration |
Montare l'archiviazione usando il file system specificato per l'intera durata del pool. |
||
networkConfiguration |
Configurazione di rete per il pool. |
||
resizeTimeout |
string |
Timeout per l'allocazione dei nodi di calcolo al pool. |
|
resourceTags |
object |
Tag specificati dall'utente associati al pool. |
|
startTask |
Un'attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool. |
||
targetDedicatedNodes |
integer |
Numero desiderato di nodi di calcolo dedicati nel pool. |
|
targetLowPriorityNodes |
integer |
Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. |
|
targetNodeCommunicationMode |
Modalità di comunicazione del nodo desiderata per il pool. |
||
taskSchedulingPolicy |
Modalità di distribuzione delle attività tra nodi di calcolo in un pool. |
||
taskSlotsPerNode |
integer |
Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool. |
|
upgradePolicy |
Criteri di aggiornamento per il pool. |
||
userAccounts |
Elenco di account utente da creare in ogni nodo di calcolo nel pool. |
||
virtualMachineConfiguration |
Configurazione della macchina virtuale per il pool. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
201 Created |
La richiesta al servizio Batch ha avuto esito positivo. Intestazioni
|
|
Other Status Codes |
Errore del servizio Batch. |
Sicurezza
azure_auth
Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | Rappresentare l'account utente |
Authorization
Tipo:
apiKey
In:
header
Esempio
Add a pool with accelerated networking
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "mypool01",
"vmSize": "Standard_D1_v2",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.windows amd64"
},
"targetDedicatedNodes": 2,
"networkConfiguration": {
"enableAcceleratedNetworking": true
}
}
Risposta di esempio
Add a pool with mount drive specified
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "pool2",
"vmSize": "standard_a1",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "UbuntuServer",
"sku": "20_04-lts"
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04"
},
"mountConfiguration": [
{
"azureBlobFileSystemConfiguration": {
"accountName": "accountName",
"containerName": "blobContainerName",
"accountKey": "accountKey",
"relativeMountPath": "bfusepath"
}
},
{
"azureFileShareConfiguration": {
"accountName": "accountName",
"azureFileUrl": "https://myaccount.file.core.windows.net/fileshare",
"accountKey": "accountKey",
"relativeMountPath": "filesharepath",
"mountOptions": "mount options ver=1.0"
}
},
{
"nfsMountConfiguration": {
"source": "somesource nfs url",
"relativeMountPath": "mountpath",
"mountOptions": "mount options ver=1.0"
}
},
{
"cifsMountConfiguration": {
"username": "accountName",
"password": "password",
"source": "//myaccount.file.core.windows.net/file",
"relativeMountPath": "mountpath",
"mountOptions": "mount options ver=1.0"
}
}
],
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 5,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 3,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"enableAutoScale": false
}
Risposta di esempio
Add a pool with SecurityProfile
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "mypool001",
"vmSize": "STANDARD_DC2s_V2",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "UbuntuServer",
"sku": "18_04-lts-gen2",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.ubuntu 18.04",
"securityProfile": {
"securityType": "trustedLaunch",
"encryptionAtHost": true,
"uefiSettings": {
"secureBootEnabled": false,
"vTpmEnabled": null
}
}
},
"targetDedicatedNodes": 1
}
Risposta di esempio
Add a pool with UpgradePolicy
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "mypool001",
"vmSize": "Standard_A1_v2",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
},
"nodePlacementConfiguration": {
"policy": "zonal"
},
"nodeAgentSKUId": "batch.node.windows amd64"
},
"targetDedicatedNodes": 2,
"upgradePolicy": {
"mode": "automatic",
"automaticOSUpgradePolicy": {
"disableAutomaticRollback": true,
"enableAutomaticOSUpgrade": true,
"useRollingUpgradePolicy": true,
"osRollingUpgradeDeferral": true
},
"rollingUpgradePolicy": {
"enableCrossZoneUpgrade": true,
"maxBatchInstancePercent": 20,
"maxUnhealthyInstancePercent": 20,
"maxUnhealthyUpgradedInstancePercent": 20,
"pauseTimeBetweenBatches": "PT0S",
"prioritizeUnhealthyInstances": false,
"rollbackFailedInstancesOnPolicyBreach": false
}
}
}
Risposta di esempio
Add a simple pool with resourceTags
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "mypool001",
"vmSize": "STANDARD_DC2s_V2",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "UbuntuServer",
"sku": "18_04-lts-gen2",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.ubuntu 18.04"
},
"targetDedicatedNodes": 1,
"resourceTags": {
"TagName1": "TagValue1",
"TagName2": "TagValue2"
}
}
Risposta di esempio
Add a VirtualMachineConfiguration pool
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "pool2",
"vmSize": "standard_a1",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-focal",
"sku": "20_04-lts"
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04"
},
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 5,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 3,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"enableAutoScale": false,
"enableInterNodeCommunication": true,
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
]
}
Risposta di esempio
Add a VirtualMachineConfiguration pool with containers
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "pool2",
"vmSize": "standard_a1",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-focal",
"sku": "120_04-lts"
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04",
"containerConfiguration": {
"type": "dockerCompatible",
"containerImageNames": [
"busybox"
]
}
},
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 5,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 3,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"enableAutoScale": false
}
Risposta di esempio
Add a VirtualMachineConfiguration pool with extensions
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "pool2",
"vmSize": "standard_a1",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-focal",
"sku": "20_04-lts"
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04",
"extensions": [
{
"name": "batchextension1",
"type": "KeyVaultForLinux",
"publisher": "Microsoft.Azure.KeyVault",
"typeHandlerVersion": "2.0",
"autoUpgradeMinorVersion": true,
"enableAutomaticUpgrade": true,
"settings": "{\"secretsManagementSettingsKey\":\"secretsManagementSettingsValue\",\"authenticationSettingsKey\":\"authenticationSettingsValue\"}"
}
]
},
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 5,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 3,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"enableAutoScale": false,
"enableInterNodeCommunication": true,
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
],
"targetNodeCommunicationMode": "simplified"
}
Risposta di esempio
Add a VirtualMachineConfiguration pool with OS disk
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "mypool001",
"vmSize": "standard_d2s_v3",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-focal",
"sku": "20_04-lts"
},
"osDisk": {
"diskSizeGB": 100,
"managedDisk": {
"storageAccountType": "standardssd_lrs"
},
"caching": "readwrite",
"ephemeralOSDiskSettings": {
"placement": "CacheDisk"
}
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04"
},
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 1,
"enableAutoScale": false
}
Risposta di esempio
Add a VirtualMachineConfiguration pool with ServiceArtifactReference
Esempio di richiesta
POST account.region.batch.azure.com/pools?api-version=2024-07-01.20.0
{
"id": "mypool002",
"vmSize": "Standard_A1_v2",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
},
"serviceArtifactReference": {
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
},
"nodeAgentSKUId": "batch.node.windows amd64"
},
"targetDedicatedNodes": 2,
"upgradePolicy": {
"mode": "automatic",
"automaticOSUpgradePolicy": {
"enableAutomaticOSUpgrade": true
}
}
}
Risposta di esempio
Definizioni
Nome | Descrizione |
---|---|
Application |
Riferimento a un pacchetto da distribuire nei nodi di calcolo. |
Automatic |
Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo. |
Auto |
Ambito dell'utente automatico |
Auto |
Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch. |
Azure |
Informazioni usate per connettersi a un contenitore di archiviazione di Azure usando Blobfuse. |
Azure |
Informazioni usate per connettersi a una condivisione file di Azure. |
Batch |
Risposta di errore ricevuta dal servizio Azure Batch. |
Batch |
Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch. |
Caching |
Tipo di memorizzazione nella cache da abilitare per il disco. |
Certificate |
Riferimento a un certificato da installare nei nodi di calcolo in un pool. |
Certificate |
Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato. |
Certificate |
Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato. |
CIFSMount |
Informazioni utilizzate per connettersi a un file system CIFS. |
Compute |
Modalità di distribuzione delle attività tra nodi di calcolo in un pool. |
Compute |
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo. |
Container |
Configurazione per i pool abilitati per i contenitori. |
Container |
Voce di percorso e modalità di montaggio da montare nel contenitore di attività. |
Container |
Percorsi che verranno montati nel contenitore dell'attività contenitore. |
Container |
Registro contenitori privato. |
Container |
Tecnologia contenitore da usare. |
Container |
Percorso della directory di lavoro dell'attività del contenitore. |
Data |
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. |
Diff |
Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutti i nodi di calcolo (VM) nel pool. |
Diff |
Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal nodo di calcolo (VM). |
Disk |
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. |
Disk |
L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo. |
Dynamic |
Ambito dell'assegnazione dinamica della rete virtuale. |
Elevation |
Livello di elevazione dell'utente. |
Environment |
Variabile di ambiente da impostare in un processo task. |
Error |
Messaggio di errore ricevuto in una risposta di errore di Azure Batch. |
Image |
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". |
Inbound |
Protocollo dell'endpoint. |
Inbound |
Pool NAT in ingresso che può essere usato per gestire porte specifiche nei nodi di calcolo in un pool di Batch esternamente. |
IPAddress |
Tipo di provisioning per gli indirizzi IP pubblici per il pool. |
Linux |
Proprietà usate per creare un account utente in un nodo di calcolo Linux. |
Login |
Modalità di accesso per l'utente |
Managed |
|
Metadata |
Coppia nome-valore associata a una risorsa del servizio Batch. |
Mount |
File system da montare in ogni nodo. |
Network |
Configurazione di rete per un pool. |
Network |
Regola del gruppo di sicurezza di rete da applicare a un endpoint in ingresso. |
Network |
Azione da eseguire per un indirizzo IP, un intervallo di subnet o un tag specificati. |
NFSMount |
Informazioni utilizzate per connettersi a un file system NFS. |
Node |
Determina il modo in cui un pool comunica con il servizio Batch. |
Node |
Configurazione del posizionamento dei nodi per un pool. |
Node |
Criteri di posizionamento per l'allocazione dei nodi nel pool. |
OSDisk |
Impostazioni per il disco del sistema operativo del nodo di calcolo (VM). |
Pool |
Pool nel servizio Azure Batch da aggiungere. |
Pool |
Configurazione dell'endpoint per un pool. |
Public |
Configurazione dell'indirizzo IP pubblico della configurazione di rete di un pool. |
Resource |
Un singolo file o più file da scaricare in un nodo di calcolo. |
Rolling |
Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza. |
Security |
Specifica encryptionType del disco gestito. È impostato su VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostata solo per le macchine virtuali riservate ed è necessaria quando si usano macchine virtuali riservate. |
Security |
Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali. |
Security |
Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. |
Service |
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'. |
Start |
Attività eseguita quando un nodo viene aggiunto a un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato l'immagine. |
Storage |
Tipo di account di archiviazione da usare per la creazione di dischi dati o disco del sistema operativo. |
Task |
Impostazioni del contenitore per un'attività. |
Task |
Specifica la modalità di distribuzione delle attività tra i nodi di calcolo. |
Uefi |
Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. |
Upgrade |
Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità. |
Upgrade |
Descrive un criterio di aggiornamento: automatico, manuale o in sequenza. |
User |
Proprietà usate per creare un utente usato per eseguire attività in un nodo di calcolo di Azure Batch. |
User |
Definizione dell'identità utente in cui viene eseguita l'attività. |
Virtual |
Configurazione per i nodi di calcolo in un pool basato sull'infrastruttura di macchine virtuali di Azure. |
VMDisk |
Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostata solo per le macchine virtuali riservate e necessarie quando si usano macchine virtuali riservate. |
VMExtension |
Configurazione per le estensioni della macchina virtuale. |
Windows |
Impostazioni del sistema operativo Windows da applicare alla macchina virtuale. |
Windows |
Proprietà usate per creare un account utente in un nodo di calcolo Windows. |
ApplicationPackageReference
Riferimento a un pacchetto da distribuire nei nodi di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
applicationId |
string |
ID dell'applicazione da distribuire. |
version |
string |
Versione dell'applicazione da distribuire. Se omesso, viene distribuita la versione predefinita. |
AutomaticOSUpgradePolicy
Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.
Nome | Tipo | Descrizione |
---|---|---|
disableAutomaticRollback |
boolean |
Indica se la funzionalità di rollback dell'immagine del sistema operativo deve essere disabilitata. |
enableAutomaticOSUpgrade |
boolean |
Indica se gli aggiornamenti del sistema operativo devono essere applicati automaticamente alle istanze del set di scalabilità in sequenza quando diventa disponibile una versione più recente dell'immagine del sistema operativo. |
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
Ambito dell'utente automatico
Nome | Tipo | Descrizione |
---|---|---|
pool |
string |
Specifica che l'attività viene eseguita come account utente automatico comune creato in ogni nodo di calcolo in un pool. |
task |
string |
Specifica che il servizio deve creare un nuovo utente per l'attività. |
AutoUserSpecification
Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch.
Nome | Tipo | Descrizione |
---|---|---|
elevationLevel |
Livello di elevazione dell'utente automatico. |
|
scope |
Ambito dell'utente automatico |
AzureBlobFileSystemConfiguration
Informazioni usate per connettersi a un contenitore di archiviazione di Azure usando Blobfuse.
Nome | Tipo | Descrizione |
---|---|---|
accountKey |
string |
Chiave dell'account di archiviazione di Azure. |
accountName |
string |
Nome dell'account di archiviazione di Azure. |
blobfuseOptions |
string |
Opzioni della riga di comando aggiuntive da passare al comando mount. |
containerName |
string |
Nome del contenitore di Archiviazione BLOB di Azure. |
identityReference |
Riferimento all'identità assegnata dall'utente da usare per accedere a containerName |
|
relativeMountPath |
string |
Percorso relativo nel nodo di calcolo in cui verrà montato il file system |
sasKey |
string |
Token di firma di accesso condiviso di Archiviazione di Azure. |
AzureFileShareConfiguration
Informazioni usate per connettersi a una condivisione file di Azure.
Nome | Tipo | Descrizione |
---|---|---|
accountKey |
string |
Chiave dell'account di archiviazione di Azure. |
accountName |
string |
Nome dell'account di archiviazione di Azure. |
azureFileUrl |
string |
URL di File di Azure. |
mountOptions |
string |
Opzioni della riga di comando aggiuntive da passare al comando mount. |
relativeMountPath |
string |
Percorso relativo nel nodo di calcolo in cui verrà montato il file system |
BatchError
Risposta di errore ricevuta dal servizio Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice. |
message |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
|
values |
Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore. |
BatchErrorDetail
Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
key |
string |
Identificatore che specifica il significato della proprietà Value. |
value |
string |
Informazioni aggiuntive incluse nella risposta di errore. |
CachingType
Tipo di memorizzazione nella cache da abilitare per il disco.
Nome | Tipo | Descrizione |
---|---|---|
none |
string |
La modalità di memorizzazione nella cache per il disco non è abilitata. |
readonly |
string |
La modalità di memorizzazione nella cache per il disco è di sola lettura. |
readwrite |
string |
La modalità di memorizzazione nella cache per il disco è di lettura e scrittura. |
CertificateReference
Riferimento a un certificato da installare nei nodi di calcolo in un pool.
Nome | Tipo | Descrizione |
---|---|---|
storeLocation |
Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato. |
|
storeName |
string |
Nome dell'archivio certificati nel nodo di calcolo in cui installare il certificato. |
thumbprint |
string |
Identificazione personale del certificato. |
thumbprintAlgorithm |
string |
Algoritmo a cui è associata l'identificazione personale. Deve essere sha1. |
visibility |
Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato. |
CertificateStoreLocation
Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
Nome | Tipo | Descrizione |
---|---|---|
currentuser |
string |
I certificati devono essere installati nell'archivio certificati CurrentUser. |
localmachine |
string |
I certificati devono essere installati nell'archivio certificati LocalMachine. |
CertificateVisibility
Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.
Nome | Tipo | Descrizione |
---|---|---|
remoteuser |
string |
Il certificato deve essere visibile agli account utente in cui gli utenti accedono in remoto al nodo di calcolo. |
starttask |
string |
Il certificato deve essere visibile all'account utente in cui viene eseguito StartTask. Si noti che se l'ambito dell'utente automatico è Pool sia per StartTask che per un'attività, questo certificato sarà visibile anche all'attività. |
task |
string |
Il certificato deve essere visibile agli account utente in cui vengono eseguite le attività di processo. |
CIFSMountConfiguration
Informazioni utilizzate per connettersi a un file system CIFS.
Nome | Tipo | Descrizione |
---|---|---|
mountOptions |
string |
Opzioni della riga di comando aggiuntive da passare al comando mount. |
password |
string |
Password da usare per l'autenticazione nel file system CIFS. |
relativeMountPath |
string |
Percorso relativo nel nodo di calcolo in cui verrà montato il file system |
source |
string |
URI del file system da montare. |
username |
string |
Utente da usare per l'autenticazione nel file system CIFS. |
ComputeNodeFillType
Modalità di distribuzione delle attività tra nodi di calcolo in un pool.
Nome | Tipo | Descrizione |
---|---|---|
pack |
string |
Il maggior numero possibile di attività (taskSlotsPerNode) deve essere assegnato a ogni nodo di calcolo nel pool prima che tutte le attività vengano assegnate al nodo di calcolo successivo nel pool. |
spread |
string |
Le attività devono essere assegnate in modo uniforme in tutti i nodi di calcolo nel pool. |
ComputeNodeIdentityReference
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
resourceId |
string |
ID risorsa ARM dell'identità assegnata dall'utente. |
ContainerConfiguration
Configurazione per i pool abilitati per i contenitori.
Nome | Tipo | Descrizione |
---|---|---|
containerImageNames |
string[] |
Raccolta di nomi di immagine del contenitore. |
containerRegistries |
Registri privati aggiuntivi da cui è possibile eseguire il pull dei contenitori. |
|
type |
Tecnologia contenitore da usare. |
ContainerHostBatchBindMountEntry
Voce di percorso e modalità di montaggio da montare nel contenitore di attività.
Nome | Tipo | Descrizione |
---|---|---|
isReadOnly |
boolean |
Montare o meno questo percorso di origine come modalità di sola lettura. Il valore predefinito è false (modalità lettura/scrittura). |
source |
Il percorso che può essere montato nel cliente del contenitore può selezionare. |
ContainerHostDataPath
Percorsi che verranno montati nel contenitore dell'attività contenitore.
Nome | Tipo | Descrizione |
---|---|---|
Applications |
string |
Percorso delle applicazioni. |
JobPrep |
string |
Percorso dell'attività di preparazione del processo. |
Shared |
string |
Percorso dell'attività a più istanze in cui condividere i propri file. |
Startup |
string |
Percorso dell'attività di avvio. |
Task |
string |
Percorso dell'attività. |
VfsMounts |
string |
Il percorso contiene tutti i file system virtuali montati in questo nodo. |
ContainerRegistry
Registro contenitori privato.
Nome | Tipo | Descrizione |
---|---|---|
identityReference |
Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password. |
|
password |
string |
Password per accedere al server del Registro di sistema. |
registryServer |
string |
URL del Registro di sistema. |
username |
string |
Nome utente per accedere al server del Registro di sistema. |
ContainerType
Tecnologia contenitore da usare.
Nome | Tipo | Descrizione |
---|---|---|
criCompatible |
string |
Per avviare i contenitori verrà usata una tecnologia basata su CRI. |
dockerCompatible |
string |
Per avviare i contenitori verrà usata una tecnologia contenitore compatibile con Docker. |
ContainerWorkingDirectory
Percorso della directory di lavoro dell'attività del contenitore.
Nome | Tipo | Descrizione |
---|---|---|
containerImageDefault |
string |
Usare la directory di lavoro definita nell'immagine del contenitore. Tenere presente che questa directory non conterrà i file di risorse scaricati da Batch. |
taskWorkingDirectory |
string |
Usare la directory di lavoro dell'attività del servizio Batch standard, che conterrà i file di risorse attività popolati da Batch. |
DataDisk
Impostazioni che verranno usate dai dischi dati associati ai nodi di calcolo nel pool. Quando si usano dischi dati collegati, è necessario montare e formattare i dischi dall'interno di una macchina virtuale per usarli.
Nome | Tipo | Descrizione |
---|---|---|
caching |
Tipo di memorizzazione nella cache da abilitare per i dischi dati. |
|
diskSizeGB |
integer |
Dimensioni iniziali del disco in gigabyte. |
lun |
integer |
Numero di unità logica. |
storageAccountType |
Tipo di account di archiviazione da usare per il disco dati. |
DiffDiskPlacement
Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutti i nodi di calcolo (VM) nel pool.
Nome | Tipo | Descrizione |
---|---|---|
CacheDisk |
string |
Il disco del sistema operativo temporaneo viene archiviato nella cache della macchina virtuale. |
DiffDiskSettings
Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal nodo di calcolo (VM).
Nome | Tipo | Descrizione |
---|---|---|
placement |
Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutte le macchine virtuali nel pool. |
DiskEncryptionConfiguration
Configurazione della crittografia del disco applicata ai nodi di calcolo nel pool. La configurazione della crittografia del disco non è supportata nel pool Linux creato con l'immagine della raccolta di calcolo di Azure.
Nome | Tipo | Descrizione |
---|---|---|
targets |
L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo. |
DiskEncryptionTarget
L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
osdisk |
string |
Il disco del sistema operativo nel nodo di calcolo è crittografato. |
temporarydisk |
string |
Il disco temporaneo nel nodo di calcolo è crittografato. In Linux questa crittografia si applica ad altre partizioni (ad esempio quelle su dischi dati montati) quando la crittografia viene eseguita al momento dell'avvio. |
DynamicVNetAssignmentScope
Ambito dell'assegnazione dinamica della rete virtuale.
Nome | Tipo | Descrizione |
---|---|---|
job |
string |
L'assegnazione dinamica della rete virtuale viene eseguita per ogni processo. |
none |
string |
Non è abilitata alcuna assegnazione dinamica di rete virtuale. |
ElevationLevel
Livello di elevazione dell'utente.
Nome | Tipo | Descrizione |
---|---|---|
admin |
string |
L'utente è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete. |
nonadmin |
string |
L'utente è un utente standard senza accesso con privilegi elevati. |
EnvironmentSetting
Variabile di ambiente da impostare in un processo task.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome della variabile di ambiente. |
value |
string |
Valore della variabile di ambiente. |
ErrorMessage
Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
lang |
string |
Codice linguistico del messaggio di errore |
value |
string |
Testo del messaggio. |
ImageReference
Riferimento a un'immagine del Marketplace di macchine virtuali di Azure o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti alle immagini di Azure Marketplace verificati da Azure Batch, vedere l'operazione "Elenca immagini supportate".
Nome | Tipo | Descrizione |
---|---|---|
communityGalleryImageId |
string |
Identificatore univoco dell'immagine della raccolta community |
exactVersion |
string |
Versione specifica dell'immagine della piattaforma o dell'immagine del marketplace usata per creare il nodo. Questo campo di sola lettura è diverso da 'version' solo se il valore specificato per 'version' quando il pool è stato creato è stato 'latest'. |
offer |
string |
Tipo di offerta dell'immagine marketplace di Macchine virtuali di Azure. |
publisher |
string |
Autore dell'immagine del Marketplace delle macchine virtuali di Azure. |
sharedGalleryImageId |
string |
Identificatore univoco dell'immagine della raccolta condivisa |
sku |
string |
SKU dell'immagine del Marketplace delle macchine virtuali di Azure. |
version |
string |
Versione dell'immagine marketplace di Macchine virtuali di Azure. |
virtualMachineImageId |
string |
Identificatore della risorsa ARM dell'immagine della raccolta di calcolo di Azure. I nodi di calcolo nel pool verranno creati usando questo ID immagine. Si tratta del formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} per l'impostazione predefinita alla versione più recente dell'immagine. |
InboundEndpointProtocol
Protocollo dell'endpoint.
Nome | Tipo | Descrizione |
---|---|---|
tcp |
string |
Usare TCP per l'endpoint. |
udp |
string |
Usare UDP per l'endpoint. |
InboundNATPool
Pool NAT in ingresso che può essere usato per gestire porte specifiche nei nodi di calcolo in un pool di Batch esternamente.
Nome | Tipo | Descrizione |
---|---|---|
backendPort |
integer |
Numero di porta nel nodo di calcolo. |
frontendPortRangeEnd |
integer |
Ultimo numero di porta nell'intervallo di porte esterne che verranno usate per fornire l'accesso in ingresso al back-endPort in singoli nodi di calcolo. |
frontendPortRangeStart |
integer |
Primo numero di porta nell'intervallo di porte esterne che verranno usate per fornire l'accesso in ingresso al back-endPort in singoli nodi di calcolo. |
name |
string |
Nome dell'endpoint. |
networkSecurityGroupRules |
Elenco delle regole del gruppo di sicurezza di rete che verranno applicate all'endpoint. |
|
protocol |
Protocollo dell'endpoint. |
IPAddressProvisioningType
Tipo di provisioning per gli indirizzi IP pubblici per il pool.
Nome | Tipo | Descrizione |
---|---|---|
batchmanaged |
string |
Un indirizzo IP pubblico verrà creato e gestito da Batch. Possono essere presenti più indirizzi IP pubblici a seconda delle dimensioni del pool. |
nopublicipaddresses |
string |
Non verrà creato alcun indirizzo IP pubblico. |
usermanaged |
string |
Gli indirizzi IP pubblici vengono forniti dall'utente e verranno usati per effettuare il provisioning dei nodi di calcolo. |
LinuxUserConfiguration
Proprietà usate per creare un account utente in un nodo di calcolo Linux.
Nome | Tipo | Descrizione |
---|---|---|
gid |
integer |
ID gruppo per l'account utente. |
sshPrivateKey |
string |
Chiave privata SSH per l'account utente. |
uid |
integer |
ID utente dell'account utente. |
LoginMode
Modalità di accesso per l'utente
Nome | Tipo | Descrizione |
---|---|---|
batch |
string |
La LOGON32_LOGON_BATCH modalità di accesso Win32. La modalità di accesso batch è consigliata per i processi paralleli a esecuzione prolungata. |
interactive |
string |
La LOGON32_LOGON_INTERACTIVE modalità di accesso Win32. Controllo dell'account utente è abilitato nei pool di Windows. Se questa opzione viene usata con un'identità utente con privilegi elevati in un pool di Windows, la sessione utente non verrà elevata a meno che l'applicazione eseguita dalla riga di comando Attività non sia configurata per richiedere sempre privilegi amministrativi o richiedere sempre privilegi massimi. |
ManagedDisk
Nome | Tipo | Descrizione |
---|---|---|
securityProfile |
Specifica le impostazioni del profilo di sicurezza per il disco gestito. |
|
storageAccountType |
Tipo di account di archiviazione per il disco gestito. |
MetadataItem
Coppia nome-valore associata a una risorsa del servizio Batch.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome dell'elemento di metadati. |
value |
string |
Valore dell'elemento di metadati. |
MountConfiguration
File system da montare in ogni nodo.
Nome | Tipo | Descrizione |
---|---|---|
azureBlobFileSystemConfiguration |
Contenitore di Archiviazione di Azure da montare usando BLOB FUSE in ogni nodo. |
|
azureFileShareConfiguration |
Condivisione file di Azure da montare in ogni nodo. |
|
cifsMountConfiguration |
File system CIFS/SMB da montare in ogni nodo. |
|
nfsMountConfiguration |
File system NFS da montare in ogni nodo. |
NetworkConfiguration
Configurazione di rete per un pool.
Nome | Tipo | Descrizione |
---|---|---|
dynamicVNetAssignmentScope |
Ambito dell'assegnazione dinamica della rete virtuale. |
|
enableAcceleratedNetworking |
boolean |
Indica se il pool deve abilitare la rete accelerata. |
endpointConfiguration |
Configurazione per gli endpoint nei nodi di calcolo nel pool di Batch. |
|
publicIPAddressConfiguration |
Configurazione IPAddress pubblica per i nodi di calcolo nel pool di batch. |
|
subnetId |
string |
Identificatore di risorsa ARM della subnet di rete virtuale a cui verranno aggiunti i nodi di calcolo del pool. Si tratta del formato /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. |
NetworkSecurityGroupRule
Regola del gruppo di sicurezza di rete da applicare a un endpoint in ingresso.
Nome | Tipo | Descrizione |
---|---|---|
access |
Azione da eseguire per un indirizzo IP, un intervallo di subnet o un tag specificati. |
|
priority |
integer |
Priorità per questa regola. |
sourceAddressPrefix |
string |
Prefisso o tag dell'indirizzo di origine da trovare per la regola. |
sourcePortRanges |
string[] |
Intervalli di porte di origine da trovare per la regola. |
NetworkSecurityGroupRuleAccess
Azione da eseguire per un indirizzo IP, un intervallo di subnet o un tag specificati.
Nome | Tipo | Descrizione |
---|---|---|
allow |
string |
Consentire l'accesso. |
deny |
string |
Negare l'accesso. |
NFSMountConfiguration
Informazioni utilizzate per connettersi a un file system NFS.
Nome | Tipo | Descrizione |
---|---|---|
mountOptions |
string |
Opzioni della riga di comando aggiuntive da passare al comando mount. |
relativeMountPath |
string |
Percorso relativo nel nodo di calcolo in cui verrà montato il file system |
source |
string |
URI del file system da montare. |
NodeCommunicationMode
Determina il modo in cui un pool comunica con il servizio Batch.
Nome | Tipo | Descrizione |
---|---|---|
classic |
string |
I nodi che usano la modalità di comunicazione classica richiedono la comunicazione TCP in ingresso sulle porte 29876 e 29877 da "BatchNodeManagement. Tag del servizio {region}" e comunicazione TCP in uscita sulla porta 443 per "Storage.region" e "BatchNodeManagement. Tag del servizio {region}". |
default |
string |
La modalità di comunicazione del nodo viene impostata automaticamente dal servizio Batch. |
simplified |
string |
I nodi che usano la modalità di comunicazione semplificata richiedono la comunicazione TCP in uscita sulla porta 443 a "BatchNodeManagement. Tag del servizio {region}". Non sono necessarie porte in ingresso aperte. |
NodePlacementConfiguration
Configurazione del posizionamento dei nodi per un pool.
Nome | Tipo | Descrizione |
---|---|---|
policy |
Tipo di criteri di posizionamento dei nodi nei pool batch. |
NodePlacementPolicyType
Criteri di posizionamento per l'allocazione dei nodi nel pool.
Nome | Tipo | Descrizione |
---|---|---|
regional |
string |
Tutti i nodi nel pool verranno allocati nella stessa area. |
zonal |
string |
I nodi nel pool verranno distribuiti in zone di disponibilità diverse con il bilanciamento ottimale. |
OSDisk
Impostazioni per il disco del sistema operativo del nodo di calcolo (VM).
Nome | Tipo | Descrizione |
---|---|---|
caching |
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 |
Dimensioni iniziali del disco in GB durante la creazione di un nuovo disco del sistema operativo. |
ephemeralOSDiskSettings |
Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal nodo di calcolo (VM). |
|
managedDisk |
Parametri del disco gestito. |
|
writeAcceleratorEnabled |
boolean |
Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco. |
PoolAddParameter
Pool nel servizio Azure Batch da aggiungere.
Nome | Tipo | Descrizione |
---|---|---|
applicationPackageReferences |
Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. |
|
autoScaleEvaluationInterval |
string |
Intervallo di tempo in cui modificare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica. |
autoScaleFormula |
string |
Formula per il numero desiderato di nodi di calcolo nel pool. |
certificateReferences |
Elenco di certificati da installare in ogni nodo di calcolo nel pool. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece 'estensione Azure KeyVault. |
|
displayName |
string |
Nome visualizzato del pool. |
enableAutoScale |
boolean |
Indica se le dimensioni del pool devono essere regolate automaticamente nel tempo. |
enableInterNodeCommunication |
boolean |
Indica se il pool consente la comunicazione diretta tra nodi di calcolo. |
id |
string |
Stringa che identifica in modo univoco il pool all'interno dell'account. |
metadata |
Elenco di coppie nome-valore associate al pool come metadati. |
|
mountConfiguration |
Montare l'archiviazione usando il file system specificato per l'intera durata del pool. |
|
networkConfiguration |
Configurazione di rete per il pool. |
|
resizeTimeout |
string |
Timeout per l'allocazione dei nodi di calcolo al pool. |
resourceTags |
object |
Tag specificati dall'utente associati al pool. |
startTask |
Un'attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool. |
|
targetDedicatedNodes |
integer |
Numero desiderato di nodi di calcolo dedicati nel pool. |
targetLowPriorityNodes |
integer |
Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. |
targetNodeCommunicationMode |
Modalità di comunicazione del nodo desiderata per il pool. |
|
taskSchedulingPolicy |
Modalità di distribuzione delle attività tra nodi di calcolo in un pool. |
|
taskSlotsPerNode |
integer |
Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool. |
upgradePolicy |
Criteri di aggiornamento per il pool. |
|
userAccounts |
Elenco di account utente da creare in ogni nodo di calcolo nel pool. |
|
virtualMachineConfiguration |
Configurazione della macchina virtuale per il pool. |
|
vmSize |
string |
Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni. |
PoolEndpointConfiguration
Configurazione dell'endpoint per un pool.
Nome | Tipo | Descrizione |
---|---|---|
inboundNATPools |
Elenco di pool NAT in ingresso che possono essere usati per gestire porte specifiche in un singolo nodo di calcolo esternamente. |
PublicIPAddressConfiguration
Configurazione dell'indirizzo IP pubblico della configurazione di rete di un pool.
Nome | Tipo | Descrizione |
---|---|---|
ipAddressIds |
string[] |
Elenco di indirizzi IP pubblici che verranno usati dal servizio Batch durante il provisioning dei nodi di calcolo. |
provision |
Tipo di provisioning per gli indirizzi IP pubblici per il pool. |
ResourceFile
Un singolo file o più file da scaricare in un nodo di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
autoStorageContainerName |
string |
Nome del contenitore di archiviazione nell'account di archiviazione automatico. |
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. |
fileMode |
string |
Attributo della modalità di autorizzazione file in formato ottale. |
filePath |
string |
Percorso nel nodo di calcolo in cui scaricare i file rispetto alla directory di lavoro dell'attività. |
httpUrl |
string |
URL del file da scaricare. |
identityReference |
Riferimento all'identità assegnata dall'utente da usare per accedere all'archiviazione BLOB di Azure specificata da storageContainerUrl o httpUrl |
|
storageContainerUrl |
string |
URL del contenitore BLOB all'interno di Archiviazione BLOB di Azure. |
RollingUpgradePolicy
Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.
Nome | Tipo | Descrizione |
---|---|---|
enableCrossZoneUpgrade |
boolean |
Consentire al set di scalabilità di macchine virtuali di ignorare i limiti az durante la creazione di batch di aggiornamento. Prendere in considerazione il dominio di aggiornamento e maxBatchInstancePercent per determinare le dimensioni del batch. Questo campo può essere impostato su true o false solo quando si usa NodePlacementConfiguration come Zonal. |
maxBatchInstancePercent |
integer |
Percentuale massima delle istanze totali di macchine virtuali che verranno aggiornate contemporaneamente dall'aggiornamento in sequenza in un unico batch. Poiché si tratta di un valore massimo, le istanze non integre nei batch precedenti o futuri possono causare la diminuzione della percentuale di istanze in un batch per garantire una maggiore affidabilità. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent. |
maxUnhealthyInstancePercent |
integer |
Percentuale massima delle istanze totali della macchina virtuale nel set di scalabilità che possono essere contemporaneamente non integre, in seguito all'aggiornamento o rilevate in uno stato non integro dai controlli di integrità della macchina virtuale prima dell'interruzione dell'aggiornamento in sequenza. Questo vincolo verrà controllato prima di avviare qualsiasi batch. Il valore di questo campo deve essere compreso tra 5 e 100 inclusi. Se vengono assegnati sia maxBatchInstancePercent che maxUnhealthyInstancePercent con valore, il valore di maxBatchInstancePercent non deve essere maggiore di maxUnhealthyInstancePercent. |
maxUnhealthyUpgradedInstancePercent |
integer |
Percentuale massima di istanze di macchina virtuale aggiornate che possono essere trovate in uno stato non integro. Questo controllo verrà eseguito dopo l'aggiornamento di ogni batch. Se questa percentuale viene mai superata, l'aggiornamento in sequenza viene interrotto. Il valore di questo campo deve essere compreso tra 0 e 100 inclusi. |
pauseTimeBetweenBatches |
string |
Tempo di attesa tra il completamento dell'aggiornamento per tutte le macchine virtuali in un batch e l'avvio del batch successivo. La durata dell'ora deve essere specificata nel formato ISO 8601. |
prioritizeUnhealthyInstances |
boolean |
Aggiornare tutte le istanze non integre in un set di scalabilità prima di qualsiasi istanza integra. |
rollbackFailedInstancesOnPolicyBreach |
boolean |
Il rollback delle istanze non riuscite nel modello precedente se i criteri di aggiornamento in sequenza vengono violati. |
SecurityEncryptionTypes
Specifica encryptionType del disco gestito. È impostato su VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostata solo per le macchine virtuali riservate ed è necessaria quando si usano macchine virtuali riservate.
Nome | Tipo | Descrizione |
---|---|---|
NonPersistedTPM |
string |
|
VMGuestStateOnly |
string |
SecurityProfile
Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.
Nome | Tipo | Descrizione |
---|---|---|
encryptionAtHost |
boolean |
Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Per altre informazioni sulla crittografia nei requisiti dell'host, vedere https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes. |
securityType |
Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. |
|
uefiSettings |
Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. |
SecurityTypes
Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings.
Nome | Tipo | Descrizione |
---|---|---|
confidentialVM |
string |
Il confidential computing di Azure offre macchine virtuali riservate per i tenant con requisiti di sicurezza e riservatezza elevati. Queste macchine virtuali offrono un limite sicuro e imposto dall'hardware per soddisfare le esigenze di sicurezza. È possibile usare macchine virtuali riservate per le migrazioni senza apportare modifiche al codice, con la piattaforma che protegge lo stato della macchina virtuale dalla lettura o dalla modifica. |
trustedLaunch |
string |
L'avvio attendibile protegge da tecniche di attacco avanzate e persistenti. |
ServiceArtifactReference
Specifica l'ID di riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID riferimento dell'artefatto del servizio di ServiceArtifactReference |
StartTask
Attività eseguita quando un nodo viene aggiunto a un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato l'immagine.
Nome | Tipo | Descrizione |
---|---|---|
commandLine |
string |
Riga di comando di StartTask. |
containerSettings |
Impostazioni per il contenitore in cui viene eseguito StartTask. |
|
environmentSettings |
Elenco delle impostazioni delle variabili di ambiente per StartTask. |
|
maxTaskRetryCount |
integer |
Numero massimo di tentativi dell'attività. |
resourceFiles |
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. |
|
userIdentity |
Identità utente con cui viene eseguito StartTask. |
|
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. |
StorageAccountType
Tipo di account di archiviazione da usare per la creazione di dischi dati o disco del sistema operativo.
Nome | Tipo | Descrizione |
---|---|---|
premium_lrs |
string |
Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale Premium. |
standard_lrs |
string |
Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale standard. |
standardssd_lrs |
string |
Il disco dati/disco del sistema operativo deve usare l'archiviazione con ridondanza locale ssd standard. |
TaskContainerSettings
Impostazioni del contenitore per un'attività.
Nome | Tipo | Descrizione |
---|---|---|
containerHostBatchBindMounts |
Percorsi da montare nell'attività contenitore. |
|
containerRunOptions |
string |
Opzioni aggiuntive per il comando create del contenitore. |
imageName |
string |
Immagine da usare per creare il contenitore in cui verrà eseguita l'attività. |
registry |
Registro privato che contiene l'immagine del contenitore. |
|
workingDirectory |
Percorso della directory di lavoro dell'attività del contenitore. |
TaskSchedulingPolicy
Specifica la modalità di distribuzione delle attività tra i nodi di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
nodeFillType |
Modalità di distribuzione delle attività tra nodi di calcolo in un pool. |
UefiSettings
Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale.
Nome | Tipo | Descrizione |
---|---|---|
secureBootEnabled |
boolean |
Specifica se l'avvio protetto deve essere abilitato nella macchina virtuale. |
vTpmEnabled |
boolean |
Specifica se vTPM deve essere abilitato nella macchina virtuale. |
UpgradeMode
Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità.
I valori possibili sono:
manuale: è possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade.
automatico: tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.
in sequenza: il set di scalabilità esegue gli aggiornamenti in batch con un tempo di pausa facoltativo tra di loro.
Nome | Tipo | Descrizione |
---|---|---|
automatic |
string |
Tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente. |
manual |
string |
È possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade. |
rolling |
string |
Le istanze esistenti in un set di scalabilità vengono abbassate in batch da aggiornare. Al termine del batch aggiornato, le istanze inizieranno a riprendere il traffico e il batch successivo inizierà. Questo continua fino a quando tutte le istanze non hanno portato up-to-date. |
UpgradePolicy
Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.
Nome | Tipo | Descrizione |
---|---|---|
automaticOSUpgradePolicy |
Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo. |
|
mode |
Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità. |
|
rollingUpgradePolicy |
Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza. |
UserAccount
Proprietà usate per creare un utente usato per eseguire attività in un nodo di calcolo di Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
elevationLevel |
Livello di elevazione dell'account utente. |
|
linuxUserConfiguration |
Configurazione utente specifica di Linux per l'account utente. |
|
name |
string |
Nome dell'account utente. I nomi possono contenere qualsiasi carattere Unicode fino a una lunghezza massima di 20. |
password |
string |
Password per l'account utente. |
windowsUserConfiguration |
Configurazione utente specifica di Windows per l'account utente. |
UserIdentity
Definizione dell'identità utente in cui viene eseguita l'attività.
Nome | Tipo | Descrizione |
---|---|---|
autoUser |
Utente automatico con cui viene eseguita l'attività. |
|
username |
string |
Nome dell'identità utente con cui viene eseguita l'attività. |
VirtualMachineConfiguration
Configurazione per i nodi di calcolo in un pool basato sull'infrastruttura di macchine virtuali di Azure.
Nome | Tipo | Descrizione |
---|---|---|
containerConfiguration |
Configurazione del contenitore per il pool. |
|
dataDisks |
Data |
Configurazione per i dischi dati collegati ai nodi di calcolo nel pool. |
diskEncryptionConfiguration |
Configurazione della crittografia del disco per il pool. |
|
extensions |
Estensione macchina virtuale per il pool. |
|
imageReference |
Riferimento all'immagine del Marketplace delle macchine virtuali di Azure o all'immagine di macchina virtuale personalizzata da usare. |
|
licenseType |
string |
Tipo di licenza locale da usare durante la distribuzione del sistema operativo. 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. |
nodePlacementConfiguration |
Configurazione del posizionamento del nodo per il pool. |
|
osDisk |
Impostazioni per il disco del sistema operativo della macchina virtuale. |
|
securityProfile |
Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali. |
|
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'. |
|
windowsConfiguration |
Impostazioni del sistema operativo Windows nella macchina virtuale. |
VMDiskSecurityProfile
Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostata solo per le macchine virtuali riservate e necessarie quando si usano macchine virtuali riservate.
Nome | Tipo | Descrizione |
---|---|---|
securityEncryptionType |
Specifica encryptionType del disco gestito. È impostato su VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostata solo per le macchine virtuali riservate ed è necessaria quando si usano macchine virtuali riservate. |
VMExtension
Configurazione per le estensioni della macchina virtuale.
Nome | Tipo | Descrizione |
---|---|---|
autoUpgradeMinorVersion |
boolean |
Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true. |
enableAutomaticUpgrade |
boolean |
Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione. |
name |
string |
Nome dell'estensione macchina virtuale. |
protectedSettings |
object |
L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta. |
provisionAfterExtensions |
string[] |
Raccolta di nomi di estensione. |
publisher |
string |
Nome del server di pubblicazione del gestore dell'estensione. |
settings |
object |
Impostazioni pubbliche in formato JSON per l'estensione. |
type |
string |
Tipo dell'estensione. |
typeHandlerVersion |
string |
Versione del gestore di script. |
WindowsConfiguration
Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.
Nome | Tipo | Descrizione |
---|---|---|
enableAutomaticUpdates |
boolean |
Indica se gli aggiornamenti automatici sono abilitati nella macchina virtuale. |
WindowsUserConfiguration
Proprietà usate per creare un account utente in un nodo di calcolo Windows.
Nome | Tipo | Descrizione |
---|---|---|
loginMode |
Modalità di accesso per l'utente |