Condividi tramite

Pool - Create

  • Riferimento
Servizio:
Batch Management
Versione API:
2024-07-01

Crea un nuovo pool all'interno dell'account specificato.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}?api-version=2024-07-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
 path True

string

Nome dell'account Batch.

Criterio di espressione regolare: ^[a-zA-Z0-9]+$
poolName
 path True

string

Nome del pool. Deve essere univoco all'interno dell'account.

Criterio di espressione regolare: ^[a-zA-Z0-9_-]+$
resourceGroupName
 path True

string

Nome del gruppo di risorse che contiene l'account Batch.
subscriptionId
 path True

string

ID sottoscrizione di Azure. Si tratta di una stringa in formato GUID (ad esempio 000000000-0000-0000-0000-000000000000000)
api-version
 query True

string

Versione dell'API da usare con la richiesta HTTP.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
If-Match

string

Versione dello stato dell'entità (ETag) del pool da aggiornare. È possibile usare il valore "*" per applicare l'operazione solo se il pool esiste già. Se omesso, questa operazione verrà sempre applicata.
If-None-Match

string

Impostare su '*' per consentire la creazione di un nuovo pool, ma per impedire l'aggiornamento di un pool esistente. Gli altri valori verranno ignorati.

Corpo della richiesta

Nome Tipo Descrizione
identity

BatchPoolIdentity

Tipo di identità usato per il pool di batch.
Tipo di identità usato per il pool di batch.
properties.applicationLicenses

string[]

L'elenco delle licenze dell'applicazione che il servizio Batch renderà disponibile in ogni nodo di calcolo del pool.
L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo.
properties.applicationPackages

ApplicationPackageReference[]

Elenco dei pacchetti dell'applicazione da installare in ogni nodo di calcolo del pool.
Le modifiche apportate ai riferimenti ai pacchetti dell'applicazione influiscono su tutti i nuovi nodi di calcolo che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool finché non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto dell'applicazione in un determinato pool.
properties.certificates

CertificateReference[]

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

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

DeploymentConfiguration

Questa proprietà descrive le macchine virtuali in cui verranno distribuiti i nodi del pool.
properties.displayName

string

Nome visualizzato per il pool.
Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
properties.interNodeCommunication

InterNodeCommunicationState

Indica se il pool consente la comunicazione diretta tra nodi.
Ciò impone restrizioni sui nodi che possono essere assegnati al pool. L'abilitazione di questo valore può ridurre la probabilità che il numero di nodi richiesto venga allocato nel pool. Se non specificato, il valore predefinito è 'Disabled'.
properties.metadata

MetadataItem[]

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

MountConfiguration[]

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

NetworkConfiguration

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

object

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

ScaleSettings

Impostazioni che configurano il numero di nodi nel pool.
Definisce le dimensioni desiderate del pool. Può trattarsi di "fixedScale" in cui è specificato targetDedicatedNodes richiesto oppure "autoScale" che definisce una formula che viene rivalutata periodicamente. Se questa proprietà non è specificata, il pool avrà una scala fissa con 0 targetDedicatedNodes.
properties.startTask

StartTask

Un'attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool.
In un'operazione PATCH (aggiornamento) questa proprietà può essere impostata su un oggetto vuoto per rimuovere l'attività di avvio dal pool.
properties.targetNodeCommunicationMode

NodeCommunicationMode

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

TaskSchedulingPolicy

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

integer

Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool.
Il valore predefinito è 1. Il valore massimo è minore di 4 volte il numero di core di vmSize del pool o 256.
properties.upgradePolicy

UpgradePolicy

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

UserAccount[]

Elenco di account utente da creare in ogni nodo del pool.
properties.vmSize

string

Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni.
Per informazioni sulle dimensioni delle macchine virtuali disponibili, vedere Dimensioni per le macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o dimensioni per le macchine virtuali (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).
tags

object

Tag della risorsa.

Risposte

Nome Tipo Descrizione
200 OK

Pool

Operazione riuscita. La risposta contiene l'entità del pool.

Intestazioni

ETag: string
Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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

Esempio

CreatePool - accelerated networking
CreatePool - Custom Image
CreatePool - Full VirtualMachineConfiguration
CreatePool - Minimal VirtualMachineConfiguration
CreatePool - No public IP
CreatePool - Public IPs
CreatePool - ResourceTags
CreatePool - SecurityProfile
CreatePool - Tags
CreatePool - UpgradePolicy
CreatePool - UserAssignedIdentities
CreatePool - VirtualMachineConfiguration Extensions
CreatePool - VirtualMachineConfiguration OSDisk
CreatePool - VirtualMachineConfiguration ServiceArtifactReference

CreatePool - accelerated networking

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D1_V2",
    "networkConfiguration": {
      "subnetId": "/subscriptions/subid/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123",
      "enableAcceleratedNetworking": true
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2016-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8DB46CB72A227E2"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8DB46CB72A227E2\"",
  "properties": {
    "lastModified": "2023-04-27T02:59:41.8592226Z",
    "creationTime": "2023-04-27T02:59:41.8592226Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-04-27T02:59:41.8592226Z",
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2023-04-27T03:00:34.0646502Z",
    "vmSize": "STANDARD_D1_V2",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2016-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64"
      }
    },
    "networkConfiguration": {
      "subnetId": "/subscriptions/subid/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123",
      "dynamicVnetAssignmentScope": "none",
      "enableAcceleratedNetworking": true
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 1,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-04-27T02:59:41.8592226Z"
    },
    "currentDedicatedNodes": 1,
    "currentLowPriorityNodes": 0,
    "currentNodeCommunicationMode": "Classic"
  }
}

CreatePool - Custom Image

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/subid/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8D4EDFEBFADF4AB"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8D4EDFEBFADF4AB\"",
  "properties": {
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/subid/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - Full VirtualMachineConfiguration

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2016-Datacenter-SmallDisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        },
        "licenseType": "Windows_Server",
        "dataDisks": [
          {
            "lun": 0,
            "caching": "ReadWrite",
            "diskSizeGB": 30,
            "storageAccountType": "Premium_LRS"
          },
          {
            "lun": 1,
            "caching": "None",
            "diskSizeGB": 200,
            "storageAccountType": "Standard_LRS"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [
            "OsDisk",
            "TemporaryDisk"
          ]
        },
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "osDisk": {
          "ephemeralOSDiskSettings": {
            "placement": "CacheDisk"
          }
        }
      }
    },
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "name": "testnat",
            "protocol": "TCP",
            "backendPort": 12001,
            "frontendPortRangeStart": 15000,
            "frontendPortRangeEnd": 15100,
            "networkSecurityGroupRules": [
              {
                "access": "Allow",
                "sourceAddressPrefix": "192.100.12.45",
                "priority": 150,
                "sourcePortRanges": [
                  "1",
                  "2"
                ]
              },
              {
                "access": "Deny",
                "sourceAddressPrefix": "*",
                "priority": 3500,
                "sourcePortRanges": [
                  "*"
                ]
              }
            ]
          }
        ]
      }
    },
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8D4EDFEBFADF4AB"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8D4EDFEBFADF4AB\"",
  "properties": {
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2016-Datacenter-SmallDisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        },
        "licenseType": "Windows_Server",
        "dataDisks": [
          {
            "lun": 0,
            "caching": "ReadWrite",
            "diskSizeGB": 30,
            "storageAccountType": "Premium_LRS"
          },
          {
            "lun": 1,
            "caching": "None",
            "diskSizeGB": 200,
            "storageAccountType": "Standard_LRS"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [
            "OsDisk",
            "TemporaryDisk"
          ]
        },
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        }
      }
    },
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "name": "testnat",
            "protocol": "TCP",
            "backendPort": 12001,
            "frontendPortRangeStart": 15000,
            "frontendPortRangeEnd": 15100,
            "networkSecurityGroupRules": [
              {
                "access": "Allow",
                "sourceAddressPrefix": "192.100.12.45",
                "priority": 150,
                "sourcePortRanges": [
                  "1",
                  "2"
                ]
              },
              {
                "access": "Deny",
                "sourceAddressPrefix": "*",
                "priority": 3500,
                "sourcePortRanges": [
                  "*"
                ]
              }
            ]
          }
        ]
      }
    },
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - Minimal VirtualMachineConfiguration

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "UbuntuServer",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8D4EDFEBFADF4AB"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8D4EDFEBFADF4AB\"",
  "properties": {
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "UbuntuServer",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - No public IP

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "networkConfiguration": {
      "subnetId": "/subscriptions/subid/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123",
      "publicIPAddressConfiguration": {
        "provision": "NoPublicIPAddresses"
      }
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/subid/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8D4EDFEBFADF4AB"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8D4EDFEBFADF4AB\"",
  "properties": {
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "networkConfiguration": {
      "subnetId": "/subscriptions/subid/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123",
      "publicIPAddressConfiguration": {
        "provision": "NoPublicIPAddresses"
      }
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/subid/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - Public IPs

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "networkConfiguration": {
      "subnetId": "/subscriptions/subid/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123",
      "publicIPAddressConfiguration": {
        "provision": "UserManaged",
        "ipAddressIds": [
          "/subscriptions/subid1/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
        ]
      }
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/subid/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8D4EDFEBFADF4AB"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8D4EDFEBFADF4AB\"",
  "properties": {
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "networkConfiguration": {
      "subnetId": "/subscriptions/subid/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123",
      "publicIPAddressConfiguration": {
        "provision": "UserManaged",
        "ipAddressIds": [
          "/subscriptions/subid1/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
        ]
      }
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/subid/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - ResourceTags

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "Standard_d4s_v3",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "UbuntuServer",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "resourceTags": {
      "TagName1": "TagValue1",
      "TagName2": "TagValue2"
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8DB554F8E08BCF4"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8DB554F8E08BCF4\"",
  "properties": {
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "vmSize": "STANDARD_D4S_V3",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "UbuntuServer",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 1,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-09-27T07:33:13.0625789Z"
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "resourceTags": {
      "TagName1": "TagValue1",
      "TagName2": "TagValue2"
    }
  }
}

CreatePool - SecurityProfile

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "Standard_d4s_v3",
    "deploymentConfiguration": {
      "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": null,
            "vTpmEnabled": false
          }
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8DB554F8E08BCF4"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8DB554F8E08BCF4\"",
  "properties": {
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "vmSize": "STANDARD_D4S_V3",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "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": {
            "vTpmEnabled": false
          }
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 1,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-06-14T07:03:58.3231917Z"
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - Tags

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "tags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  },
  "properties": {
    "vmSize": "Standard_d4s_v3",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 22.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8DB554F8E08BCF4"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8DB554F8E08BCF4\"",
  "properties": {
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "vmSize": "STANDARD_D4S_V3",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 22.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 1,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-09-27T07:33:13.0625789Z"
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  },
  "tags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  }
}

CreatePool - UpgradePolicy

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "Standard_d4s_v3",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "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

Codice di stato:
200 
ETag: W/"0x8DB51E64D3C3B69"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8DB51E64D3C3B69\"",
  "properties": {
    "lastModified": "2023-05-11T06:16:44.2372184Z",
    "creationTime": "2023-05-11T06:16:44.2372184Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
    "vmSize": "STANDARD_D4S_V3",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        },
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 2,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-05-11T06:16:44.2372184Z"
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "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
      }
    }
  }
}

CreatePool - UserAssignedIdentities

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "UbuntuServer",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
      "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8D4EDFEBFADF4AB"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8D4EDFEBFADF4AB\"",
  "properties": {
    "lastModified": "2020-10-01T10:22:55.9407275Z",
    "creationTime": "2020-10-01T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "UbuntuServer",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      },
      "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {
        "principalId": "principalId2",
        "clientId": "clientId2"
      }
    }
  }
}

CreatePool - VirtualMachineConfiguration Extensions

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    },
    "deploymentConfiguration": {
      "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"
            }
          }
        ]
      }
    },
    "targetNodeCommunicationMode": "Default"
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8D4EDFEBFADF4AB"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8D4EDFEBFADF4AB\"",
  "properties": {
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "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"
            }
          }
        ]
      }
    },
    "targetNodeCommunicationMode": "Default"
  }
}

CreatePool - VirtualMachineConfiguration OSDisk

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "Standard_d2s_v3",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "microsoftwindowsserver",
          "offer": "windowsserver",
          "sku": "2022-datacenter-smalldisk"
        },
        "osDisk": {
          "diskSizeGB": 100,
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "caching": "ReadWrite",
          "writeAcceleratorEnabled": false
        },
        "nodeAgentSkuId": "batch.node.windows amd64"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8DB51F14DC1A8AD"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8DB51F396992B8D\"",
  "properties": {
    "lastModified": "2023-08-24T02:12:27.7527697Z",
    "creationTime": "2023-08-24T02:12:27.7527697Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
    "vmSize": "STANDARD_D2_V3",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "microsoftwindowsserver",
          "offer": "windowsserver",
          "sku": "2022-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "diskSizeGB": 100,
          "writeAcceleratorEnabled": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 1,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-08-24T02:12:27.7527697Z"
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - VirtualMachineConfiguration ServiceArtifactReference

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "vmSize": "Standard_d4s_v3",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        },
        "serviceArtifactReference": {
          "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "upgradePolicy": {
      "mode": "automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
ETag: W/"0x8DB51F14DC1A8AD"
{
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "name": "mypool41",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "etag": "W/\"0x8DB51F396992B8D\"",
  "properties": {
    "lastModified": "2023-05-11T07:44:44.8580493Z",
    "creationTime": "2023-05-11T07:44:44.8580493Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
    "vmSize": "STANDARD_D4S_V3",
    "interNodeCommunication": "Disabled",
    "taskSlotsPerNode": 1,
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        },
        "serviceArtifactReference": {
          "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 2,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-05-11T07:44:44.8580493Z"
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "upgradePolicy": {
      "mode": "automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    }
  }
}

Definizioni

Nome Descrizione
AllocationState

Indica se il pool sta ridimensionando.
ApplicationPackageReference

Collegamento a un pacchetto dell'applicazione all'interno dell'account batch
AutomaticOSUpgradePolicy

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

Risultati ed errori da un'esecuzione di una formula di scalabilità automatica del pool.
AutoScaleRunError

Errore che si è verificato durante la scalabilità automatica di un pool.
AutoScaleSettings

Impostazioni di scalabilità automatica per il pool.
AutoUserScope

Ambito dell'utente automatico
AutoUserSpecification

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

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

Informazioni usate per connettersi a una condivisione file di Azure.
BatchPoolIdentity

Identità del pool di Batch, se configurata. Se l'identità del pool viene aggiornata durante l'aggiornamento di un pool esistente, solo le nuove macchine virtuali create dopo che il pool viene ridotto a 0 avranno le identità aggiornate
CachingType

Tipo di memorizzazione nella cache da abilitare per il disco.
CertificateReference

Riferimento a un certificato da installare nei nodi di calcolo in un pool. Deve esistere all'interno dello stesso account del pool.
CertificateStoreLocation

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

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

Informazioni utilizzate per connettersi a un file system CIFS.
CloudError

Risposta di errore dal servizio Batch.
CloudErrorBody

Risposta di errore dal servizio Batch.
ComputeNodeDeallocationOption

Determina le operazioni da eseguire con un nodo e le relative attività in esecuzione dopo che è stata selezionata per la deallocazione.
ComputeNodeFillType

Modalità di distribuzione delle attività tra i nodi di calcolo.
ComputeNodeIdentityReference

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

Configurazione per i pool abilitati per i contenitori.
ContainerHostBatchBindMountEntry

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

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

Registro contenitori privato.
ContainerType

Tecnologia contenitore da usare.
ContainerWorkingDirectory

Flag per indicare dove si trova la directory di lavoro dell'attività contenitore. Il valore predefinito è 'taskWorkingDirectory'.
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.
DeploymentConfiguration

Proprietà di configurazione della distribuzione.
DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutte le macchine virtuali nel pool.
DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.
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 macchina virtuale o l'immagine della raccolta di calcolo di Azure.
DiskEncryptionTarget

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

Ambito dell'assegnazione dinamica della rete virtuale.
ElevationLevel

Livello di elevazione dell'utente.
EnvironmentSetting

Variabile di ambiente da impostare in un processo di attività.
FixedScaleSettings

Impostazioni di scalabilità fisse per il pool.
ImageReference

Riferimento a un'immagine di Azure Virtual Machines Marketplace o alla risorsa Immagine di Azure di una macchina virtuale personalizzata. Per ottenere l'elenco di tutte le immaginiReference verificate da Azure Batch, vedere l'operazione "Elenca gli SKU dell'agente del nodo supportati".
InboundEndpointProtocol

Protocollo dell'endpoint.
InboundNatPool

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

Indica se il pool consente la comunicazione diretta tra nodi.
IPAddressProvisioningType

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

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

Modalità di accesso per l'utente
ManagedDisk
MetadataItem

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

File system da montare in ogni nodo.
NetworkConfiguration

Configurazione di rete per un pool.
NetworkSecurityGroupRule

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

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

Informazioni utilizzate per connettersi a un file system NFS.
NodeCommunicationMode

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

Configurazione del posizionamento dei nodi per i pool batch.
NodePlacementPolicyType

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

Impostazioni per il disco del sistema operativo della macchina virtuale.
Pool

Contiene informazioni su un pool.
PoolEndpointConfiguration

Configurazione dell'endpoint per un pool.
PoolIdentityType

Tipo di identità usato per il pool di batch.
PoolProvisioningState

Stato corrente del pool.
PublicIPAddressConfiguration

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

Errore che si è verificato durante il ridimensionamento di un pool.
ResizeOperationStatus

Dettagli sull'operazione di ridimensionamento corrente o dell'ultima operazione di ridimensionamento completata.
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.
ScaleSettings

Impostazioni di scalabilità per il pool
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 e necessarie quando si usano macchine virtuali riservate.
SecurityProfile

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

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

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

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

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

Impostazioni del contenitore per un'attività.
TaskSchedulingPolicy

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

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

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

I valori possibili sono:

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

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

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

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

Proprietà usate per creare un utente in un nodo di Azure Batch.
UserAssignedIdentities

Elenco delle identità utente associate.
UserIdentity

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

Specifica le impostazioni del profilo di sicurezza per il disco gestito. 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.
WindowsConfiguration

Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.
WindowsUserConfiguration

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

AllocationState

Indica se il pool sta ridimensionando.

Nome Tipo Descrizione
Resizing

string

Il pool sta ridimensionando; ovvero i nodi di calcolo vengono aggiunti o rimossi dal pool.
Steady

string

Il pool non viene ridimensionato. Non sono state apportate modifiche al numero di nodi nel pool in corso. Un pool entra in questo stato quando viene creato e quando non viene eseguita alcuna operazione nel pool per modificare il numero di nodi.
Stopping

string

Il ridimensionamento del pool, ma l'utente ha richiesto che il ridimensionamento venga arrestato, ma la richiesta di arresto non è ancora stata completata.

ApplicationPackageReference

Collegamento a un pacchetto dell'applicazione all'interno dell'account batch

Nome Tipo Descrizione
id

string

ID del pacchetto dell'applicazione da installare. Deve trovarsi nello stesso account batch del pool. Può trattarsi di un riferimento a una versione specifica o alla versione predefinita, se presente.
version

string

Versione dell'applicazione da distribuire. Se omesso, viene distribuita la versione predefinita.
Se l'operazione viene omessa e non viene specificata alcuna versione predefinita per questa applicazione, la richiesta ha esito negativo con il codice di errore InvalidApplicationPackageReferences. Se si chiama direttamente l'API REST, il codice di stato HTTP è 409.

AutomaticOSUpgradePolicy

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

Nome Tipo Descrizione
disableAutomaticRollback

boolean

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

boolean

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

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

boolean

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

boolean

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

AutoScaleRun

Risultati ed errori da un'esecuzione di una formula di scalabilità automatica del pool.

Nome Tipo Descrizione
error

AutoScaleRunError

Dettagli dell'errore rilevato durante la valutazione della formula di scalabilità automatica nel pool, se la valutazione non è riuscita.
evaluationTime

string

Ora dell'ultima valutazione della formula di scalabilità automatica.
results

string

Valori finali di tutte le variabili usate nella valutazione della formula di scalabilità automatica.
Ogni valore della variabile viene restituito nel formato $variable=value e le variabili sono separate da punti e virgola.

AutoScaleRunError

Errore che si è verificato durante la scalabilità automatica di un pool.

Nome Tipo Descrizione
code

string

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

AutoScaleRunError[]

Altri dettagli sull'errore.
message

string

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

AutoScaleSettings

Impostazioni di scalabilità automatica per il pool.

Nome Tipo Descrizione
evaluationInterval

string

Intervallo di tempo in cui regolare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica.
Se omesso, il valore predefinito è 15 minuti (PT15M).
formula

string

Formula per il numero desiderato di nodi di calcolo nel pool.

AutoUserScope

Ambito dell'utente automatico

Nome Tipo Descrizione
Pool

string

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

string

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

AutoUserSpecification

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

Nome Tipo Descrizione
elevationLevel

ElevationLevel

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

AutoUserScope

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

AzureBlobFileSystemConfiguration

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

Nome Tipo Descrizione
accountKey

string

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

string

Nome dell'account di archiviazione di Azure.
blobfuseOptions

string

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

string

Nome del contenitore di Archiviazione BLOB di Azure.
identityReference

ComputeNodeIdentityReference

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

string

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

string

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

AzureFileShareConfiguration

Informazioni usate per connettersi a una condivisione file di Azure.

Nome Tipo Descrizione
accountKey

string

Chiave dell'account di archiviazione di Azure.
accountName

string

Nome dell'account di archiviazione di Azure.
azureFileUrl

string

URL di File di Azure.
Si tratta del formato 'https://{account}.file.core.windows.net/'.
mountOptions

string

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

string

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

BatchPoolIdentity

Identità del pool di Batch, se configurata. Se l'identità del pool viene aggiornata durante l'aggiornamento di un pool esistente, solo le nuove macchine virtuali create dopo che il pool viene ridotto a 0 avranno le identità aggiornate

Nome Tipo Descrizione
type

PoolIdentityType

Tipo di identità usato per il pool di batch.
userAssignedIdentities

<string,  UserAssignedIdentities>

Elenco di identità utente associate al pool di Batch.

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. Deve esistere all'interno dello stesso account del pool.

Nome Tipo Descrizione
id

string

ID completo del certificato da installare nel pool. Deve trovarsi nello stesso account batch del pool.
storeLocation

CertificateStoreLocation

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

string

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

CertificateVisibility[]

Gli 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

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

string

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

string

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

CIFSMountConfiguration

Informazioni utilizzate per connettersi a un file system CIFS.

Nome Tipo Descrizione
mountOptions

string

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

string

Password da usare per l'autenticazione nel file system CIFS.
relativeMountPath

string

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

string

URI del file system da montare.
userName

string

Utente da usare per l'autenticazione nel file system CIFS.

CloudError

Risposta di errore dal servizio Batch.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo della risposta di errore.

CloudErrorBody

Risposta di errore dal servizio Batch.

Nome Tipo Descrizione
code

string

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

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.
message

string

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

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

ComputeNodeDeallocationOption

Determina le operazioni da eseguire con un nodo e le relative attività in esecuzione dopo che è stata selezionata per la deallocazione.

Nome Tipo Descrizione
Requeue

string

Terminare l'esecuzione dei processi delle attività e rieseguere la coda delle attività. Le attività verranno eseguite di nuovo quando è disponibile un nodo. Rimuovere i nodi non appena le attività sono state terminate.
RetainedData

string

Consentire il completamento delle attività attualmente in esecuzione, quindi attendere la scadenza di tutti i periodi di conservazione dei dati delle attività. Non pianificare nuove attività durante l'attesa. Rimuovere i nodi quando tutti i periodi di conservazione delle attività sono scaduti.
TaskCompletion

string

Consenti il completamento delle attività attualmente in esecuzione. Non pianificare nuove attività durante l'attesa. Rimuovere i nodi al termine di tutte le attività.
Terminate

string

Terminare le attività in esecuzione. Le attività verranno completate con failureInfo che indica che sono state terminate e non verranno eseguite di nuovo. Rimuovere i nodi non appena le attività sono state terminate.

ComputeNodeFillType

Modalità di distribuzione delle attività tra i nodi di calcolo.

Nome Tipo Descrizione
Pack

string

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

string

Le attività devono essere assegnate in modo uniforme in tutti i nodi del 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 immagini del contenitore.
Questo è il riferimento completo all'immagine, come sarebbe stato specificato in "docker pull". Un'immagine verrà generata dal registro Docker predefinito, a meno che l'immagine non sia completamente qualificata con un registro alternativo.
containerRegistries

ContainerRegistry[]

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

ContainerType

Tecnologia contenitore da usare.

ContainerHostBatchBindMountEntry

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

Nome Tipo Descrizione
isReadOnly

boolean

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

ContainerHostDataPath

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

ContainerHostDataPath

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

Nome Tipo Descrizione
Applications

string

Percorso delle applicazioni.
JobPrep

string

Percorso dell'attività di preparazione del processo.
Shared

string

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

string

Percorso dell'attività di avvio.
Task

string

Percorso dell'attività.
VfsMounts

string

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

ContainerRegistry

Registro contenitori privato.

Nome Tipo Descrizione
identityReference

ComputeNodeIdentityReference

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

string

Password per accedere al server del Registro di sistema.
registryServer

string

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

string

Nome utente per accedere al server del Registro di sistema.

ContainerType

Tecnologia contenitore da usare.

Nome Tipo Descrizione
CriCompatible

string

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

string

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

ContainerWorkingDirectory

Flag per indicare dove si trova la directory di lavoro dell'attività contenitore. Il valore predefinito è 'taskWorkingDirectory'.

Nome Tipo Descrizione
ContainerImageDefault

string

Uso della directory di lavoro definita dall'immagine del contenitore. Tenere presente che questa directory non conterrà i file di risorse scaricati da Batch.
TaskWorkingDirectory

string

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

DataDisk

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

Nome Tipo Descrizione
caching

CachingType

Tipo di memorizzazione nella cache da abilitare per i dischi dati.
I valori sono:

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.

Il valore predefinito per la memorizzazione nella cache non è nessuno. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB

integer

Dimensioni iniziali del disco in GB durante la creazione di un nuovo disco dati.
lun

integer

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

StorageAccountType

Tipo di account di archiviazione da usare per il disco dati.
Se omesso, il valore predefinito è "Standard_LRS". I valori sono:

Standard_LRS: il disco dati deve usare l'archiviazione con ridondanza locale standard. Premium_LRS: il disco dati deve usare l'archiviazione con ridondanza locale Premium.

DeploymentConfiguration

Proprietà di configurazione della distribuzione.

Nome Tipo Descrizione
virtualMachineConfiguration

VirtualMachineConfiguration

Configurazione della macchina virtuale per il pool.

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo per tutte le macchine virtuali 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 dalla macchina virtuale.

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 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 altre informazioni sui requisiti delle dimensioni del disco del sistema operativo temporaneo, vedere Requisiti delle dimensioni del disco del sistema operativo temporaneo per le macchine virtuali Windows in https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e macchine virtuali Linux all'indirizzo https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

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

Nome Tipo Descrizione
targets

DiskEncryptionTarget[]

L'elenco delle destinazioni disco del servizio Batch crittograferà nel nodo di calcolo
Nel pool Linux è supportato solo "TemporaryDisk". nel pool di Windows è necessario specificare "OsDisk" e "TemporaryDisk".

DiskEncryptionTarget

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

Nome Tipo Descrizione
OsDisk

string

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

string

Il disco temporaneo nel nodo di calcolo è crittografato. In Linux questa crittografia si applica ad altre partizioni (ad esempio quelle 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. Se questo valore è impostato, è necessario impostare anche l'ID subnet di configurazione di rete. Questa funzionalità richiede l'approvazione prima dell'uso. Contattare il supporto tecnico
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 di attività.

Nome Tipo Descrizione
name

string

Nome della variabile di ambiente.
value

string

Valore della variabile di ambiente.

FixedScaleSettings

Impostazioni di scalabilità fisse per il pool.

Nome Tipo Valore predefinito Descrizione
nodeDeallocationOption

ComputeNodeDeallocationOption

Determina le operazioni da eseguire con un nodo e le relative attività in esecuzione se le dimensioni del pool diminuiscono.
Se omesso, il valore predefinito è Requeue.
resizeTimeout

string

PT15M

Timeout per l'allocazione dei nodi di calcolo al pool.
Il valore predefinito è 15 minuti. I valori di timeout usano il formato ISO 8601. Ad esempio, usare PT10M per 10 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).
targetDedicatedNodes

integer

Numero desiderato di nodi di calcolo dedicati nel pool.
Almeno uno di targetDedicatedNodes, targetLowPriorityNodes deve essere impostato.
targetLowPriorityNodes

integer

Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool.
Almeno uno di targetDedicatedNodes, targetLowPriorityNodes deve essere impostato.

ImageReference

Riferimento a un'immagine di Azure Virtual Machines Marketplace o alla risorsa Immagine di Azure di una macchina virtuale personalizzata. Per ottenere l'elenco di tutte le immaginiReference verificate da Azure Batch, vedere l'operazione "Elenca gli SKU dell'agente del nodo supportati".

Nome Tipo Descrizione
communityGalleryImageId

string

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

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}.
Questa proprietà si escludono a vicenda con altre proprietà. L'immagine della raccolta di calcolo di Azure deve avere repliche nella stessa area dell'account Azure Batch. Per informazioni sulle impostazioni del firewall per l'agente del nodo Batch per comunicare con il servizio Batch, vedere https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.
offer

string

Tipo di offerta dell'immagine di Azure Virtual Machines Marketplace.
Ad esempio, UbuntuServer o WindowsServer.
publisher

string

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

string

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

string

SKU dell'immagine marketplace di Macchine virtuali di Azure.
Ad esempio, 18.04-LTS o 2022-datacenter.
version

string

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

InboundEndpointProtocol

Protocollo dell'endpoint.

Nome Tipo Descrizione
TCP

string

Usare TCP per l'endpoint.
UDP

string

Usare UDP per l'endpoint.

InboundNatPool

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

Nome Tipo Descrizione
backendPort

integer

Numero di porta nel nodo di calcolo.
Deve essere univoco all'interno di un pool di Batch. I valori accettabili sono compresi tra 1 e 65535 ad eccezione 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

Ultimo numero di porta nell'intervallo di porte esterne che verranno usate per fornire l'accesso in ingresso al back-endPort nei singoli nodi di calcolo.
I valori accettabili sono compresi tra 1 e 65534 ad eccezione delle porte comprese tra 50000 e 55000 riservate dal servizio Batch. Tutti gli intervalli all'interno di un pool devono essere distinti e non possono sovrapporsi. Se vengono forniti valori riservati o sovrapposti, la richiesta ha esito negativo con codice di stato HTTP 400.
frontendPortRangeStart

integer

Primo numero di porta nell'intervallo di porte esterne che verranno usate per fornire l'accesso in ingresso al back-endPort nei singoli nodi di calcolo.
I valori accettabili sono compresi tra 1 e 65534, ad eccezione delle porte da 50000 a 55000 riservate. Tutti gli intervalli all'interno di un pool devono essere distinti e non possono sovrapporsi. Se vengono forniti valori riservati o sovrapposti, la richiesta ha esito negativo con codice di stato HTTP 400.
name

string

Nome dell'endpoint.
Il nome deve essere univoco all'interno di un pool di Batch, può contenere lettere, numeri, caratteri di sottolineatura, punti e trattini. I nomi devono iniziare con una lettera o un numero, devono terminare con una lettera, un numero o un carattere di sottolineatura e non possono superare 77 caratteri. Se vengono forniti valori non validi, la richiesta ha esito negativo con codice di stato HTTP 400.
networkSecurityGroupRules

NetworkSecurityGroupRule[]

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

InboundEndpointProtocol

Protocollo dell'endpoint.

InterNodeCommunicationState

Indica se il pool consente la comunicazione diretta tra nodi.

Nome Tipo Descrizione
Disabled

string

Disabilitare la comunicazione di rete tra macchine virtuali.
Enabled

string

Abilitare la comunicazione di rete tra macchine virtuali.

IPAddressProvisioningType

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

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 per i nodi di calcolo nel pool.
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 Linux.

Nome Tipo Descrizione
gid

integer

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

string

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

integer

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

LoginMode

Modalità di accesso per l'utente

Nome Tipo Descrizione
Batch

string

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

string

La LOGON32_LOGON_INTERACTIVE modalità di accesso Win32. Alcune applicazioni richiedono autorizzazioni associate alla modalità di accesso interattivo. Se questo è il caso di un'applicazione usata nell'attività, questa opzione è consigliata.

ManagedDisk

Nome Tipo Descrizione
securityProfile

VMDiskSecurityProfile

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

StorageAccountType

Tipo di account di archiviazione per il disco gestito.

MetadataItem

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

Nome Tipo Descrizione
name

string

Nome dell'elemento di metadati.
value

string

Valore dell'elemento di metadati.

MountConfiguration

File system da montare in ogni nodo.

Nome Tipo Descrizione
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

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

AzureFileShareConfiguration

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

CIFSMountConfiguration

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

NFSMountConfiguration

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

NetworkConfiguration

Configurazione di rete per un pool.

Nome Tipo Valore predefinito Descrizione
dynamicVnetAssignmentScope

DynamicVNetAssignmentScope

none

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

PoolEndpointConfiguration

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

PublicIPAddressConfiguration

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

string

Identificatore di risorsa ARM della subnet di rete virtuale a cui verranno aggiunti i nodi di calcolo del pool. Si tratta del formato /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.
La rete virtuale deve trovarsi nella stessa area e nella stessa sottoscrizione dell'account Azure Batch. La subnet specificata deve avere indirizzi IP liberi sufficienti per contenere il numero di nodi nel pool. Se la subnet non dispone di un numero sufficiente di indirizzi IP liberi, il pool allocherà parzialmente i nodi di calcolo e si verificherà un errore di ridimensionamento. L'entità servizio "MicrosoftAzureBatch" deve avere il ruolo "Collaboratore macchina virtuale classica" Role-Based controllo di accesso (RBAC) per la rete virtuale specificata. La subnet specificata deve consentire la comunicazione dal servizio Azure Batch per poter pianificare le attività nei nodi di calcolo. 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 di calcolo nella subnet specificata viene negata da un gruppo di sicurezza di rete, il servizio Batch imposta lo stato dei nodi di calcolo su inutilizzabile. Se la rete virtuale specificata include gruppi di sicurezza di rete associati, è necessario abilitare alcune porte di sistema riservate per la comunicazione in ingresso, incluse le porte 29876 e 29877. Abilitare anche le connessioni in uscita ad Archiviazione di Azure sulla porta 443. Per altri dettagli, vedere: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

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

Nome Tipo Descrizione
access

NetworkSecurityGroupRuleAccess

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

integer

Priorità per questa regola.
Le priorità all'interno di un pool devono essere univoche e vengono valutate in ordine di priorità. Minore è il numero maggiore della priorità. Ad esempio, è possibile specificare regole con numeri di ordine pari a 150, 250 e 350. La regola con il numero di ordine 150 ha la precedenza sulla regola con un ordine pari a 250. Le priorità consentite sono da 150 a 4096. Se vengono forniti valori riservati o duplicati, la richiesta ha esito negativo con codice di stato HTTP 400.
sourceAddressPrefix

string

Prefisso o tag dell'indirizzo di origine da trovare per la regola.
I valori validi sono un singolo indirizzo IP (ad esempio 10.10.10.10), una subnet IP (ad esempio 192.168.1.0/24), un tag predefinito o * (per tutti gli indirizzi). Se vengono forniti altri valori, la richiesta ha esito negativo con codice di stato HTTP 400.
sourcePortRanges

string[]

Intervalli di porte di origine da trovare per la regola.
I valori validi sono '*' (per tutte le porte da 0 a 65535) o matrici di porte o intervalli di porte (ad esempio 100-200). Le porte devono essere incluse nell'intervallo compreso tra 0 e 65535 e gli intervalli di porte o le porte non possono sovrapporsi. Se vengono forniti altri valori, la richiesta ha esito negativo con codice di stato HTTP 400. Il valore predefinito sarà *.

NetworkSecurityGroupRuleAccess

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

Nome Tipo Descrizione
Allow

string

Consentire l'accesso.
Deny

string

Negare l'accesso.

NFSMountConfiguration

Informazioni utilizzate per connettersi a un file system NFS.

Nome Tipo Descrizione
mountOptions

string

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

string

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

string

URI del file system da montare.

NodeCommunicationMode

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

Nome Tipo Descrizione
Classic

string

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

string

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

string

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

NodePlacementConfiguration

Configurazione del posizionamento dei nodi per i pool batch.

Nome Tipo Descrizione
policy

NodePlacementPolicyType

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

NodePlacementPolicyType

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

Nome Tipo Descrizione
Regional

string

Tutti i nodi nel pool verranno allocati nella stessa area.
Zonal

string

I nodi nel pool verranno distribuiti in zone diverse con il bilanciamento del carico ottimale.

OSDisk

Impostazioni per il disco del sistema operativo della macchina virtuale.

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

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

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.
managedDisk

ManagedDisk

Parametri del disco gestito.
writeAcceleratorEnabled

boolean

Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

Pool

Contiene informazioni su un pool.

Nome Tipo Valore predefinito Descrizione
etag

string

ETag della risorsa, usata per le istruzioni di concorrenza.
id

string

ID della risorsa.
identity

BatchPoolIdentity

Tipo di identità usato per il pool di batch.
Tipo di identità usato per il pool di batch.
name

string

Nome della risorsa.
properties.allocationState

AllocationState

Indica se il pool sta ridimensionando.
properties.allocationStateTransitionTime

string

Ora in cui il pool ha immesso lo stato di allocazione corrente.
properties.applicationLicenses

string[]

L'elenco delle licenze dell'applicazione che il servizio Batch renderà disponibile in ogni nodo di calcolo del pool.
L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo.
properties.applicationPackages

ApplicationPackageReference[]

Elenco dei pacchetti dell'applicazione da installare in ogni nodo di calcolo del pool.
Le modifiche apportate ai riferimenti ai pacchetti dell'applicazione influiscono su tutti i nuovi nodi di calcolo che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool finché non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto dell'applicazione in un determinato pool.
properties.autoScaleRun

AutoScaleRun

Risultati ed errori dell'ultima esecuzione della formula di scalabilità automatica.
Questa proprietà viene impostata solo se il pool viene ridimensionato automaticamente, ad esempio autoScaleSettings.
properties.certificates

CertificateReference[]

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

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

string

Ora di creazione del pool.
properties.currentDedicatedNodes

integer

Numero di nodi di calcolo dedicati attualmente presenti nel pool.
properties.currentLowPriorityNodes

integer

Numero di nodi di calcolo spot/con priorità bassa attualmente presenti nel pool.
properties.currentNodeCommunicationMode

NodeCommunicationMode

Stato corrente della modalità di comunicazione del pool.
properties.deploymentConfiguration

DeploymentConfiguration

Questa proprietà descrive le macchine virtuali in cui verranno distribuiti i nodi del pool.
properties.displayName

string

Nome visualizzato per il pool.
Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
properties.interNodeCommunication

InterNodeCommunicationState

Indica se il pool consente la comunicazione diretta tra nodi.
Ciò impone restrizioni sui nodi che possono essere assegnati al pool. L'abilitazione di questo valore può ridurre la probabilità che il numero di nodi richiesto venga allocato nel pool. Se non specificato, il valore predefinito è 'Disabled'.
properties.lastModified

string

Ora dell'ultima modifica del pool.
Questa è l'ultima volta in cui i dati a livello di pool, ad esempio targetDedicatedNodes o autoScaleSettings, sono stati modificati. Non influisce su modifiche a livello di nodo, ad esempio uno stato di modifica del nodo di calcolo.
properties.metadata

MetadataItem[]

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

MountConfiguration[]

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

NetworkConfiguration

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

PoolProvisioningState

Stato corrente del pool.
properties.provisioningStateTransitionTime

string

Ora in cui il pool ha immesso lo stato corrente.
properties.resizeOperationStatus

ResizeOperationStatus

Contiene informazioni dettagliate sull'operazione di ridimensionamento corrente o dell'ultima operazione di ridimensionamento completata.
Descrive l'operazione corrente (se il pool AllocationState sta ridimensionando) o l'operazione completata in precedenza (se AllocationState è Stabile).
properties.resourceTags

object

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

ScaleSettings

Impostazioni che configurano il numero di nodi nel pool.
Definisce le dimensioni desiderate del pool. Può trattarsi di "fixedScale" in cui è specificato targetDedicatedNodes richiesto oppure "autoScale" che definisce una formula che viene rivalutata periodicamente. Se questa proprietà non è specificata, il pool avrà una scala fissa con 0 targetDedicatedNodes.
properties.startTask

StartTask

Un'attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool.
In un'operazione PATCH (aggiornamento) questa proprietà può essere impostata su un oggetto vuoto per rimuovere l'attività di avvio dal pool.
properties.targetNodeCommunicationMode

NodeCommunicationMode

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

TaskSchedulingPolicy

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

integer

1

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

UpgradePolicy

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

UserAccount[]

Elenco di account utente da creare in ogni nodo del pool.
properties.vmSize

string

Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni.
Per informazioni sulle dimensioni delle macchine virtuali disponibili, vedere Dimensioni per le macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o dimensioni per le macchine virtuali (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).
tags

object

Tag della risorsa.
type

string

Tipo della risorsa.

PoolEndpointConfiguration

Configurazione dell'endpoint per un pool.

Nome Tipo Descrizione
inboundNatPools

InboundNatPool[]

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

PoolIdentityType

Tipo di identità usato per il pool di batch.

Nome Tipo Descrizione
None

string

Al pool di Batch non è associata alcuna identità. L'impostazione None nel pool di aggiornamenti rimuoverà le identità esistenti.
UserAssigned

string

Al pool di Batch sono associate identità assegnate dall'utente.

PoolProvisioningState

Stato corrente del pool.

Nome Tipo Descrizione
Deleting

string

L'utente ha richiesto l'eliminazione del pool, ma l'operazione di eliminazione non è ancora stata completata.
Succeeded

string

Il pool è disponibile per eseguire attività soggette alla disponibilità dei nodi di calcolo.

PublicIPAddressConfiguration

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

Nome Tipo Descrizione
ipAddressIds

string[]

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

IPAddressProvisioningType

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

ResizeError

Errore che si è verificato durante il ridimensionamento di un pool.

Nome Tipo Descrizione
code

string

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

ResizeError[]

Altri dettagli sull'errore.
message

string

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

ResizeOperationStatus

Dettagli sull'operazione di ridimensionamento corrente o dell'ultima operazione di ridimensionamento completata.

Nome Tipo Descrizione
errors

ResizeError[]

Dettagli di eventuali errori riscontrati durante l'ultima operazione di ridimensionamento nel pool.
Questa proprietà viene impostata solo se si è verificato un errore durante l'ultimo ridimensionamento del pool e solo quando allocationState del pool è Steady.
nodeDeallocationOption

ComputeNodeDeallocationOption

Determina le operazioni da eseguire con un nodo e le relative attività in esecuzione se le dimensioni del pool diminuiscono.
Il valore predefinito è requeue.
resizeTimeout

string

Timeout per l'allocazione dei nodi di calcolo al pool o rimozione dei nodi di calcolo dal pool.
Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
startTime

string

Ora di avvio dell'operazione di ridimensionamento.
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.

ResourceFile

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

Nome Tipo Descrizione
autoStorageContainerName

string

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

string

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

string

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

string

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

string

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

ComputeNodeIdentityReference

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

string

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

RollingUpgradePolicy

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

Nome Tipo Descrizione
enableCrossZoneUpgrade

boolean

Consentire al set di scalabilità di macchine virtuali di ignorare i limiti az durante la creazione di batch di aggiornamento. Prendere in considerazione il dominio di aggiornamento e maxBatchInstancePercent per determinare le dimensioni del batch. Se questo campo non è impostato, Azure Batch non imposta il valore predefinito. Il valore di enableCrossZoneUpgrade nell'oggetto VirtualMachineScaleSet creato verrà deciso dalle configurazioni predefinite in VirtualMachineScaleSet. 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.

ScaleSettings

Impostazioni di scalabilità per il pool

Nome Tipo Descrizione
autoScale

AutoScaleSettings

Impostazioni di scalabilità automatica per il pool.
Questa proprietà e fixedScale si escludono a vicenda e una delle proprietà deve essere specificata.
fixedScale

FixedScaleSettings

Impostazioni di scalabilità fisse per il pool.
Questa proprietà e la scalabilità automatica si escludono a vicenda e deve essere specificata una delle proprietà.

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 e necessarie 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.
securityType

SecurityTypes

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

UefiSettings

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

SecurityTypes

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

Nome Tipo Descrizione
confidentialVM

string

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

string

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

ServiceArtifactReference

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

Nome Tipo Descrizione
id

string

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

StartTask

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

Nome Tipo Valore predefinito Descrizione
commandLine

string

Riga di comando dell'attività di avvio.
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. Obbligatorio se vengono specificate altre proprietà di startTask.
containerSettings

TaskContainerSettings

Impostazioni per il contenitore in cui viene eseguita l'attività di avvio.
Quando si specifica questa opzione, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) nel contenitore, tutte le variabili di ambiente delle attività vengono mappate nel contenitore e la riga di comando dell'attività viene eseguita nel contenitore.
environmentSettings

EnvironmentSetting[]

Elenco delle impostazioni delle variabili di ambiente per l'attività di avvio.
maxTaskRetryCount

integer

0

Numero massimo di tentativi di ripetizione dell'attività.
Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla 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 limiti. Il valore predefinito è 0
resourceFiles

ResourceFile[]

Elenco di file che il servizio Batch scaricherà nel nodo di calcolo prima di eseguire la riga di comando.
userIdentity

UserIdentity

Identità utente con cui viene eseguita l'attività di avvio.
Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.
waitForSuccess

boolean

Indica se il servizio Batch deve attendere che l'attività di avvio venga completata correttamente( ovvero per uscire con il codice di uscita 0) prima di pianificare eventuali attività nel nodo di calcolo.
Se true e l'attività di avvio non riesce in un nodo di calcolo, il servizio Batch ritenta l'attività di 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 di calcolo inutilizzabile e non pianifica le attività. Questa condizione può essere rilevata tramite lo stato del nodo e i dettagli degli errori di pianificazione. Se false, il servizio Batch non attenderà il completamento dell'attività di avvio. In questo caso, altre attività possono avviare l'esecuzione nel nodo di calcolo mentre l'attività di avvio è ancora in esecuzione; e anche se l'attività di avvio non riesce, le nuove attività continueranno a essere pianificate nel nodo. Il valore predefinito è true.

StorageAccountType

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

Nome Tipo Descrizione
Premium_LRS

string

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

string

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

string

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

TaskContainerSettings

Impostazioni del contenitore per un'attività.

Nome Tipo Descrizione
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

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

string

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

string

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

ContainerRegistry

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

ContainerWorkingDirectory

Flag per indicare dove si trova la directory di lavoro dell'attività contenitore. Il valore predefinito è 'taskWorkingDirectory'.

TaskSchedulingPolicy

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

Nome Tipo Valore predefinito Descrizione
nodeFillType

ComputeNodeFillType

Spread

Modalità di distribuzione delle attività tra i nodi di calcolo.

UefiSettings

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

Nome Tipo Descrizione
secureBootEnabled

boolean

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

boolean

Specifica se vTPM deve essere abilitato nella macchina virtuale.

UpgradeMode

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

I valori possibili sono:

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

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

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

Nome Tipo Descrizione
automatic

string

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

string

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

string

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

UpgradePolicy

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

Nome Tipo Descrizione
automaticOSUpgradePolicy

AutomaticOSUpgradePolicy

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

UpgradeMode

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

I valori possibili sono:

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

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

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

RollingUpgradePolicy

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

UserAccount

Proprietà usate per creare un utente in un nodo di Azure Batch.

Nome Tipo Descrizione
elevationLevel

ElevationLevel

Livello di elevazione dell'account utente.
nonAdmin: l'utente automatico è un utente standard senza accesso con privilegi elevati. admin: l'utente automatico è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete. Il valore predefinito è nonAdmin.
linuxUserConfiguration

LinuxUserConfiguration

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

string

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

string

Password per l'account utente.
windowsUserConfiguration

WindowsUserConfiguration

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

UserAssignedIdentities

Elenco delle identità utente associate.

Nome Tipo Descrizione
clientId

string

ID client dell'identità assegnata dall'utente.
principalId

string

ID principale dell'identità assegnata dall'utente.

UserIdentity

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

Nome Tipo Descrizione
autoUser

AutoUserSpecification

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

string

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

VirtualMachineConfiguration

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

Nome Tipo Descrizione
containerConfiguration

ContainerConfiguration

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

DataDisk[]

Configurazione per i dischi dati collegati ai nodi di calcolo nel pool.
Questa proprietà deve essere specificata se i nodi di calcolo nel pool devono avere dischi dati vuoti collegati.
diskEncryptionConfiguration

DiskEncryptionConfiguration

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

VMExtension[]

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

ImageReference

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

string

Tipo di licenza locale da usare durante la distribuzione del sistema operativo.
Questo vale solo per le immagini che contengono il sistema operativo Windows e devono essere usate solo quando si contengono licenze locali valide per i nodi 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 Batch di cui eseguire il provisioning nei nodi di calcolo nel pool.
L'agente del nodo Batch è un programma che viene eseguito in ogni nodo del pool e fornisce l'interfaccia di comando e controllo tra il nodo e il servizio Batch. Esistono implementazioni diverse dell'agente del nodo, note come SKU, per sistemi operativi diversi. È necessario specificare uno SKU dell'agente del nodo che corrisponde al riferimento all'immagine selezionata. Per ottenere l'elenco degli SKU dell'agente di nodi supportati insieme all'elenco dei riferimenti alle immagini verificate, vedere l'operazione "Elenca gli SKU dell'agente del nodo supportati".
nodePlacementConfiguration

NodePlacementConfiguration

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

OSDisk

Impostazioni per il disco del sistema operativo della macchina virtuale.
Contiene la configurazione per le impostazioni temporanee di OSDisk.
securityProfile

SecurityProfile

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

ServiceArtifactReference

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

WindowsConfiguration

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

VMDiskSecurityProfile

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

Nome Tipo Descrizione
securityEncryptionType

SecurityEncryptionTypes

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

VMExtension

Configurazione per le estensioni della macchina virtuale.

Nome Tipo Descrizione
autoUpgradeMinorVersion

boolean

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

boolean

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

string

Nome dell'estensione macchina virtuale.
protectedSettings

object

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

string[]

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

string

Nome del server di pubblicazione del gestore dell'estensione.
settings

object

Impostazioni pubbliche in formato JSON per l'estensione.
type

string

Tipo di estensioni.
typeHandlerVersion

string

Versione del gestore di script.

WindowsConfiguration

Impostazioni del sistema operativo Windows da applicare alla macchina virtuale.

Nome Tipo Descrizione
enableAutomaticUpdates

boolean

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

WindowsUserConfiguration

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

Nome Tipo Descrizione
loginMode

LoginMode

Modalità di accesso per l'utente
Specifica la modalità di accesso per l'utente. Il valore predefinito è Interactive.