Sdílet prostřednictvím

Pool - Create

  • Reference
Služba:
Batch Management
Verze rozhraní API:
2024-02-01

Vytvoří nový fond uvnitř zadaného účtu.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
accountName
 path True

string

Název účtu Batch.

Vzor regulárního výrazu: ^[a-zA-Z0-9]+$
poolName
 path True

string

Název fondu. Tato hodnota musí být v rámci účtu jedinečná.

Vzor regulárního výrazu: ^[a-zA-Z0-9_-]+$
resourceGroupName
 path True

string

Název skupiny prostředků, která obsahuje účet Batch.
subscriptionId
 path True

string

ID předplatného Azure. Jedná se o řetězec ve formátu GUID (např. 00000000-0000-0000-0000-000000000000000).
api-version
 query True

string

Verze rozhraní API, která se má použít s požadavkem HTTP.

Hlavička požadavku

Name Vyžadováno Typ Description
If-Match

string

Verze stavu entity (ETag) fondu, která se má aktualizovat. Hodnotu *lze použít k použití operace pouze v případě, že fond již existuje. Pokud tuto operaci vynecháte, použije se vždy.
If-None-Match

string

Pokud chcete povolit vytvoření nového fondu, ale zabránit aktualizaci existujícího fondu, nastavte na *. Ostatní hodnoty budou ignorovány.

Text požadavku

Name Typ Description
identity

BatchPoolIdentity

Typ identity, který se používá pro fond služby Batch.
Typ identity, který se používá pro fond služby Batch.
properties.applicationLicenses

string[]

Seznam licencí aplikací, které služba Batch zpřístupní na každém výpočetním uzlu ve fondu.
Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud se požádá o licenci, která není podporovaná, vytvoření fondu se nezdaří.
properties.applicationPackages

ApplicationPackageReference[]

Seznam balíčků aplikací, které se mají nainstalovat na každý výpočetní uzel ve fondu.
Změny odkazů na balíčky aplikací mají vliv na všechny nové výpočetní uzly, které se připojují k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nereimagí. V každém fondu je maximálně 10 odkazů na balíčky aplikací.
properties.certificates

CertificateReference[]

Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu.
U výpočetních uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. V případě linuxových výpočetních uzlů jsou certifikáty uložené v adresáři v pracovním adresáři úlohy a proměnná prostředí AZ_BATCH_CERTIFICATES_DIR je dodána úkolu, který se má dotazovat na toto umístění. Pro certifikáty s viditelností remoteUser se v domovském adresáři uživatele vytvoří adresář certs (např. /home/{uživatelské_jméno}/certs) a certifikáty se umístí do tohoto adresáře.

Upozornění: Tato vlastnost je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .
properties.deploymentConfiguration

DeploymentConfiguration

Tato vlastnost popisuje, jak se nasadí uzly fondu – pomocí Cloud Services nebo Virtual Machines.
Použití CloudServiceConfiguration určuje, že uzly by se měly vytvářet pomocí Azure Cloud Services (PaaS), zatímco VirtualMachineConfiguration používá Azure Virtual Machines (IaaS).
properties.displayName

string

Zobrazovaný název fondu.
Zobrazovaný název nemusí být jedinečný a může obsahovat jakékoli znaky Unicode až do maximální délky 1024.
properties.interNodeCommunication

InterNodeCommunicationState

Určuje, jestli fond umožňuje přímou komunikaci mezi uzly.
Tím se stanoví omezení, které uzly je možné přiřadit k fondu. Povolení této hodnoty může snížit pravděpodobnost přidělení požadovaného počtu uzlů ve fondu. Pokud není zadaný, bude tato hodnota ve výchozím nastavení zakázaná.
properties.metadata

MetadataItem[]

Seznam dvojic název-hodnota přidružených k fondu jako metadata.
Služba Batch nepřiřazuje metadatům žádný význam; slouží výhradně k použití uživatelského kódu.
properties.mountConfiguration

MountConfiguration[]

Seznam systémů souborů, které se mají připojit k jednotlivým uzlům ve fondu.
To podporuje Azure Files, NFS, CIFS/SMB a Blobfuse.
properties.networkConfiguration

NetworkConfiguration

Konfigurace sítě pro fond.
Konfigurace sítě pro fond.
properties.resourceTags

object

Uživatelem zadané značky přidružené k fondu.
Uživatelem definované značky, které mají být přidruženy k fondu Azure Batch. Po zadání se tyto značky rozšíří do záložních prostředků Azure přidružených k fondu. Tuto vlastnost je možné zadat pouze v případě, že byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na hodnotu UserSubscription.
properties.scaleSettings

ScaleSettings

Nastavení, která konfigurují počet uzlů ve fondu.
Definuje požadovanou velikost fondu. Může to být buď "fixedScale", kde je zadána požadovaná hodnota targetDedicatedNodes, nebo "autoScale", která definuje vzorec, který se pravidelně znovu vyhodnotuje. Pokud tato vlastnost není zadána, fond bude mít pevné škálování s 0 targetDedicatedNodes.
properties.startTask

StartTask

Úkol určený ke spuštění na každém výpočetním uzlu při připojení k fondu.
Při operaci PATCH (aktualizace) lze tuto vlastnost nastavit na prázdný objekt a odebrat tak spouštěcí úlohu z fondu.
properties.targetNodeCommunicationMode

NodeCommunicationMode

Požadovaný režim komunikace uzlu pro fond.
Pokud ho vynecháte, výchozí hodnota je Výchozí.
properties.taskSchedulingPolicy

TaskSchedulingPolicy

Způsob distribuce úkolů mezi výpočetní uzly ve fondu
Pokud není zadaný, je výchozí hodnota rozložena.
properties.taskSlotsPerNode

integer

Počet slotů úloh, které lze použít ke spouštění souběžných úloh na jednom výpočetním uzlu ve fondu.
Výchozí hodnota je 1. Maximální hodnota je menší ze 4násobku počtu jader vmSize fondu nebo 256.
properties.upgradePolicy

UpgradePolicy

Zásady upgradu pro fond.
Popisuje zásady upgradu – automatické, ruční nebo průběžné.
properties.userAccounts

UserAccount[]

Seznam uživatelských účtů, které se mají vytvořit na každém uzlu ve fondu.
properties.vmSize

string

Velikost virtuálních počítačů ve fondu. Všechny virtuální počítače ve fondu mají stejnou velikost.
Informace o dostupných velikostech virtuálních počítačů pro fondy Cloud Services (fondy vytvořené pomocí cloudServiceConfiguration) najdete v tématu Velikosti pro Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch podporuje všechny velikosti virtuálních počítačů Cloud Services s výjimkou ExtraSmall. Informace o dostupných velikostech virtuálních počítačů pro fondy používající image z Virtual Machines Marketplace (fondy vytvořené pomocí virtualMachineConfiguration) najdete v tématu Velikosti pro Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti pro Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch podporuje všechny velikosti virtuálních počítačů Azure s výjimkou STANDARD_A0 a virtuálních počítačů se službou Premium Storage (řady STANDARD_GS, STANDARD_DS a STANDARD_DSV2).

Odpovědi

Name Typ Description
200 OK

Pool

Operace byla úspěšná. Odpověď obsahuje entitu fondu.

Hlavičky

ETag: string
Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Microsoft Entra tok ověřovacího kódu OAuth 2.0

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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

CreatePool - accelerated networking

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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"
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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 CloudServiceConfiguration

Ukázkový požadavek

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

{
  "properties": {
    "displayName": "my-pool-name",
    "vmSize": "STANDARD_D4",
    "interNodeCommunication": "Enabled",
    "taskSlotsPerNode": 13,
    "taskSchedulingPolicy": {
      "nodeFillType": "Pack"
    },
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "osFamily": "4",
        "osVersion": "WA-GUEST-OS-4.45_201708-01"
      }
    },
    "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",
          "/subscriptions/subid2/resourceGroups/rg24/providers/Microsoft.Network/publicIPAddresses/ip268"
        ]
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 6,
        "targetLowPriorityNodes": 28,
        "resizeTimeout": "PT8M",
        "nodeDeallocationOption": "TaskCompletion"
      }
    },
    "metadata": [
      {
        "name": "metadata-1",
        "value": "value-1"
      },
      {
        "name": "metadata-2",
        "value": "value-2"
      }
    ],
    "startTask": {
      "commandLine": "cmd /c SET",
      "resourceFiles": [
        {
          "httpUrl": "https://testaccount.blob.core.windows.net/example-blob-file",
          "filePath": "c:\\temp\\gohere",
          "fileMode": "777"
        }
      ],
      "environmentSettings": [
        {
          "name": "MYSET",
          "value": "1234"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "scope": "Pool",
          "elevationLevel": "Admin"
        }
      },
      "maxTaskRetryCount": 6,
      "waitForSuccess": true
    },
    "userAccounts": [
      {
        "name": "username1",
        "password": "<ExamplePassword>",
        "elevationLevel": "Admin",
        "linuxUserConfiguration": {
          "sshPrivateKey": "sshprivatekeyvalue",
          "uid": 1234,
          "gid": 4567
        }
      }
    ],
    "applicationPackages": [
      {
        "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/applications/app_1234",
        "version": "asdf"
      }
    ],
    "certificates": [
      {
        "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/certificates/sha1-1234567",
        "storeLocation": "LocalMachine",
        "storeName": "MY",
        "visibility": [
          "RemoteUser"
        ]
      }
    ],
    "applicationLicenses": [
      "app-license0",
      "app-license1"
    ]
  }
}

Ukázková odpověď

Stavový kód:
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": "Enabled",
    "taskSlotsPerNode": 13,
    "taskSchedulingPolicy": {
      "nodeFillType": "Pack"
    },
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "osFamily": "4",
        "osVersion": "WA-GUEST-OS-4.45_201708-01"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 6,
        "targetLowPriorityNodes": 28,
        "resizeTimeout": "PT8M",
        "nodeDeallocationOption": "TaskCompletion"
      }
    },
    "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",
          "/subscriptions/subid2/resourceGroups/rg24/providers/Microsoft.Network/publicIPAddresses/ip268"
        ]
      }
    },
    "metadata": [
      {
        "name": "metadata-1",
        "value": "value-1"
      },
      {
        "name": "metadata-2",
        "value": "value-2"
      }
    ],
    "startTask": {
      "commandLine": "cmd /c SET",
      "resourceFiles": [
        {
          "httpUrl": "https://testaccount.blob.core.windows.net/example-blob-file",
          "filePath": "c:\\temp\\gohere",
          "fileMode": "777"
        }
      ],
      "environmentSettings": [
        {
          "name": "MYSET",
          "value": "1234"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "scope": "Pool",
          "elevationLevel": "Admin"
        }
      },
      "maxTaskRetryCount": 6,
      "waitForSuccess": true
    },
    "userAccounts": [
      {
        "name": "username1",
        "elevationLevel": "Admin",
        "linuxUserConfiguration": {
          "uid": 1234,
          "gid": 4567
        }
      }
    ],
    "applicationPackages": [
      {
        "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/applications/app_1234",
        "version": "asdf"
      }
    ],
    "certificates": [
      {
        "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/certificates/sha1-1234567",
        "storeLocation": "LocalMachine",
        "storeName": "MY",
        "visibility": [
          "RemoteUser"
        ]
      }
    ],
    "applicationLicenses": [
      "app-license0",
      "app-license1"
    ],
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  }
}

CreatePool - Full VirtualMachineConfiguration

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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"
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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 CloudServiceConfiguration

Ukázkový požadavek

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

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "osFamily": "5"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 3
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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": {
      "cloudServiceConfiguration": {
        "osFamily": "5",
        "osVersion": "*"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 3,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "resizeOperationStatus": {
      "startTime": "2017-08-28T10:22:55.9407275Z",
      "targetDedicatedNodes": 3,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M"
    }
  }
}

CreatePool - Minimal VirtualMachineConfiguration

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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"
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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"
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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"
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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 - UpgradePolicy

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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": {}
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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"
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-02-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
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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
      }
    }
  }
}

Definice

Name Description
AllocationState

Určuje, jestli se velikost fondu převede.
ApplicationPackageReference

Odkaz na balíček aplikace v účtu Batch
AutomaticOSUpgradePolicy

Parametry konfigurace používané k provedení automatického upgradu operačního systému
AutoScaleRun

Výsledky a chyby při spuštění vzorce automatického škálování fondu
AutoScaleRunError

Chyba, ke které došlo při automatickém škálování fondu.
AutoScaleSettings

Nastavení automatického škálování fondu
AutoUserScope

Obor automatického uživatele
AutoUserSpecification

Určuje parametry pro automatického uživatele, který spouští úlohu ve službě Batch.
AzureBlobFileSystemConfiguration

Informace, které slouží k připojení ke kontejneru služby Azure Storage pomocí blobfuse
AzureFileShareConfiguration

Informace použité pro připojení ke sdílené složce Azure
BatchPoolIdentity

Identita fondu služby Batch, pokud je nakonfigurovaná. Pokud se identita fondu aktualizuje během aktualizace existujícího fondu, aktualizované identity budou mít jenom nové virtuální počítače vytvořené po zmenšení fondu na 0.
CachingType

Typ ukládání do mezipaměti, který se má pro disk povolit.
CertificateReference

Odkaz na certifikát, který se má nainstalovat na výpočetní uzly ve fondu. Musí existovat ve stejném účtu jako fond.
CertificateStoreLocation

Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.
CertificateVisibility

Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu.
CIFSMountConfiguration

Informace používané k připojení k systému souborů CIFS.
CloudError

Chybová odpověď ze služby Batch.
CloudErrorBody

Chybová odpověď ze služby Batch.
CloudServiceConfiguration

Konfigurace pro uzly ve fondu na základě platformy Azure Cloud Services.
ComputeNodeDeallocationOption

Určuje, co se má dělat s uzlem a jeho spuštěnými úlohami po jeho výběru pro uvolnění polohy.
ComputeNodeFillType

Způsob distribuce úloh mezi výpočetní uzly
ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude výpočetní uzel používat.
ContainerConfiguration

Konfigurace pro fondy s podporou kontejnerů.
ContainerRegistry

Privátní registr kontejneru.
ContainerType

Technologie kontejneru, která se má použít.
ContainerWorkingDirectory

Příznak označující, kde je pracovní adresář úlohy kontejneru. Výchozí hodnota je taskWorkingDirectory.
DataDisk

Nastavení, která budou používat datové disky přidružené k výpočetním uzlům ve fondu. Pokud používáte připojené datové disky, musíte je připojit a naformátovat z virtuálního počítače, abyste je mohli používat.
DeploymentConfiguration

Vlastnosti konfigurace nasazení.
DiffDiskPlacement

Určuje umístění dočasného disku pro disk operačního systému pro všechny virtuální počítače ve fondu.
DiffDiskSettings

Určuje dočasné nastavení disku pro disk operačního systému používaný virtuálním počítačem.
DiskEncryptionConfiguration

Konfigurace šifrování disku použitá na výpočetních uzlech ve fondu Konfigurace šifrování disků se nepodporuje ve fondu Linuxu vytvořeném pomocí image virtuálního počítače nebo image Galerie výpočetních prostředků Azure.
DiskEncryptionTarget

Seznam cílových disků služba Batch bude šifrovat na výpočetním uzlu.
DynamicVNetAssignmentScope

Rozsah dynamického přiřazení virtuální sítě.
ElevationLevel

Úroveň zvýšení oprávnění uživatele.
EnvironmentSetting

Proměnná prostředí, která se má nastavit v procesu úkolu.
FixedScaleSettings

Opravili jsme nastavení škálování fondu.
ImageReference

Odkaz na image Azure Virtual Machines Marketplace nebo prostředek image Azure vlastního virtuálního počítače. Pokud chcete získat seznam všech imagíReference ověřených Azure Batch, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu.
InboundEndpointProtocol

Protokol koncového bodu.
InboundNatPool

Fond příchozích překladů adres (NAT), který je možné použít k externímu řešení konkrétních portů na výpočetních uzlech ve fondu služby Batch.
InterNodeCommunicationState

Jestli fond umožňuje přímou komunikaci mezi uzly.
IPAddressProvisioningType

Typ zřizování veřejných IP adres pro fond Batch.
LinuxUserConfiguration

Vlastnosti použité k vytvoření uživatelského účtu na uzlu s Linuxem
LoginMode

Režim přihlášení pro uživatele
ManagedDisk
MetadataItem

Pár název-hodnota přidružený k prostředku služby Batch.
MountConfiguration

Systém souborů, který se má připojit k jednotlivým uzlům.
NetworkConfiguration

Konfigurace sítě pro fond.
NetworkSecurityGroupRule

Pravidlo skupiny zabezpečení sítě, které se použije na příchozí koncový bod.
NetworkSecurityGroupRuleAccess

Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku.
NFSMountConfiguration

Informace používané k připojení k systému souborů NFS
NodeCommunicationMode

Určuje, jak fond komunikuje se službou Batch.
NodePlacementConfiguration

Konfigurace umístění uzlů pro fondy dávek.
NodePlacementPolicyType

Zásady umístění pro přidělování uzlů ve fondu.
OSDisk

Nastavení pro disk operačního systému virtuálního počítače.
Pool

Obsahuje informace o fondu.
PoolEndpointConfiguration

Konfigurace koncového bodu pro fond
PoolIdentityType

Typ identity použité pro fond služby Batch.
PoolProvisioningState

Aktuální stav fondu.
PublicIPAddressConfiguration

Konfigurace veřejné IP adresy síťové konfigurace fondu.
ResizeError

Chyba, ke které došlo při změně velikosti fondu.
ResizeOperationStatus

Podrobnosti o aktuální nebo poslední dokončené operaci změny velikosti
ResourceFile

Jeden soubor nebo více souborů ke stažení do výpočetního uzlu
RollingUpgradePolicy

Parametry konfigurace použité při provádění upgradu se zajištěním provozu
ScaleSettings

Nastavení škálování fondu
SecurityProfile

Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.
SecurityTypes

Určuje typ zabezpečení virtuálního počítače. Aby bylo možné UefiSettings povolit, musí být nastavená na libovolnou zadanou hodnotu.
ServiceArtifactReference

Určuje REFERENČNÍ ID artefaktu služby, které se používá k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image.
StartTask

Úloha, která se spustí, když se výpočetní uzel připojí k fondu ve službě Azure Batch nebo když se výpočetní uzel restartuje nebo znovu zmage.
StorageAccountType

Typ účtu úložiště, který se použije při vytváření datových disků nebo disků s operačním systémem.
TaskContainerSettings

Nastavení kontejneru pro úlohu
TaskSchedulingPolicy

Určuje, jak se mají úkoly distribuovat mezi výpočetní uzly.
UefiSettings

Určuje nastavení zabezpečení, jako je zabezpečené spouštění a virtuálnítpm použité při vytváření virtuálního počítače.
UpgradeMode

Určuje režim upgradu na virtuální počítače ve škálovací sadě.

Možné hodnoty:

Ruční – řídíte aplikaci aktualizací na virtuální počítače ve škálovací sadě. Provedete to pomocí akce manualUpgrade.

Automaticky – všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně.

Rolling – Škálovací sada provádí aktualizace v dávkách s volitelnou dobou pozastavení mezi.
UpgradePolicy

Popisuje zásady upgradu – automatické, ruční nebo průběžné.
UserAccount

Vlastnosti použité k vytvoření uživatele v uzlu Azure Batch.
UserAssignedIdentities

Seznam přidružených identit uživatelů.
UserIdentity

Definice identity uživatele, pod kterou je úloha spuštěna.
VirtualMachineConfiguration

Konfigurace výpočetních uzlů ve fondu na základě infrastruktury Azure Virtual Machines.
VMExtension

Konfigurace pro rozšíření virtuálních počítačů
WindowsConfiguration

Nastavení operačního systému Windows, která se mají použít pro virtuální počítač.
WindowsUserConfiguration

Vlastnosti použité k vytvoření uživatelského účtu na uzlu Windows.

AllocationState

Určuje, jestli se velikost fondu převede.

Name Typ Description
Resizing

string

Změna velikosti fondu; to znamená, že výpočetní uzly se přidávají do fondu nebo se z fondu odebírají.
Steady

string

Velikost fondu nejde změnit. Počet probíhajících uzlů ve fondu se nemění. Fond přejde do tohoto stavu, když je vytvořen a když se ve fondu neprovádí žádné operace, které by změnily počet uzlů.
Stopping

string

Změna velikosti fondu se změnila, ale uživatel požádal o zastavení změny velikosti, ale žádost o zastavení ještě nebyla dokončena.

ApplicationPackageReference

Odkaz na balíček aplikace v účtu Batch

Name Typ Description
id

string

ID balíčku aplikace, který se má nainstalovat. Musí se nacházet ve stejném účtu Batch jako fond. Může se jednat buď o odkaz na konkrétní verzi, nebo o výchozí verzi, pokud existuje.
version

string

Verze aplikace, která se má nasadit. Pokud tento parametr vynecháte, nasadí se výchozí verze.
Pokud je tato možnost vynechána a pro tuto aplikaci není zadána žádná výchozí verze, požadavek selže s kódem chyby InvalidApplicationPackageReferences. Pokud voláte rozhraní REST API přímo, stavový kód HTTP je 409.

AutomaticOSUpgradePolicy

Parametry konfigurace používané k provedení automatického upgradu operačního systému

Name Typ Description
disableAutomaticRollback

boolean

Jestli má být funkce vrácení imagí operačního systému zakázaná.
enableAutomaticOSUpgrade

boolean

Označuje, jestli se upgrady operačního systému mají automaticky aplikovat na instance škálovacích sad postupně, když bude k dispozici novější verze image operačního systému.

Pokud je tato hodnota nastavená na hodnotu true pro fondy založené na Windows, windowsConfiguration.enableAutomaticUpdates nelze nastavit na hodnotu true.
osRollingUpgradeDeferral

boolean

Odložte upgrady operačního systému na tvm, pokud jsou spuštěné úlohy.
useRollingUpgradePolicy

boolean

Určuje, jestli se při automatickém upgradu operačního systému mají používat zásady postupného upgradu. Pokud na škálovací sadě virtuálních počítačů nejsou definované žádné zásady, automatický upgrade operačního systému se vrátí k výchozí zásadě.

AutoScaleRun

Výsledky a chyby při spuštění vzorce automatického škálování fondu

Name Typ Description
error

AutoScaleRunError

Podrobnosti o chybě, ke které došlo při vyhodnocování vzorce automatického škálování ve fondu, pokud vyhodnocení nebylo úspěšné.
evaluationTime

string

Čas, kdy byl vzorec automatického škálování naposledy vyhodnocen.
results

string

Konečné hodnoty všech proměnných použitých při vyhodnocení vzorce automatického škálování
Každá hodnota proměnné je vrácena ve tvaru $variable=value a proměnné jsou oddělené středníky.

AutoScaleRunError

Chyba, ke které došlo při automatickém škálování fondu.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově.
details

AutoScaleRunError[]

Další podrobnosti o chybě
message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

AutoScaleSettings

Nastavení automatického škálování fondu

Name Typ Description
evaluationInterval

string

Časový interval, ve kterém se má automaticky upravit velikost fondu podle vzorce automatického škálování.
Pokud je vynechán, výchozí hodnota je 15 minut (PT15M).
formula

string

Vzorec pro požadovaný počet výpočetních uzlů ve fondu.

AutoUserScope

Obor automatického uživatele

Name Typ Description
Pool

string

Určuje, že se úloha spustí jako společný automatický uživatelský účet, který se vytvoří na každém uzlu ve fondu.
Task

string

Určuje, že služba má pro úlohu vytvořit nového uživatele.

AutoUserSpecification

Určuje parametry pro automatického uživatele, který spouští úlohu ve službě Batch.

Name Typ Description
elevationLevel

ElevationLevel

Úroveň zvýšení oprávnění automatického uživatele.
Výchozí hodnota je nonAdmin.
scope

AutoUserScope

Obor automatického uživatele
Výchozí hodnota je Fond. Pokud fond používá Systém Windows, měla by být zadána hodnota Úloha, pokud je vyžadována přísnější izolace mezi úkoly. Například pokud úloha zmutuje registr způsobem, který by mohl ovlivnit jiné úlohy, nebo pokud byly ve fondu zadány certifikáty, které by neměly být přístupné pro běžné úkoly, ale měly by být přístupné spouštěcím úkolům.

AzureBlobFileSystemConfiguration

Informace, které slouží k připojení ke kontejneru služby Azure Storage pomocí blobfuse

Name Typ Description
accountKey

string

Klíč účtu služby Azure Storage.
Tato vlastnost se vzájemně vylučuje s sasKey a identity; musí být zadána přesně jedna.
accountName

string

Název účtu služby Azure Storage.
blobfuseOptions

string

Další možnosti příkazového řádku, které se mají předat příkazu mount.
Toto jsou možnosti net use ve Windows a možnosti připojení v Linuxu.
containerName

string

Název kontejneru Azure Blob Storage.
identityReference

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup ke kontejneru containerName
Tato vlastnost se vzájemně vylučuje s accountKey a sasKey; musí být zadána přesně jedna.
relativeMountPath

string

Relativní cesta na výpočetním uzlu, kam se připojí systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch mounts a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.
sasKey

string

Token SAS služby Azure Storage.
Tato vlastnost se vzájemně vylučuje s accountKey a identity; musí být zadána přesně jedna.

AzureFileShareConfiguration

Informace použité pro připojení ke sdílené složce Azure

Name Typ Description
accountKey

string

Klíč účtu služby Azure Storage.
accountName

string

Název účtu služby Azure Storage.
azureFileUrl

string

Adresa URL Azure Files.
Jedná se o formulář "https://{account}.file.core.windows.net/".
mountOptions

string

Další možnosti příkazového řádku, které se mají předat příkazu mount.
Toto jsou možnosti net use ve Windows a možnosti připojení v Linuxu.
relativeMountPath

string

Relativní cesta na výpočetním uzlu, kam se připojí systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch mounts a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.

BatchPoolIdentity

Identita fondu služby Batch, pokud je nakonfigurovaná. Pokud se identita fondu aktualizuje během aktualizace existujícího fondu, aktualizované identity budou mít jenom nové virtuální počítače vytvořené po zmenšení fondu na 0.

Name Typ Description
type

PoolIdentityType

Typ identity použité pro fond služby Batch.
userAssignedIdentities

<string,  UserAssignedIdentities>

Seznam identit uživatelů přidružených k fondu služby Batch.

CachingType

Typ ukládání do mezipaměti, který se má pro disk povolit.

Name Typ Description
None

string

Režim ukládání do mezipaměti pro disk není povolený.
ReadOnly

string

Režim ukládání do mezipaměti pro disk je jen pro čtení.
ReadWrite

string

Režim ukládání do mezipaměti pro disk je čtení a zápis.

CertificateReference

Odkaz na certifikát, který se má nainstalovat na výpočetní uzly ve fondu. Musí existovat ve stejném účtu jako fond.

Name Typ Description
id

string

Plně kvalifikované ID certifikátu, který se má nainstalovat do fondu. Musí se nacházet ve stejném účtu Batch jako fond.
storeLocation

CertificateStoreLocation

Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.
Výchozí hodnota je currentUser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená vytvořené pomocí cloudServiceConfiguration nebo virtualMachineConfiguration s využitím odkazu na image Windows). V případě linuxových výpočetních uzlů jsou certifikáty uložené v adresáři v pracovním adresáři úlohy a do úlohy se zadává proměnná prostředí, AZ_BATCH_CERTIFICATES_DIR se má dotazovat na toto umístění. Pro certifikáty s viditelností remoteUser se v domovském adresáři uživatele vytvoří adresář certs (např. /home/{uživatelské jméno}/certs) a certifikáty se umístí do tohoto adresáře.
storeName

string

Název úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.
Tato vlastnost se vztahuje pouze na fondy nakonfigurované s uzly Windows (to znamená, že jsou vytvořené pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Mezi běžné názvy obchodů patří: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale je možné použít také jakýkoli vlastní název obchodu. Výchozí hodnota je My.
visibility

CertificateVisibility[]

Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu.

CertificateStoreLocation

Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.

Name Typ Description
CurrentUser

string

Certifikáty by se měly nainstalovat do úložiště certifikátů CurrentUser.
LocalMachine

string

Certifikáty by se měly nainstalovat do úložiště certifikátů LocalMachine.

CertificateVisibility

Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu.

Name Typ Description
RemoteUser

string

Certifikát by měl být viditelný pro uživatelské účty, pod kterými uživatelé vzdáleně přistupují k uzlu.
StartTask

string

Certifikát by měl být viditelný pro uživatelský účet, pod kterým se spouští spouštěcí úloha. Všimněte si, že pokud je obor automatického uživatele fond pro startTask i úkol, bude tento certifikát viditelný i pro úkol.
Task

string

Certifikát by měl být viditelný pro uživatelské účty, ve kterých se úlohy spouštějí.

CIFSMountConfiguration

Informace používané k připojení k systému souborů CIFS.

Name Typ Description
mountOptions

string

Další možnosti příkazového řádku, které se mají předat příkazu mount.
Toto jsou možnosti net use ve Windows a možnosti připojení v Linuxu.
password

string

Heslo, které se má použít pro ověřování v systému souborů CIFS.
relativeMountPath

string

Relativní cesta na výpočetním uzlu, kam se připojí systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch mounts a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.
source

string

Identifikátor URI systému souborů, který se má připojit.
userName

string

Uživatel, který se má použít pro ověřování v systému souborů CIFS.

CloudError

Chybová odpověď ze služby Batch.

Name Typ Description
error

CloudErrorBody

Text chybové odpovědi.

CloudErrorBody

Chybová odpověď ze služby Batch.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově.
details

CloudErrorBody[]

Seznam dalších podrobností o chybě
message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
target

string

Cíl konkrétní chyby. Například název vlastnosti v chybě.

CloudServiceConfiguration

Konfigurace pro uzly ve fondu na základě platformy Azure Cloud Services.

Name Typ Description
osFamily

string

Řada hostovaných operačních systémů Azure, která se má nainstalovat na virtuální počítače ve fondu.
Možné hodnoty jsou: 2 – řada operačních systémů 2, což odpovídá systému Windows Server 2008 R2 SP1. 3 – Řada operačního systému 3, která odpovídá Windows Server 2012. 4 – Řada operačního systému 4, ekvivalent Windows Server 2012 R2. 5 – Řada operačních systémů 5, což odpovídá Windows Server 2016. 6 – Řada operačního systému 6, která odpovídá Windows Serveru 2019. Další informace najdete v tématu Verze hostovaného operačního systému Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).
osVersion

string

Verze hostovaného operačního systému Azure, která se má nainstalovat na virtuální počítače ve fondu.
Výchozí hodnota je * , která určuje nejnovější verzi operačního systému pro zadanou řadu operačních systémů.

ComputeNodeDeallocationOption

Určuje, co se má dělat s uzlem a jeho spuštěnými úlohami po jeho výběru pro uvolnění polohy.

Name Typ Description
Requeue

string

Ukončete spuštěné procesy úloh a znovu zaváděte úlohy do fronty. Jakmile bude uzel k dispozici, úlohy se spustí znovu. Jakmile budou úkoly ukončeny, odeberte uzly.
RetainedData

string

Povolte dokončení aktuálně spuštěných úkolů a počkejte, až vyprší platnost všech dob uchovávání dat úkolů. Během čekání neplánujte žádné nové úkoly. Odeberte uzly, když vypršela doba uchovávání všech úkolů.
TaskCompletion

string

Povolte dokončení aktuálně spuštěných úloh. Během čekání neplánujte žádné nové úkoly. Po dokončení všech úkolů odeberte uzly.
Terminate

string

Ukončete spuštěné úlohy. Úlohy budou dokončeny s informací o selhání označující, že byly ukončeny, a nebudou znovu spuštěny. Jakmile budou úkoly ukončeny, odeberte uzly.

ComputeNodeFillType

Způsob distribuce úloh mezi výpočetní uzly

Name Typ Description
Pack

string

Každému uzlu ve fondu by se mělo přiřadit co nejvíce úkolů (taskSlotsPerNode) před přiřazením k dalšímu uzlu ve fondu.
Spread

string

Úkoly by měly být přiřazeny rovnoměrně napříč všemi uzly ve fondu.

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude výpočetní uzel používat.

Name Typ Description
resourceId

string

ID prostředku ARM identity přiřazené uživatelem.

ContainerConfiguration

Konfigurace pro fondy s podporou kontejnerů.

Name Typ Description
containerImageNames

string[]

Kolekce názvů imagí kontejneru.
Toto je úplný odkaz na image, který by byl zadán pro "docker pull". Pokud image není plně kvalifikovaná s alternativním registrem, bude zdrojem image z výchozího registru Dockeru.
containerRegistries

ContainerRegistry[]

Další privátní registry, ze kterých je možné kontejnery načíst.
Pokud je nutné stáhnout nějaké image z privátního registru, který vyžaduje přihlašovací údaje, musí se tyto přihlašovací údaje zadat tady.
type

ContainerType

Technologie kontejneru, která se má použít.

ContainerRegistry

Privátní registr kontejneru.

Name Typ Description
identityReference

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem, která se použije pro přístup k Azure Container Registry místo uživatelského jména a hesla.
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude výpočetní uzel používat.
password

string

Heslo pro přihlášení k serveru registru.
registryServer

string

Adresa URL registru.
Pokud ho vynecháte, výchozí hodnota je "docker.io".
username

string

Uživatelské jméno pro přihlášení k serveru registru.

ContainerType

Technologie kontejneru, která se má použít.

Name Typ Description
CriCompatible

string

Ke spuštění kontejnerů se použije technologie CRI.
DockerCompatible

string

Ke spuštění kontejnerů se použije technologie kontejnerů kompatibilní s Dockerem.

ContainerWorkingDirectory

Příznak označující, kde je pracovní adresář úlohy kontejneru. Výchozí hodnota je taskWorkingDirectory.

Name Typ Description
ContainerImageDefault

string

Použití pracovního adresáře definovaného image kontejneru Mějte na pozoru, že tento adresář nebude obsahovat soubory prostředků stažené službou Batch.
TaskWorkingDirectory

string

Použijte standardní pracovní adresář úkolů služby Batch, který bude obsahovat soubory zdrojů úkolů naplněné službou Batch.

DataDisk

Nastavení, která budou používat datové disky přidružené k výpočetním uzlům ve fondu. Pokud používáte připojené datové disky, musíte je připojit a naformátovat z virtuálního počítače, abyste je mohli používat.

Name Typ Description
caching

CachingType

Typ ukládání do mezipaměti, který se má povolit pro datové disky.
Hodnoty jsou:

none – Režim ukládání do mezipaměti pro disk není povolený. readOnly – režim ukládání do mezipaměti disku je jen pro čtení. readWrite – režim ukládání do mezipaměti pro disk je čtení a zápis.

Výchozí hodnota pro ukládání do mezipaměti je žádná. Informace o možnostech ukládání do mezipaměti najdete tady: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB

integer

Počáteční velikost disku v GB při vytváření nového datového disku.
lun

integer

Číslo logické jednotky.
Logická jednotka se používá k jedinečné identifikaci jednotlivých datových disků. Pokud připojujete více disků, každý z nich by měl mít jinou logickou jednotku. Hodnota musí být mezi 0 a 63 včetně.
storageAccountType

StorageAccountType

Typ účtu úložiště, který se má použít pro datový disk.
Pokud je vynechán, výchozí hodnota je "Standard_LRS". Hodnoty jsou:

Standard_LRS – datový disk by měl používat standardní místně redundantní úložiště. Premium_LRS – Datový disk by měl používat místně redundantní úložiště úrovně Premium.

DeploymentConfiguration

Vlastnosti konfigurace nasazení.

Name Typ Description
cloudServiceConfiguration

CloudServiceConfiguration

Konfigurace cloudové služby pro fond
Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a musí být zadána jedna z vlastností. Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na UserSubscription.
virtualMachineConfiguration

VirtualMachineConfiguration

Konfigurace virtuálního počítače pro fond
Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a musí být zadána jedna z vlastností.

DiffDiskPlacement

Určuje umístění dočasného disku pro disk operačního systému pro všechny virtuální počítače ve fondu.

Name Typ Description
CacheDisk

string

Dočasný disk s operačním systémem je uložený v mezipaměti virtuálního počítače.

DiffDiskSettings

Určuje dočasné nastavení disku pro disk operačního systému používaný virtuálním počítačem.

Name Typ Description
placement

DiffDiskPlacement

Určuje umístění dočasného disku pro disk operačního systému pro všechny virtuální počítače ve fondu.
Tuto vlastnost může uživatel v požadavku použít k výběru umístění operačního systému. Například místo na disku mezipaměti pro dočasné zřizování disků s operačním systémem. Další informace o požadavcích na velikost disku s dočasným operačním systémem najdete v tématu Požadavky na velikost dočasného disku s operačním systémem pro virtuální počítače s Windows na https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a virtuální počítače s Linuxem na adrese https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

Konfigurace šifrování disku použitá na výpočetních uzlech ve fondu Konfigurace šifrování disků se nepodporuje ve fondu Linuxu vytvořeném pomocí image virtuálního počítače nebo image Galerie výpočetních prostředků Azure.

Name Typ Description
targets

DiskEncryptionTarget[]

Seznam cílových disků služba Batch bude šifrovat na výpočetním uzlu.
Ve fondu Linuxu se podporuje pouze Dočasný disk. ve fondu Windows musí být zadány "OsDisk" a "TemporaryDisk".

DiskEncryptionTarget

Seznam cílových disků služba Batch bude šifrovat na výpočetním uzlu.

Name Typ Description
OsDisk

string

Disk s operačním systémem na výpočetním uzlu je šifrovaný.
TemporaryDisk

string

Dočasný disk na výpočetním uzlu je šifrovaný. V Linuxu se toto šifrování vztahuje na jiné oddíly (například na připojených datových discích), pokud k šifrování dojde při spuštění.

DynamicVNetAssignmentScope

Rozsah dynamického přiřazení virtuální sítě.

Name Typ Description
job

string

Dynamické přiřazení virtuální sítě se provádí pro každou úlohu. Pokud je tato hodnota nastavená, musí být také nastaveno ID podsítě konfigurace sítě. Tato funkce vyžaduje schválení před použitím. Obraťte se na podporu.
none

string

Není povolené žádné dynamické přiřazení virtuální sítě.

ElevationLevel

Úroveň zvýšení oprávnění uživatele.

Name Typ Description
Admin

string

Uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce.
NonAdmin

string

Uživatel je standardní uživatel bez zvýšeného přístupu.

EnvironmentSetting

Proměnná prostředí, která se má nastavit v procesu úkolu.

Name Typ Description
name

string

Název proměnné prostředí.
value

string

Hodnota proměnné prostředí.

FixedScaleSettings

Opravili jsme nastavení škálování fondu.

Name Typ Default value Description
nodeDeallocationOption

ComputeNodeDeallocationOption

Určuje, co dělat s uzlem a jeho spuštěnými úlohami, pokud se velikost fondu snižuje.
Pokud je vynechán, výchozí hodnota je Opětovné zařazení do fronty.
resizeTimeout

string

PT15M

Časový limit přidělení výpočetních uzlů do fondu
Výchozí hodnota je 15 minut. Hodnoty časového limitu používají formát ISO 8601. Použijte například PT10M po dobu 10 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu menší než 5 minut, služba Batch odmítne požadavek s chybou; Pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (chybný požadavek).
targetDedicatedNodes

integer

Požadovaný počet vyhrazených výpočetních uzlů ve fondu
Musí být nastavena alespoň jedna z targetDedicatedNodes, targetLowPriorityNodes.
targetLowPriorityNodes

integer

Požadovaný počet spotových výpočetních uzlů nebo výpočetních uzlů s nízkou prioritou ve fondu
Musí být nastavena alespoň jedna z targetDedicatedNodes, targetLowPriorityNodes.

ImageReference

Odkaz na image Azure Virtual Machines Marketplace nebo prostředek image Azure vlastního virtuálního počítače. Pokud chcete získat seznam všech imagíReference ověřených Azure Batch, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu.

Name Typ Description
id

string

Identifikátor prostředku ARM image Azure Compute Gallery. Výpočetní uzly ve fondu se vytvoří pomocí tohoto ID image. Toto je ve formátu /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{versionId}.
Tato vlastnost se vzájemně vylučuje s jinými vlastnostmi. Image Azure Compute Gallery musí mít repliky ve stejné oblasti jako účet Azure Batch. Informace o nastavení brány firewall pro agenta uzlu Batch pro komunikaci se službou Batch najdete v tématu https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.
offer

string

Typ nabídky image Azure Virtual Machines Marketplace.
Například UbuntuServer nebo WindowsServer.
publisher

string

Vydavatel image Azure Virtual Machines Marketplace.
Například Canonical nebo MicrosoftWindowsServer.
sku

string

Skladová položka image Azure Virtual Machines Marketplace.
Například 18.04-LTS nebo 2022-datacenter.
version

string

Verze image Azure Virtual Machines Marketplace.
Pro výběr nejnovější verze image je možné zadat hodnotu "latest". Pokud je vynechán, výchozí hodnota je "nejnovější".

InboundEndpointProtocol

Protokol koncového bodu.

Name Typ Description
TCP

string

Jako koncový bod použijte protokol TCP.
UDP

string

Jako koncový bod použijte UDP.

InboundNatPool

Fond příchozích překladů adres (NAT), který je možné použít k externímu řešení konkrétních portů na výpočetních uzlech ve fondu služby Batch.

Name Typ Description
backendPort

integer

Číslo portu na výpočetním uzlu.
To musí být v rámci fondu služby Batch jedinečné. Přijatelné hodnoty jsou mezi 1 a 65535 s výjimkou 22, 3389, 29876 a 29877, protože jsou rezervované. Pokud jsou zadány nějaké rezervované hodnoty, požadavek selže se stavovým kódem HTTP 400.
frontendPortRangeEnd

integer

Poslední číslo portu v rozsahu externích portů, které se použije k poskytování příchozího přístupu k backendPortu na jednotlivých výpočetních uzlech.
Přípustné hodnoty jsou v rozsahu od 1 do 65534 s výjimkou portů od 50000 do 55000, které jsou rezervované službou Batch. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou zadány rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400.
frontendPortRangeStart

integer

První číslo portu v rozsahu externích portů, které se použije k poskytování příchozího přístupu k backendPortu na jednotlivých výpočetních uzlech.
Přijatelné hodnoty se pohybují v rozmezí od 1 do 65534 s výjimkou rezervovaných portů od 50000 do 55000. Všechny oblasti ve fondu musí být odlišné a nesmí se překrývat. Pokud jsou zadány nějaké rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400.
name

string

Název koncového bodu.
Název musí být jedinečný v rámci fondu Služby Batch a může obsahovat písmena, číslice, podtržítka, tečky a spojovníky. Názvy musí začínat písmenem nebo číslicí, musí končit písmenem, číslicí nebo podtržítkem a nesmí být delší než 77 znaků. Pokud jsou zadány neplatné hodnoty, požadavek selže se stavovým kódem HTTP 400.
networkSecurityGroupRules

NetworkSecurityGroupRule[]

Seznam pravidel skupiny zabezpečení sítě, která se použijí na koncový bod.
Maximální počet pravidel, která je možné zadat ve všech koncových bodech ve fondu Batch, je 25. Pokud nejsou zadaná žádná pravidla skupiny zabezpečení sítě, vytvoří se výchozí pravidlo, které povolí příchozí přístup k zadanému backendPortu. Pokud dojde k překročení maximálního počtu pravidel skupiny zabezpečení sítě, požadavek selže se stavovým kódem HTTP 400.
protocol

InboundEndpointProtocol

Protokol koncového bodu.

InterNodeCommunicationState

Jestli fond umožňuje přímou komunikaci mezi uzly.

Name Typ Description
Disabled

string

Zakažte síťovou komunikaci mezi virtuálními počítači.
Enabled

string

Povolte síťovou komunikaci mezi virtuálními počítači.

IPAddressProvisioningType

Typ zřizování veřejných IP adres pro fond Batch.

Name Typ Description
BatchManaged

string

Služba Batch vytvoří a spravuje veřejnou IP adresu. V závislosti na velikosti fondu může existovat několik veřejných IP adres.
NoPublicIPAddresses

string

Pro výpočetní uzly ve fondu se nevytvořila žádná veřejná IP adresa.
UserManaged

string

Veřejné IP adresy poskytuje uživatel a použijí se ke zřízení výpočetních uzlů.

LinuxUserConfiguration

Vlastnosti použité k vytvoření uživatelského účtu na uzlu s Linuxem

Name Typ Description
gid

integer

ID skupiny pro uživatelský účet.
Vlastnosti uid a gid musí být zadány společně, nebo vůbec. Pokud není zadaný, vybere příslušný operační systém gid.
sshPrivateKey

string

Privátní klíč SSH pro uživatelský účet.
Privátní klíč nesmí být chráněný heslem. Privátní klíč se používá k automatické konfiguraci ověřování na základě asymetrického klíče pro SSH mezi uzly ve fondu Linuxu, pokud má vlastnost enableInterNodeCommunication fondu hodnotu true (pokud je vlastnost enableInterNodeCommunication nepravdivá, ignoruje se). Provede to umístěním páru klíčů do adresáře .ssh uživatele. Pokud není zadaný, není mezi uzly nakonfigurovaný SSH bez hesla (neprovozuje se žádná úprava adresáře .ssh uživatele).
uid

integer

ID uživatele uživatelského účtu.
Vlastnosti uid a gid musí být zadány společně, nebo vůbec. Pokud není zadáno, základní operační systém vybere identifikátor UID.

LoginMode

Režim přihlášení pro uživatele

Name Typ Description
Batch

string

Režim přihlášení LOGON32_LOGON_BATCH Win32. Režim dávkového přihlášení se doporučuje pro dlouhotrvající paralelní procesy.
Interactive

string

Režim přihlášení LOGON32_LOGON_INTERACTIVE Win32. Některé aplikace vyžadují oprávnění přidružená k režimu interaktivního přihlášení. Pokud je to případ aplikace použité ve vašem úkolu, doporučuje se tato možnost.

ManagedDisk

Name Typ Description
storageAccountType

StorageAccountType

Typ účtu úložiště pro spravovaný disk.

MetadataItem

Pár název-hodnota přidružený k prostředku služby Batch.

Name Typ Description
name

string

Název položky metadat.
value

string

Hodnota položky metadat.

MountConfiguration

Systém souborů, který se má připojit k jednotlivým uzlům.

Name Typ Description
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

Kontejner služby Azure Storage, který se má připojit pomocí FUSE objektů blob na každém uzlu.
Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.
azureFileShareConfiguration

AzureFileShareConfiguration

Sdílená složka Azure, která se připojí k jednotlivým uzlům.
Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.
cifsMountConfiguration

CIFSMountConfiguration

Systém souborů CIFS/SMB, který se připojí k jednotlivým uzlům.
Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.
nfsMountConfiguration

NFSMountConfiguration

Systém souborů NFS, který se připojí k jednotlivým uzlům.
Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.

NetworkConfiguration

Konfigurace sítě pro fond.

Name Typ Default value Description
dynamicVnetAssignmentScope

DynamicVNetAssignmentScope

none

Rozsah dynamického přiřazení virtuální sítě.
enableAcceleratedNetworking

boolean

Jestli má tento fond povolit akcelerované síťové služby.
Akcelerované síťové služby umožňují virtualizaci SR-IOV (Single Root I/O Virtualization) na virtuálním počítači, což může vést k lepšímu výkonu sítě. Další podrobnosti najdete tady: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration

PoolEndpointConfiguration

Konfigurace pro koncové body na výpočetních uzlech ve fondu služby Batch
Konfigurace koncového bodu fondu se podporuje pouze u fondů s vlastností virtualMachineConfiguration.
publicIPAddressConfiguration

PublicIPAddressConfiguration

Konfigurace veřejné IP adresy pro výpočetní uzly ve fondu služby Batch.
Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration.
subnetId

string

Identifikátor prostředku ARM podsítě virtuální sítě, ke které se připojí výpočetní uzly fondu. Toto je ve formátu /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.
Virtuální síť musí být ve stejné oblasti a předplatném jako účet Azure Batch. Zadaná podsíť by měla mít dostatek volných IP adres, aby pojala počet uzlů ve fondu. Pokud podsíť nemá dostatek volných IP adres, fond částečně přidělí výpočetní uzly a dojde k chybě změny velikosti. Instanční objekt MicrosoftAzureBatch musí mít pro zadanou virtuální síť roli přispěvatele klasických virtuálních počítačů Role-Based Access Control (RBAC). Zadaná podsíť musí umožňovat komunikaci ze služby Azure Batch, aby bylo možné plánovat úlohy na výpočetních uzlech. Můžete to ověřit tak, že zkontrolujete, jestli má zadaná virtuální síť nějaké přidružené skupiny zabezpečení sítě (NSG). Pokud skupina zabezpečení sítě odmítne komunikaci s výpočetními uzly v zadané podsíti, nastaví služba Batch stav výpočetních uzlů na nepoužitelné. Pokud zadaná virtuální síť nemá žádné přidružené skupiny zabezpečení sítě (NSG), musí být pro několik vyhrazených systémových portů povolena příchozí komunikace. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 také port 22 pro Linux a port 3389 pro Windows. Pro fondy vytvořené s konfigurací cloudové služby povolte porty 10100, 20100 a 30100. Povolte také odchozí připojení ke službě Azure Storage na portu 443. Pro fondy cloudServiceConfiguration se podporují pouze klasické virtuální sítě. Další podrobnosti najdete tady: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Pravidlo skupiny zabezpečení sítě, které se použije na příchozí koncový bod.

Name Typ Description
access

NetworkSecurityGroupRuleAccess

Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku.
priority

integer

Priorita tohoto pravidla.
Priority v rámci fondu musí být jedinečné a vyhodnocují se v pořadí podle priority. Čím nižší je číslo, tím vyšší je priorita. Pravidla mohou být například určena s čísly objednávek 150, 250 a 350. Pravidlo s číslem objednávky 150 má přednost před pravidlem, které má pořadí 250. Povolené priority jsou 150 až 4096. Pokud jsou zadány rezervované nebo duplicitní hodnoty, požadavek selže se stavovým kódem HTTP 400.
sourceAddressPrefix

string

Předpona zdrojové adresy nebo značka, která se má shodovat s pravidlem.
Platnými hodnotami jsou jedna IP adresa (tj. 10.10.10.10), podsíť PROTOKOLU IP (tj. 192.168.1.0/24), výchozí značka nebo * (pro všechny adresy). Pokud jsou zadané nějaké další hodnoty, požadavek selže se stavovým kódem HTTP 400.
sourcePortRanges

string[]

Rozsahy zdrojových portů, které se mají shodovat s pravidlem.
Platné hodnoty jsou *(pro všechny porty 0 až 65535) nebo pole portů nebo rozsahy portů (tj. 100–200). Porty by měly být v rozsahu od 0 do 65535 a rozsahy portů nebo porty se nesmí překrývat. Pokud jsou zadané nějaké další hodnoty, požadavek selže se stavovým kódem HTTP 400. Výchozí hodnota bude *.

NetworkSecurityGroupRuleAccess

Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku.

Name Typ Description
Allow

string

Povolit přístup.
Deny

string

Odepřít přístup.

NFSMountConfiguration

Informace používané k připojení k systému souborů NFS

Name Typ Description
mountOptions

string

Další možnosti příkazového řádku, které se mají předat příkazu mount.
Toto jsou možnosti net use ve Windows a možnosti připojení v Linuxu.
relativeMountPath

string

Relativní cesta na výpočetním uzlu, kam se připojí systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch mounts a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.
source

string

Identifikátor URI systému souborů, který se má připojit.

NodeCommunicationMode

Určuje, jak fond komunikuje se službou Batch.

Name Typ Description
Classic

string

Uzly používající klasický režim komunikace vyžadují příchozí komunikaci TCP na portech 29876 a 29877 ze služby BatchNodeManagement. Značka služby {region} a odchozí komunikace TCP na portu 443 do "Storage.region" a "BatchNodeManagement. Značky služby {region}".
Default

string

Režim komunikace uzlu je automaticky nastaven službou Batch.
Simplified

string

Uzly používající zjednodušený režim komunikace vyžadují odchozí komunikaci TCP na portu 443 do "BatchNodeManagement. Značka služby {region}" Nejsou vyžadovány žádné otevřené příchozí porty.

NodePlacementConfiguration

Konfigurace umístění uzlů pro fondy dávek.

Name Typ Description
policy

NodePlacementPolicyType

Typ zásad umístění uzlů ve fondech služby Batch.
Zásady přidělování, které služba Batch používá ke zřizování uzlů. Pokud není zadáno, služba Batch použije místní zásady.

NodePlacementPolicyType

Zásady umístění pro přidělování uzlů ve fondu.

Name Typ Description
Regional

string

Všechny uzly ve fondu budou přiděleny ve stejné oblasti.
Zonal

string

Uzly ve fondu budou rozložené do různých zón s vyvažováním maximálního úsilí.

OSDisk

Nastavení pro disk operačního systému virtuálního počítače.

Name Typ Description
caching

CachingType

Určuje požadavky na ukládání do mezipaměti. Možné hodnoty jsou: None, ReadOnly, ReadWrite. Výchozí hodnoty jsou: Žádné pro úložiště úrovně Standard. ReadOnly pro Premium Storage.
diskSizeGB

integer

Počáteční velikost disku v GB při vytváření nového disku s operačním systémem
ephemeralOSDiskSettings

DiffDiskSettings

Určuje dočasné nastavení disku pro disk operačního systému používaný virtuálním počítačem.
managedDisk

ManagedDisk

Parametry spravovaného disku.
writeAcceleratorEnabled

boolean

Určuje, jestli má být na disku povolený nebo zakázaný writeAccelerator.

Pool

Obsahuje informace o fondu.

Name Typ Default value Description
etag

string

Značka ETag prostředku, která se používá pro příkazy souběžnosti.
id

string

ID prostředku.
identity

BatchPoolIdentity

Typ identity, který se používá pro fond služby Batch.
Typ identity, který se používá pro fond služby Batch.
name

string

Název prostředku.
properties.allocationState

AllocationState

Určuje, jestli fond provádí změnu velikosti.
properties.allocationStateTransitionTime

string

Čas, kdy fond vstoupil do aktuálního stavu přidělení.
properties.applicationLicenses

string[]

Seznam licencí aplikací, které služba Batch zpřístupní na každém výpočetním uzlu ve fondu.
Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud je požadována licence, která není podporovaná, vytvoření fondu se nezdaří.
properties.applicationPackages

ApplicationPackageReference[]

Seznam balíčků aplikací, které se mají nainstalovat na každý výpočetní uzel ve fondu.
Změny odkazů na balíčky aplikací mají vliv na všechny nové výpočetní uzly, které se připojují k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nereimagí. V každém fondu je maximálně 10 odkazů na balíčky aplikací.
properties.autoScaleRun

AutoScaleRun

Výsledky a chyby z posledního spuštění vzorce automatického škálování
Tato vlastnost je nastavena pouze v případě, že se fond automaticky škáluje, tj. používá se automatické škálováníSettings.
properties.certificates

CertificateReference[]

Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu.
U výpočetních uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. V případě linuxových výpočetních uzlů jsou certifikáty uložené v adresáři v pracovním adresáři úlohy a proměnná prostředí AZ_BATCH_CERTIFICATES_DIR je dodána úkolu, který se má dotazovat na toto umístění. Pro certifikáty s viditelností remoteUser se v domovském adresáři uživatele vytvoří adresář certs (např. /home/{uživatelské_jméno}/certs) a certifikáty se umístí do tohoto adresáře.

Upozornění: Tato vlastnost je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .
properties.creationTime

string

Čas vytvoření fondu.
properties.currentDedicatedNodes

integer

Počet vyhrazených výpočetních uzlů, které jsou aktuálně ve fondu.
properties.currentLowPriorityNodes

integer

Počet spotových výpočetních uzlů nebo výpočetních uzlů s nízkou prioritou, které jsou aktuálně ve fondu.
properties.currentNodeCommunicationMode

NodeCommunicationMode

Aktuální stav režimu komunikace fondu.
properties.deploymentConfiguration

DeploymentConfiguration

Tato vlastnost popisuje, jak se nasadí uzly fondu – pomocí Cloud Services nebo Virtual Machines.
Použití CloudServiceConfiguration určuje, že uzly by se měly vytvářet pomocí Azure Cloud Services (PaaS), zatímco VirtualMachineConfiguration používá Azure Virtual Machines (IaaS).
properties.displayName

string

Zobrazovaný název fondu.
Zobrazovaný název nemusí být jedinečný a může obsahovat jakékoli znaky Unicode až do maximální délky 1024.
properties.interNodeCommunication

InterNodeCommunicationState

Určuje, jestli fond umožňuje přímou komunikaci mezi uzly.
Tím se stanoví omezení, které uzly je možné přiřadit k fondu. Povolení této hodnoty může snížit pravděpodobnost přidělení požadovaného počtu uzlů ve fondu. Pokud není zadaný, bude tato hodnota ve výchozím nastavení zakázaná.
properties.lastModified

string

Čas poslední změny fondu.
Jedná se o poslední čas, kdy se data na úrovni fondu, například targetDedicatedNodes nebo autoScaleSettings, změnila. Nebere v potaz změny na úrovni uzlu, jako je změna stavu výpočetního uzlu.
properties.metadata

MetadataItem[]

Seznam dvojic název-hodnota přidružených k fondu jako metadata.
Služba Batch nepřiřazuje metadatům žádný význam; slouží výhradně k použití uživatelského kódu.
properties.mountConfiguration

MountConfiguration[]

Seznam systémů souborů, které se mají připojit k jednotlivým uzlům ve fondu.
To podporuje Azure Files, NFS, CIFS/SMB a Blobfuse.
properties.networkConfiguration

NetworkConfiguration

Konfigurace sítě pro fond.
Konfigurace sítě pro fond.
properties.provisioningState

PoolProvisioningState

Aktuální stav fondu.
properties.provisioningStateTransitionTime

string

Čas, kdy fond vstoupil do aktuálního stavu.
properties.resizeOperationStatus

ResizeOperationStatus

Obsahuje podrobnosti o aktuální nebo naposledy dokončené operaci změny velikosti.
Popisuje buď aktuální operaci (pokud je stav přidělení fondu Změna velikosti) nebo dříve dokončenou operaci (pokud je AllocationState stabilní).
properties.resourceTags

object

Uživatelem zadané značky přidružené k fondu.
Uživatelem definované značky, které mají být přidruženy k fondu Azure Batch. Po zadání se tyto značky rozšíří do záložních prostředků Azure přidružených k fondu. Tuto vlastnost lze zadat pouze v případě, že byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na UserSubscription.
properties.scaleSettings

ScaleSettings

Nastavení, která konfigurují počet uzlů ve fondu.
Definuje požadovanou velikost fondu. Může to být buď "fixedScale", kde je zadána požadovaná hodnota targetDedicatedNodes, nebo "autoScale", která definuje vzorec, který se pravidelně znovu vyhodnotuje. Pokud tato vlastnost není zadána, fond bude mít pevné škálování s 0 targetDedicatedNodes.
properties.startTask

StartTask

Úkol určený ke spuštění na každém výpočetním uzlu při připojení k fondu.
Při operaci PATCH (aktualizace) lze tuto vlastnost nastavit na prázdný objekt a odebrat tak spouštěcí úlohu z fondu.
properties.targetNodeCommunicationMode

NodeCommunicationMode

Požadovaný režim komunikace uzlu pro fond.
Pokud je vynechán, výchozí hodnota je Výchozí.
properties.taskSchedulingPolicy

TaskSchedulingPolicy

Způsob distribuce úkolů mezi výpočetní uzly ve fondu
Pokud není zadaný, je výchozí hodnota rozložena.
properties.taskSlotsPerNode

integer

1

Počet slotů úloh, které lze použít ke spouštění souběžných úloh na jednom výpočetním uzlu ve fondu.
Výchozí hodnota je 1. Maximální hodnota je menší ze 4násobku počtu jader vmSize fondu nebo 256.
properties.upgradePolicy

UpgradePolicy

Zásady upgradu pro fond.
Popisuje zásady upgradu – automatické, ruční nebo postupné.
properties.userAccounts

UserAccount[]

Seznam uživatelských účtů, které se mají vytvořit na každém uzlu ve fondu.
properties.vmSize

string

Velikost virtuálních počítačů ve fondu. Všechny virtuální počítače ve fondu mají stejnou velikost.
Informace o dostupných velikostech virtuálních počítačů pro fondy Cloud Services (fondy vytvořené pomocí cloudServiceConfiguration) najdete v tématu Velikosti pro Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch podporuje všechny velikosti virtuálních počítačů Cloud Services s výjimkou ExtraSmall. Informace o dostupných velikostech virtuálních počítačů pro fondy používající image z Virtual Machines Marketplace (fondy vytvořené pomocí virtualMachineConfiguration) najdete v tématu Velikosti pro Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti pro Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch podporuje všechny velikosti virtuálních počítačů Azure s výjimkou STANDARD_A0 a virtuálních počítačů se službou Premium Storage (řady STANDARD_GS, STANDARD_DS a STANDARD_DSV2).
type

string

Typ prostředku.

PoolEndpointConfiguration

Konfigurace koncového bodu pro fond

Name Typ Description
inboundNatPools

InboundNatPool[]

Seznam příchozích fondů NAT, které je možné použít k externímu adresování konkrétních portů na jednotlivých výpočetních uzlech.
Maximální počet příchozích fondů NAT na fond služby Batch je 5. Pokud je překročen maximální počet příchozích fondů NAT, požadavek selže se stavovým kódem HTTP 400. To nelze zadat, pokud IPAddressProvisioningType je NoPublicIPAddresses.

PoolIdentityType

Typ identity použité pro fond služby Batch.

Name Typ Description
None

string

K fondu služby Batch není přidružená žádná identita. Nastavení None ve fondu aktualizací odebere existující identity.
UserAssigned

string

Fond služby Batch má identity přiřazené uživatelem.

PoolProvisioningState

Aktuální stav fondu.

Name Typ Description
Deleting

string

Uživatel požádal o odstranění fondu, ale operace odstranění ještě nebyla dokončena.
Succeeded

string

Fond je k dispozici pro spouštění úkolů v závislosti na dostupnosti výpočetních uzlů.

PublicIPAddressConfiguration

Konfigurace veřejné IP adresy síťové konfigurace fondu.

Name Typ Description
ipAddressIds

string[]

Seznam veřejných IP adres, které bude služba Batch používat při zřizování výpočetních uzlů.
Zde zadaný počet IP adres omezuje maximální velikost fondu – pro každou veřejnou IP adresu je možné přidělit 100 vyhrazených uzlů nebo 100 spotových uzlů s nízkou prioritou. Například fond, který potřebuje 250 vyhrazených virtuálních počítačů, bude potřebovat aspoň 3 veřejné IP adresy. Každý prvek této kolekce má tvar: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.
provision

IPAddressProvisioningType

Typ zřizování pro veřejné IP adresy pro fond
Výchozí hodnota je BatchManaged.

ResizeError

Chyba, ke které došlo při změně velikosti fondu.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově.
details

ResizeError[]

Další podrobnosti o chybě
message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

ResizeOperationStatus

Podrobnosti o aktuální nebo poslední dokončené operaci změny velikosti

Name Typ Description
errors

ResizeError[]

Podrobnosti o všech chybách, ke kterým došlo při poslední změně velikosti fondu
Tato vlastnost je nastavena pouze v případě, že došlo k chybě při poslední změně velikosti fondu, a pouze v případě, že je stav přidělení fondu stabilní.
nodeDeallocationOption

ComputeNodeDeallocationOption

Určuje, co dělat s uzlem a jeho spuštěnými úkoly, pokud se velikost fondu zmenšuje.
Výchozí hodnota je opětovné zařazení do fronty.
resizeTimeout

string

Časový limit pro přidělení výpočetních uzlů do fondu nebo odebrání výpočetních uzlů z fondu.
Výchozí hodnota je 15 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch vrátí chybu; Pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (Chybný požadavek).
startTime

string

Čas, kdy byla tato operace změny velikosti spuštěna.
targetDedicatedNodes

integer

Požadovaný počet vyhrazených výpočetních uzlů ve fondu
targetLowPriorityNodes

integer

Požadovaný počet spotových výpočetních uzlů nebo výpočetních uzlů s nízkou prioritou ve fondu

ResourceFile

Jeden soubor nebo více souborů ke stažení do výpočetního uzlu

Name Typ Description
autoStorageContainerName

string

Název kontejneru úložiště v účtu automatického úložiště.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána.
blobPrefix

string

Předpona objektu blob, která se má použít při stahování objektů blob z kontejneru Azure Storage. Stáhnou se jenom objekty blob, jejichž názvy začínají zadanou předponou.
Vlastnost je platná pouze při použití autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečný název souboru nebo podadresář. Pokud není předpona zadána, stáhnou se všechny soubory v kontejneru.
fileMode

string

Atribut režimu oprávnění k souboru v osmičkovém formátu.
Tato vlastnost se vztahuje pouze na soubory stahované do výpočetních uzlů Linuxu. Pokud je zadaný pro resourceFile, který se stáhne do uzlu Windows, bude ignorován. Pokud tato vlastnost není určena pro uzel s Linuxem, použije se na soubor výchozí hodnota 0770.
filePath

string

Umístění na výpočetním uzlu, do kterého se má soubor stáhnout, vzhledem k pracovnímu adresáři úlohy.
Pokud je zadána vlastnost httpUrl, filePath je povinný a popisuje cestu, do které bude soubor stažen, včetně názvu souboru. Jinak pokud je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je nepovinný a je adresář ke stažení souborů do. V případě použití filePath jako adresáře se veškerá adresářová struktura, která je již přidružená ke vstupním datům, zachovají v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže být oddělena od pracovního adresáře úkolu (například pomocí ..).
httpUrl

string

Adresa URL souboru, který chcete stáhnout.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána. Pokud adresa URL odkazuje na Azure Blob Storage, musí být čitelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL pro objekt blob ve službě Azure Storage: patří sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použití spravované identity s oprávněním ke čtení nebo nastavení seznamu ACL pro objekt blob nebo jeho kontejner tak, aby umožňoval veřejný přístup.
identityReference

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup k Azure Blob Storage určené pomocí storageContainerUrl nebo httpUrl
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude používat výpočetní uzel.
storageContainerUrl

string

Adresa URL kontejneru objektů blob v rámci Azure Blob Storage.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána. Tato adresa URL musí být čitelná a vypsatelná z výpočetních uzlů. Existují tři způsoby, jak takovou adresu URL pro kontejner ve službě Azure Storage získat: můžete zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení a seznamu v kontejneru, použít spravovanou identitu s oprávněními ke čtení a seznamu seznamů nebo nastavit seznam ACL pro kontejner tak, aby umožňoval veřejný přístup.

RollingUpgradePolicy

Parametry konfigurace použité při provádění upgradu se zajištěním provozu

Name Typ Description
enableCrossZoneUpgrade

boolean

Povolte VMSS ignorovat hranice az při vytváření dávek upgradu. Při určení velikosti dávky vezměte v úvahu hodnoty Update Domain a maxBatchInstancePercent. Pokud toto pole není nastavené, Azure Azure Batch nenastaví výchozí hodnotu. Hodnota enableCrossZoneUpgrade na vytvořené VirtualMachineScaleSet bude rozhodována výchozími konfiguracemi na VirtualMachineScaleSet. Toto pole je možné nastavit na hodnotu true nebo false pouze v případě, že jako zónovou hodnotu použijete NodePlacementConfiguration.
maxBatchInstancePercent

integer

Maximální procento z celkového počtu instancí virtuálních počítačů, které se upgradují současně při postupném upgradu v jedné dávce. Vzhledem k tomu, že se jedná o maximum, instance, které nejsou v pořádku, v předchozích nebo budoucích dávkách můžou způsobit snížení procenta instancí v dávce, aby byla zajištěna vyšší spolehlivost. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být větší než maxUnhealthyInstancePercent.
maxUnhealthyInstancePercent

integer

Maximální procento celkového počtu instancí virtuálních počítačů ve škálovací sadě, které můžou být současně v pořádku, ať už v důsledku upgradu, nebo v důsledku zjištění stavu virtuálního počítače ve špatném stavu kontrolou stavu před přerušením postupného upgradu. Toto omezení bude zkontrolováno před spuštěním jakékoli dávky. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být větší než maxUnhealthyInstancePercent.
maxUnhealthyUpgradedInstancePercent

integer

Maximální procento upgradovaných instancí virtuálních počítačů, které jsou ve špatném stavu. Tato kontrola proběhne po upgradu každé dávky. Pokud je toto procento někdy překročeno, průběžná aktualizace se přeruší. Hodnota tohoto pole by měla být mezi 0 a 100 (včetně).
pauseTimeBetweenBatches

string

Doba čekání mezi dokončením aktualizace všech virtuálních počítačů v jedné dávce a spuštěním další dávky Doba trvání by měla být zadána ve formátu ISO 8601.
prioritizeUnhealthyInstances

boolean

Upgradujte všechny instance, které nejsou v pořádku, ve škálovací sadě před instancemi, které jsou v pořádku.
rollbackFailedInstancesOnPolicyBreach

boolean

Vrácení neúspěšných instancí do předchozího modelu v případě porušení zásad postupného upgradu

ScaleSettings

Nastavení škálování fondu

Name Typ Description
autoScale

AutoScaleSettings

Nastavení automatického škálování fondu
Tato vlastnost a fixedScale se vzájemně vylučují a musí být zadána jedna z vlastností.
fixedScale

FixedScaleSettings

Opravili jsme nastavení škálování fondu.
Tato vlastnost a automatické škálování se vzájemně vylučují a musí být zadána jedna z vlastností.

SecurityProfile

Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.

Name Typ Description
encryptionAtHost

boolean

Tuto vlastnost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím se povolí šifrování pro všechny disky, včetně disku prostředku nebo dočasného disku v samotném hostiteli.
securityType

SecurityTypes

Určuje SecurityType virtuálního počítače. Pokud chcete povolit UefiSettings, musí být nastavena na libovolnou zadanou hodnotu.
uefiSettings

UefiSettings

Určuje nastavení zabezpečení, jako je zabezpečené spouštění a virtuální počítač vTPM použitý při vytváření virtuálního počítače.
Určuje nastavení zabezpečení, jako je zabezpečené spouštění a virtuální počítač vTPM použitý při vytváření virtuálního počítače.

SecurityTypes

Určuje typ zabezpečení virtuálního počítače. Aby bylo možné UefiSettings povolit, musí být nastavená na libovolnou zadanou hodnotu.

Name Typ Description
trustedLaunch

string

Důvěryhodné spuštění chrání před pokročilými a trvalými technikami útoku.

ServiceArtifactReference

Určuje REFERENČNÍ ID artefaktu služby, které se používá k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image.

Name Typ Description
id

string

ID odkazu na artefakt služby ServiceArtifactReference
Referenční ID artefaktu služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StartTask

Úloha, která se spustí, když se výpočetní uzel připojí k fondu ve službě Azure Batch nebo když se výpočetní uzel restartuje nebo znovu zmage.

Name Typ Default value Description
commandLine

string

Příkazový řádek spouštěcí úlohy.
Příkazový řádek se nespouští v prostředí, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd /c MyCommand" ve Windows nebo "/bin/sh -c MyCommand" v Linuxu. Požadováno, pokud jsou zadány jakékoli jiné vlastnosti startTask.
containerSettings

TaskContainerSettings

Nastavení kontejneru, ve kterém se spouští úloha spuštění.
Po zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru.
environmentSettings

EnvironmentSetting[]

Seznam nastavení proměnných prostředí pro spouštěcí úlohu.
maxTaskRetryCount

integer

0

Maximální počet opakování úkolu.
Služba Batch opakuje úlohu, pokud její ukončovací kód není nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch tuto úlohu jednou vyzkouší a pak to může opakovat až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch zkusí úlohu až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch nezkusí úlohu zopakovat. Pokud je maximální počet opakování -1, služba Batch opakuje úlohu bez omezení. Výchozí hodnota je 0.
resourceFiles

ResourceFile[]

Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku.
userIdentity

UserIdentity

Identita uživatele, pod kterou se spouští úloha spuštění.
Pokud je úloha vynechána, spustí se jako uživatel, který není pro danou úlohu jedinečný.
waitForSuccess

boolean

Zda má služba Batch čekat na úspěšné dokončení spouštěcího úkolu (tj. na ukončení s ukončovacím kódem 0) před plánováním úkolů na výpočetním uzlu.
Pokud je hodnota true a spouštěcí úloha selže na výpočetním uzlu, služba Batch opakuje spouštěcí úlohu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol ani po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje pro něj úkoly. Tuto podmínku je možné zjistit prostřednictvím podrobností o stavu uzlu a plánování chyby. Pokud je hodnota false, služba Batch nebude čekat na dokončení spouštěcí úlohy. V takovém případě se na výpočetním uzlu můžou spustit další úlohy, zatímco je spouštěcí úloha stále spuštěná. a i když se spouštěcí úkol nezdaří, budou nové úkoly dál naplánované na uzlu. Výchozí hodnota je true.

StorageAccountType

Typ účtu úložiště, který se použije při vytváření datových disků nebo disků s operačním systémem.

Name Typ Description
Premium_LRS

string

Datový disk nebo disk s operačním systémem by měl používat místně redundantní úložiště úrovně Premium.
StandardSSD_LRS

string

Datový disk nebo disk s operačním systémem by měl používat standardní místně redundantní úložiště SSD.
Standard_LRS

string

Datový disk nebo disk s operačním systémem by měl používat standardní místně redundantní úložiště.

TaskContainerSettings

Nastavení kontejneru pro úlohu

Name Typ Description
containerRunOptions

string

Další možnosti příkazu container create
Tyto další možnosti jsou kromě možností řízených službou Batch k dispozici jako argumenty příkazu docker create.
imageName

string

Image, která se má použít k vytvoření kontejneru, ve kterém bude úloha spuštěna.
Toto je úplný odkaz na image, který by byl zadán pro "docker pull". Pokud jako součást názvu obrázku není uvedena žádná značka, použije se jako výchozí značka ":latest".
registry

ContainerRegistry

Privátní registr, který obsahuje image kontejneru.
Toto nastavení je možné vynechat, pokud už jste ho zadali při vytváření fondu.
workingDirectory

ContainerWorkingDirectory

Příznak označující, kde je pracovní adresář úlohy kontejneru. Výchozí hodnota je taskWorkingDirectory.

TaskSchedulingPolicy

Určuje, jak se mají úkoly distribuovat mezi výpočetní uzly.

Name Typ Default value Description
nodeFillType

ComputeNodeFillType

Spread

Způsob distribuce úloh mezi výpočetní uzly

UefiSettings

Určuje nastavení zabezpečení, jako je zabezpečené spouštění a virtuálnítpm použité při vytváření virtuálního počítače.

Name Typ Description
secureBootEnabled

boolean

Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění.
vTpmEnabled

boolean

Určuje, jestli se má na virtuálním počítači povolit vTPM.

UpgradeMode

Určuje režim upgradu na virtuální počítače ve škálovací sadě.

Možné hodnoty:

Ruční – řídíte aplikaci aktualizací na virtuální počítače ve škálovací sadě. Provedete to pomocí akce manualUpgrade.

Automaticky – všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně.

Rolling – Škálovací sada provádí aktualizace v dávkách s volitelnou dobou pozastavení mezi.

Name Typ Description
automatic

string

Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně.
manual

string

Aplikaci aktualizací virtuálních počítačů ve škálovací sadě řídíte. Provedete to pomocí akce manualUpgrade.
rolling

string

Existující instance ve škálovací sadě se snesou v dávkách, které se mají upgradovat. Po dokončení upgradované dávky začnou instance znovu přijímat provoz a další dávka začne. To bude pokračovat, dokud nebudou všechny instance aktualizované.

UpgradePolicy

Popisuje zásady upgradu – automatické, ruční nebo průběžné.

Name Typ Description
automaticOSUpgradePolicy

AutomaticOSUpgradePolicy

Konfigurační parametry používané k automatickému upgradu operačního systému.
Konfigurační parametry použité k provedení automatického upgradu operačního systému.
mode

UpgradeMode

Určuje režim upgradu na virtuální počítače ve škálovací sadě.

Možné hodnoty:

Ručně – Aplikaci aktualizací virtuálních počítačů ve škálovací sadě řídíte vy. Provedete to pomocí ruční akceUpgrade.

Automaticky – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují najednou.

Zajištění provozu – Škálovací sada provádí aktualizace v dávkách, mezi kterými je volitelná doba pozastavení.
rollingUpgradePolicy

RollingUpgradePolicy

Parametry konfigurace použité při provádění upgradu se zajištěním provozu.
Tato vlastnost je podporována pouze u fondů s vlastností virtualMachineConfiguration.

UserAccount

Vlastnosti použité k vytvoření uživatele v uzlu Azure Batch.

Name Typ Description
elevationLevel

ElevationLevel

Úroveň zvýšení oprávnění uživatelského účtu.
nonAdmin – automatický uživatel je standardní uživatel bez zvýšeného přístupu. admin – automatický uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce. Výchozí hodnota je nonAdmin.
linuxUserConfiguration

LinuxUserConfiguration

Konfigurace uživatele specifické pro Linux pro uživatelský účet.
Tato vlastnost se ignoruje, pokud je zadána ve fondu Windows. Pokud není zadaný, uživatel se vytvoří s výchozími možnostmi.
name

string

Název uživatelského účtu. Názvy můžou obsahovat libovolné znaky Unicode až do maximální délky 20.
password

string

Heslo k uživatelskému účtu.
windowsUserConfiguration

WindowsUserConfiguration

Konfigurace uživatele specifická pro systém Windows pro uživatelský účet.
Tuto vlastnost je možné zadat pouze v případě, že je uživatel ve fondu Windows. Pokud není zadáno a ve fondu Windows, uživatel se vytvoří s výchozími možnostmi.

UserAssignedIdentities

Seznam přidružených identit uživatelů.

Name Typ Description
clientId

string

ID klienta identity přiřazené uživatelem.
principalId

string

ID objektu zabezpečení identity přiřazené uživatelem.

UserIdentity

Definice identity uživatele, pod kterou je úloha spuštěna.

Name Typ Description
autoUser

AutoUserSpecification

Automatický uživatel, pod kterým je úloha spuštěna.
Vlastnosti userName a autoUser se vzájemně vylučují; musíte zadat jeden, ale ne oba.
userName

string

Název identity uživatele, pod kterou je úloha spuštěna.
Vlastnosti userName a autoUser se vzájemně vylučují; musíte zadat jeden, ale ne oba.

VirtualMachineConfiguration

Konfigurace výpočetních uzlů ve fondu na základě infrastruktury Azure Virtual Machines.

Name Typ Description
containerConfiguration

ContainerConfiguration

Konfigurace kontejneru pro fond.
Pokud je tato možnost zadána, provede se nastavení na každém uzlu ve fondu, aby se úlohy mohly spouštět v kontejnerech. Všechny běžné úlohy a úlohy správce úloh spuštěné v tomto fondu musí zadat vlastnost containerSettings a všechny ostatní úlohy ji mohou určit.
dataDisks

DataDisk[]

Konfigurace datových disků připojených k výpočetním uzlům ve fondu
Tato vlastnost musí být zadána, pokud výpočetní uzly ve fondu potřebují mít připojené prázdné datové disky.
diskEncryptionConfiguration

DiskEncryptionConfiguration

Konfigurace šifrování disku pro fond.
Pokud je zadáno, šifrování se provádí na každém uzlu ve fondu během zřizování uzlů.
extensions

VMExtension[]

Rozšíření virtuálního počítače pro fond.
Pokud je tato hodnota zadána, rozšíření uvedená v této konfiguraci se nainstalují na každý uzel.
imageReference

ImageReference

Odkaz na image Azure Virtual Machines Marketplace nebo vlastní image virtuálního počítače, která se má použít.
licenseType

string

Typ místní licence, která se má použít při nasazování operačního systému.
To platí jenom pro image, které obsahují operační systém Windows, a měly by se používat jenom v případě, že máte platné místní licence pro uzly, které se nasadí. Pokud je tato možnost vynechána, neuplatní se žádná sleva za místní licencování. Hodnoty jsou:

Windows_Server – místní licence je určená pro Windows Server. Windows_Client – místní licence je určená pro klienta Windows.
nodeAgentSkuId

string

Skladová položka agenta uzlu Batch, která se má zřídit na výpočetních uzlech ve fondu.
Agent uzlu Batch je program, který běží na každém uzlu ve fondu a poskytuje rozhraní příkazů a řízení mezi uzlem a službou Batch. Existují různé implementace agenta uzlu, označované jako skladové položky, pro různé operační systémy. Je nutné zadat skladovou položku agenta uzlu, která odpovídá vybranému odkazu na image. Pokud chcete získat seznam podporovaných skladových položek agentů uzlů spolu se seznamem ověřených odkazů na image, projděte si operaci Výpis podporovaných skladových položek agenta uzlů.
nodePlacementConfiguration

NodePlacementConfiguration

Konfigurace umístění uzlu pro fond.
Tato konfigurace určí pravidla, jak se budou uzly ve fondu fyzicky přidělovat.
osDisk

OSDisk

Nastavení pro disk operačního systému virtuálního počítače.
Obsahuje konfiguraci pro dočasné nastavení disku OSDisk.
securityProfile

SecurityProfile

Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.
Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.
serviceArtifactReference

ServiceArtifactReference

Určuje REFERENČNÍ ID artefaktu služby, které se používá k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image.
Referenční ID artefaktu služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}
windowsConfiguration

WindowsConfiguration

Nastavení operačního systému Windows na virtuálním počítači.
Tato vlastnost nesmí být zadána, pokud imageReference určuje image operačního systému Linux.

VMExtension

Konfigurace pro rozšíření virtuálních počítačů

Name Typ Description
autoUpgradeMinorVersion

boolean

Označuje, jestli by rozšíření mělo používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.
enableAutomaticUpgrade

boolean

Určuje, jestli má platforma rozšíření automaticky upgradovat, pokud je k dispozici novější verze rozšíření.
name

string

Název rozšíření virtuálního počítače.
protectedSettings

object

Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault nebo vůbec žádné chráněné nastavení.
provisionAfterExtensions

string[]

Kolekce názvů rozšíření.
Kolekce názvů rozšíření, po které je potřeba toto rozšíření zřídit.
publisher

string

Název vydavatele obslužné rutiny rozšíření.
settings

object

Veřejná nastavení rozšíření formátovaná ve formátu JSON
type

string

Typ rozšíření.
typeHandlerVersion

string

Verze obslužné rutiny skriptu.

WindowsConfiguration

Nastavení operačního systému Windows, která se mají použít pro virtuální počítač.

Name Typ Description
enableAutomaticUpdates

boolean

Určuje, jestli jsou na virtuálním počítači povolené automatické aktualizace.
Pokud je vynechán, výchozí hodnota je true.

WindowsUserConfiguration

Vlastnosti použité k vytvoření uživatelského účtu na uzlu Windows.

Name Typ Description
loginMode

LoginMode

Režim přihlášení pro uživatele
Určuje režim přihlášení pro uživatele. Výchozí hodnota pro fondy VirtualMachineConfiguration je interaktivní režim a pro fondy CloudServiceConfiguration je dávkový režim.