Sdílet prostřednictvím

Pool - Create

  • Reference
Služba:
Batch Management
Verze rozhraní API:
2024-07-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-07-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. To 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 formátovaný identifikátorem 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, bude vždy použita.
If-None-Match

string

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

Text požadavku

Name Typ Description
identity

BatchPoolIdentity

Typ identity, který se používá pro fond batch.
Typ identity, který se používá pro fond 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žaduje licence, která se nepodporuje, 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í ovlivňují všechny nové výpočetní uzly připojující se k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nezomagí. V jakémkoli 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.
Pro výpočetní uzly Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři.

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

DeploymentConfiguration

Tato vlastnost popisuje virtuální počítače, na které se budou nasazovat uzly fondu.
properties.displayName

string

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

InterNodeCommunicationState

Určuje, jestli fond povoluje přímou komunikaci mezi uzly.
To platí pro omezení, ke kterým uzlům je možné přiřadit fond. Povolení této hodnoty může snížit pravděpodobnost přidělení požadovaného počtu uzlů ve fondu. Pokud není zadána, tato hodnota je ve výchozím nastavení zakázaná.
properties.metadata

MetadataItem[]

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

MountConfiguration[]

Seznam systémů souborů, které se mají připojit ke každému uzlu ve fondu.
To podporuje Soubory Azure, 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é se mají přidružit 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 při vytvoření účtu Batch 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án požadovaný cílovýDedicatedNodes, nebo "autoScale", který definuje vzorec, který se pravidelně znovu vyhodnocuje. Pokud tato vlastnost není zadána, bude mít fond pevné škálování s 0 targetDedicatedNodes.
properties.startTask

StartTask

Úloha zadaná ke spuštění na každém výpočetním uzlu, když se připojí k fondu.
V operaci PATCH (update) lze tuto vlastnost nastavit na prázdný objekt, který odebere spouštěcí úlohu z fondu.
properties.targetNodeCommunicationMode

NodeCommunicationMode

Režim komunikace požadovaného uzlu pro fond.
Pokud tuto hodnotu vynecháte, výchozí hodnota je Výchozí.
properties.taskSchedulingPolicy

TaskSchedulingPolicy

Jak se úkoly distribuují mezi výpočetní uzly ve fondu.
Pokud není zadáno, výchozí hodnota se rozloží.
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ší 4krát počet 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čů najdete v tématu Velikosti virtuálních počítačů (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti virtuálních počítačů (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 těch, které mají službu Premium Storage (STANDARD_GS, STANDARD_DS a STANDARD_DSV2 series).
tags

object

Značky prostředku.

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

Tok ověřovacího kódu Microsoft Entra 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 VirtualMachineConfiguration
CreatePool - Minimal VirtualMachineConfiguration
CreatePool - No public IP
CreatePool - Public IPs
CreatePool - ResourceTags
CreatePool - SecurityProfile
CreatePool - Tags
CreatePool - UpgradePolicy
CreatePool - UserAssignedIdentities
CreatePool - VirtualMachineConfiguration Extensions
CreatePool - VirtualMachineConfiguration OSDisk
CreatePool - VirtualMachineConfiguration ServiceArtifactReference

CreatePool - accelerated networking

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-07-01

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

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-07-01

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

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 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-07-01

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

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 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-07-01

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

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-07-01

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

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-07-01

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

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-07-01

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

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-07-01

{
  "properties": {
    "vmSize": "Standard_d4s_v3",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "UbuntuServer",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04",
        "securityProfile": {
          "securityType": "trustedLaunch",
          "encryptionAtHost": true,
          "uefiSettings": {
            "secureBootEnabled": null,
            "vTpmEnabled": false
          }
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    }
  }
}

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

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-07-01

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

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": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 22.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0,
        "resizeTimeout": "PT15M"
      }
    },
    "resizeOperationStatus": {
      "targetDedicatedNodes": 1,
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-09-27T07:33:13.0625789Z"
    },
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0
  },
  "tags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  }
}

CreatePool - UpgradePolicy

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-07-01

{
  "properties": {
    "vmSize": "Standard_d4s_v3",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "MicrosoftWindowsServer",
          "offer": "WindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "upgradePolicy": {
      "mode": "automatic",
      "automaticOSUpgradePolicy": {
        "disableAutomaticRollback": true,
        "enableAutomaticOSUpgrade": true,
        "useRollingUpgradePolicy": true,
        "osRollingUpgradeDeferral": true
      },
      "rollingUpgradePolicy": {
        "enableCrossZoneUpgrade": true,
        "maxBatchInstancePercent": 20,
        "maxUnhealthyInstancePercent": 20,
        "maxUnhealthyUpgradedInstancePercent": 20,
        "pauseTimeBetweenBatches": "PT0S",
        "prioritizeUnhealthyInstances": false,
        "rollbackFailedInstancesOnPolicyBreach": false
      }
    }
  }
}

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-07-01

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

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-07-01

{
  "properties": {
    "vmSize": "STANDARD_D4",
    "scaleSettings": {
      "autoScale": {
        "formula": "$TargetDedicatedNodes=1",
        "evaluationInterval": "PT5M"
      }
    },
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-focal",
          "sku": "20_04-lts"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 20.04",
        "extensions": [
          {
            "name": "batchextension1",
            "type": "KeyVaultForLinux",
            "publisher": "Microsoft.Azure.KeyVault",
            "typeHandlerVersion": "2.0",
            "autoUpgradeMinorVersion": true,
            "enableAutomaticUpgrade": true,
            "settings": {
              "secretsManagementSettingsKey": "secretsManagementSettingsValue",
              "authenticationSettingsKey": "authenticationSettingsValue"
            }
          }
        ]
      }
    },
    "targetNodeCommunicationMode": "Default"
  }
}

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-07-01

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

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-07-01

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

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 fond provádí změnu velikosti.
ApplicationPackageReference

Propojení balíčku aplikace v rámci účtu Batch
AutomaticOSUpgradePolicy

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

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

Při automatickém škálování fondu došlo k chybě.
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 používané k připojení ke kontejneru služby Azure Storage pomocí blobfuse
AzureFileShareConfiguration

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

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

Typ ukládání do mezipaměti pro disk.
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 chcete 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é pro připojení k systému souborů CIFS.
CloudError

Odpověď na chybu ze služby Batch
CloudErrorBody

Odpověď na chybu ze služby Batch
ComputeNodeDeallocationOption

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

Jak se mají úkoly distribuovat napříč výpočetními uzly.
ComputeNodeIdentityReference

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

Konfigurace pro fondy s podporou kontejneru.
ContainerHostBatchBindMountEntry

Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh.
ContainerHostDataPath

Cesty, které budou připojeny ke kontejneru úlohy kontejneru.
ContainerRegistry

Privátní registr kontejneru.
ContainerType

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

Příznak označující, kde je pracovní adresář úloh 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. Při použití připojených datových disků je potřeba disky připojit a naformátovat z virtuálního počítače, aby je bylo možné použít.
DeploymentConfiguration

Vlastnosti konfigurace nasazení
DiffDiskPlacement

Určuje dočasné umístění 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í uzly ve fondu. Konfigurace šifrování disků není podporována ve fondu Linuxu vytvořeném s imagí virtuálního počítače nebo imagí galerie výpočetních prostředků Azure.
DiskEncryptionTarget

Seznam cílů disku, které služba Batch service zašifruje na výpočetním uzlu
DynamicVNetAssignmentScope

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

Úroveň zvýšení úrovně uživatele
EnvironmentSetting

Proměnná prostředí, která se má nastavit pro proces ú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í Ověřených službou Azure Batch, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu.
InboundEndpointProtocol

Protokol koncového bodu.
InboundNatPool

Příchozí fond NAT, který lze použít k řešení konkrétních portů na výpočetních uzlech ve fondu Batch externě.
InterNodeCommunicationState

Určuje, jestli fond povoluje přímou komunikaci mezi uzly.
IPAddressProvisioningType

Typ zřizování pro veřejné IP adresy pro fond batch.
LinuxUserConfiguration

Vlastnosti použité k vytvoření uživatelského účtu v uzlu Linuxu
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 u příchozího koncového bodu.
NetworkSecurityGroupRuleAccess

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

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

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

Konfigurace umístění uzlu 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, který se používá pro fond batch.
PoolProvisioningState

Aktuální stav fondu.
PublicIPAddressConfiguration

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

Při změně velikosti fondu došlo k chybě.
ResizeOperationStatus

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

Jeden soubor nebo více souborů, které se mají stáhnout do výpočetního uzlu.
RollingUpgradePolicy

Parametry konfigurace použité při postupném upgradu.
ScaleSettings

Nastavení škálování fondu
SecurityEncryptionTypes

Určuje Typ šifrování spravovaného disku. Je nastavená na VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: Při použití důvěrných virtuálních počítačů je možné ho nastavit pouze pro důvěrné virtuální počítače a vyžadovat.
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é povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu.
ServiceArtifactReference

Určuje ID odkazu na artefakt služby použité 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í při připojení výpočetního uzlu k fondu ve službě Azure Batch nebo při restartování nebo obnovení výpočetního uzlu.
StorageAccountType

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

Nastavení kontejneru pro úlohu.
TaskSchedulingPolicy

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

Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM 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í virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade.

Automatické – 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 postupné.
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 se úloha spouští.
VirtualMachineConfiguration

Konfigurace výpočetních uzlů ve fondu založená na infrastruktuře virtuálních počítačů Azure.
VMDiskSecurityProfile

Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Je možné ji nastavit pouze pro důvěrné virtuální počítače a je vyžadována při použití důvěrných virtuálních počítačů.
VMExtension

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

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

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

AllocationState

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

Name Typ Description
Resizing

string

Fond provádí změnu velikosti; to znamená, že se do fondu přidávají nebo odebírají výpočetní uzly.
Steady

string

Fond velikost neskončuje. Počet probíhajících uzlů ve fondu se nijak nemění. Fond zadá tento stav při jeho vytvoření a když ve fondu neprovádí žádné operace, aby se změnil počet uzlů.
Stopping

string

Fond změnil velikost, ale uživatel požádal o zastavení změny velikosti, ale žádost o zastavení ještě nebyla dokončena.

ApplicationPackageReference

Propojení balíčku aplikace v rámci úč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 o odkaz na konkrétní verzi nebo výchozí verzi, pokud existuje.
version

string

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

AutomaticOSUpgradePolicy

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

Name Typ Description
disableAutomaticRollback

boolean

Určuje, jestli má být funkce vrácení image operačního systému zakázaná.
enableAutomaticOSUpgrade

boolean

Označuje, jestli se upgrady operačního systému mají automaticky použít u instancí škálovací sady, a to v případě, že bude k dispozici novější verze image operačního systému.

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

boolean

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

boolean

Označuje, jestli se při automatickém upgradu operačního systému mají používat zásady postupného upgradu. Pokud v sadě VMSS není definovaná žádná zásada, automatický upgrade operačního systému se vrátí k výchozím zásadám.

AutoScaleRun

Výsledky a chyby při provádě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 posledního vyhodnocení vzorce automatického škálování
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é se vrátí ve formuláři $variable=value a proměnné jsou oddělené středníky.

AutoScaleRunError

Při automatickém škálování fondu došlo k chybě.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity 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á velikost fondu automaticky upravit podle vzorce automatického škálování.
Pokud tuto hodnotu vynecháte, 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 úloha se spustí jako běžný automatický uživatelský účet, který se vytvoří na každém uzlu ve fondu.
Task

string

Určuje, že služba by měla pro úkol 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 neníadmin.
scope

AutoUserScope

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

AzureBlobFileSystemConfiguration

Informace používané k připojení ke kontejneru služby Azure Storage pomocí blobfuse

Name Typ Description
accountKey

string

Klíč účtu úložiště Azure.
Tato vlastnost se vzájemně vylučují s sasKey i identitou; musí být zadána přesně jedna.
accountName

string

Název účtu úložiště Azure.
blobfuseOptions

string

Další možnostipříkazového
Jedná se o možnosti net use ve Windows a připojení v Linuxu.
containerName

string

Název kontejneru služby Azure Blob Storage.
identityReference

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem pro přístup k názvu kontejneru
Tato vlastnost se vzájemně vylučují s accountKey i sasKey; musí být zadána přesně jedna.
relativeMountPath

string

Relativní cesta na výpočetním uzlu, kde se připojí systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, 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čují s accountKey i identitou; musí být zadána přesně jedna.

AzureFileShareConfiguration

Informace používané 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 služby Soubory Azure.
Toto je formulář "https://{account}.file.core.windows.net/".
mountOptions

string

Další možnostipříkazového
Jedná se o možnosti net use ve Windows a připojení v Linuxu.
relativeMountPath

string

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

BatchPoolIdentity

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

Name Typ Description
type

PoolIdentityType

Typ identity, který se používá pro fond batch.
userAssignedIdentities

<string,  UserAssignedIdentities>

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

CachingType

Typ ukládání do mezipaměti pro disk.

Name Typ Description
None

string

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

string

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

string

Režim ukládání do mezipaměti disku 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 chcete certifikát nainstalovat.
Výchozí hodnota je currentUser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s výpočetními uzly Windows. Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři.
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 výpočetními uzly Windows. Mezi běžné názvy obchodů patří: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale můžete také použít jakýkoli vlastní název úložiště. 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 chcete 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řistupuje 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 fondem pro starttask i úlohu, bude tento certifikát viditelný i pro úlohu.
Task

string

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

CIFSMountConfiguration

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

Name Typ Description
mountOptions

string

Další možnostipříkazového
Jedná se o možnosti net use ve Windows a připojení v Linuxu.
password

string

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

string

Relativní cesta na výpočetním uzlu, kde se připojí systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, 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 k ověřování v systému souborů CIFS.

CloudError

Odpověď na chybu ze služby Batch

Name Typ Description
error

CloudErrorBody

Text odpovědi na chybu.

CloudErrorBody

Odpověď na chybu ze služby Batch

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity 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ě.

ComputeNodeDeallocationOption

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

Name Typ Description
Requeue

string

Ukončete spuštěné procesy úloh a znovu zakažte úkoly. Úlohy se spustí znovu, jakmile bude uzel k dispozici. Jakmile budou úkoly ukončeny, odeberte uzly.
RetainedData

string

Povolte dokončení aktuálně spuštěných úkolů a počkejte na vypršení platnosti všech období uchovávání dat úkolů. Při čekání neplánujte žádné nové úkoly. Odeberte uzly, pokud vypršela platnost všech období uchovávání úkolů.
TaskCompletion

string

Povolit dokončení aktuálně spuštěných úkolů. Při č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í, které indikuje, že byly ukončeny, a nebudou znovu spuštěny. Jakmile budou úkoly ukončeny, odeberte uzly.

ComputeNodeFillType

Jak se mají úkoly distribuovat napříč výpočetními uzly.

Name Typ Description
Pack

string

Co nejvíce úkolů (taskSlotsPerNode) by mělo být přiřazeno každému uzlu ve fondu před přiřazením všech úkolů 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 Batch, který bude používat výpočetní uzel.

Name Typ Description
resourceId

string

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

ContainerConfiguration

Konfigurace pro fondy s podporou kontejneru.

Name Typ Description
containerImageNames

string[]

Kolekce názvů imagí kontejneru.
Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Image bude zdrojem z výchozího registru Dockeru, pokud není image plně kvalifikovaná s alternativním registrem.
containerRegistries

ContainerRegistry[]

Další privátní registry, ze kterých je možné načíst kontejnery.
Pokud se některé image musí stáhnout 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.

ContainerHostBatchBindMountEntry

Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh.

Name Typ Description
isReadOnly

boolean

Připojte tuto zdrojovou cestu jako režim jen pro čtení nebo ne. Výchozí hodnota je false (režim čtení a zápisu).
Pokud tuto cestu pro Linux připojíte jako režim pro čtení a zápis, neznamená to, že všichni uživatelé v kontejneru mají pro cestu přístup pro čtení a zápis, závisí na přístupu na hostitelském virtuálním počítači. Pokud je tato cesta připojená jen pro čtení, nebudou moct změnit cestu všichni uživatelé v kontejneru.
source

ContainerHostDataPath

Cestu, která se připojí k zákazníkovi kontejneru, může vybrat.

ContainerHostDataPath

Cesty, které budou připojeny ke kontejneru úlohy kontejneru.

Name Typ Description
Applications

string

Cesta k aplikacím.
JobPrep

string

Cesta úkolu přípravy úlohy.
Shared

string

Cesta pro úlohu s více instancemi ke sdílení souborů.
Startup

string

Cesta ke spouštěcímu úkolu.
Task

string

Cesta k úkolu.
VfsMounts

string

Cesta obsahuje všechny virtuální systémy souborů, které jsou připojené k tomuto uzlu.

ContainerRegistry

Privátní registr kontejneru.

Name Typ Description
identityReference

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup ke službě 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 Batch, který bude používat výpočetní uzel.
password

string

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

string

Adresa URL registru.
Pokud tuto hodnotu 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 založená na CRI.
DockerCompatible

string

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

ContainerWorkingDirectory

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

Name Typ Description
ContainerImageDefault

string

Použití pracovního adresáře definovaného image kontejneru Mějte na pozor, ž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. Při použití připojených datových disků je potřeba disky připojit a naformátovat z virtuálního počítače, aby je bylo možné použít.

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 disku 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 disku je čtení a zápis.

Výchozí hodnota pro ukládání do mezipaměti není žádná. Informace o možnostech ukládání do mezipaměti naleznete v tématu: 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ý by měl mít jinou logickou jednotku. Hodnota musí být v rozmezí od 0 do 63 včetně.
storageAccountType

StorageAccountType

Typ účtu úložiště, který se má použít pro datový disk.
Pokud tuto hodnotu vynecháte, 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
virtualMachineConfiguration

VirtualMachineConfiguration

Konfigurace virtuálního počítače pro fond.

DiffDiskPlacement

Určuje dočasné umístění 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 dočasné umístění 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í, ve kterém má být operační systém. Například místo na disku mezipaměti pro dočasné zřizování disku s operačním systémem. Další informace o požadavcích na dočasné velikosti disku s operačním systémem najdete v dočasných požadavcích na velikost 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ích počítačích s Linuxem na 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í uzly ve fondu. Konfigurace šifrování disků není podporována ve fondu Linuxu vytvořeném s imagí virtuálního počítače nebo imagí galerie výpočetních prostředků Azure.

Name Typ Description
targets

DiskEncryptionTarget[]

Seznam cílů disku, které služba Batch service zašifruje 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ílů disku, které služba Batch service zašifruje 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 oddíly na připojených datových discích), když dojde k šifrování 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 prosím na podporu.
none

string

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

ElevationLevel

Úroveň zvýšení úrovně 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 pro proces ú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 tuto hodnotu vynecháte, bude výchozí hodnota znovu uvedena v frontě.
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. Například použijte PT10M po dobu 10 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch žádost odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek).
targetDedicatedNodes

integer

Požadovaný počet vyhrazených výpočetních uzlů ve fondu.
Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven.
targetLowPriorityNodes

integer

Požadovaný počet výpočetních uzlů s nízkou prioritou ve fondu
Nejméně jeden z targetDedicatedNodes, targetLowPriorityNodes musí být nastaven.

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í Ověřených službou Azure Batch, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu.

Name Typ Description
communityGalleryImageId

string

Jedinečný identifikátor obrázku galerie komunity
Tato vlastnost se vzájemně vylučují s jinými vlastnostmi a lze ji načíst z volání GET galerie komunity.
id

string

Identifikátor prostředku ARM image galerie výpočetních prostředků Azure. Výpočetní uzly ve fondu se vytvoří pomocí tohoto ID image. Toto je formulář /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{versionId}.
Tato vlastnost se vzájemně vylučují s jinými vlastnostmi. Image galerie výpočetních prostředků Azure musí mít repliky ve stejné oblasti jako účet Azure Batch. Informace o nastavení brány firewall pro agenta uzlu Batch ke 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.
sharedGalleryImageId

string

Jedinečný identifikátor obrázku sdílené galerie
Tato vlastnost se vzájemně vylučují s jinými vlastnostmi a lze ji načíst z volání GET sdíleného obrázku galerie.
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
Pokud chcete vybrat nejnovější verzi image, můžete zadat hodnotu "latest". Pokud tento parametr vynecháte, výchozí hodnota je nejnovější.

InboundEndpointProtocol

Protokol koncového bodu.

Name Typ Description
TCP

string

Pro koncový bod použijte protokol TCP.
UDP

string

Pro koncový bod použijte UDP.

InboundNatPool

Příchozí fond NAT, který lze použít k řešení konkrétních portů na výpočetních uzlech ve fondu Batch externě.

Name Typ Description
backendPort

integer

Číslo portu na výpočetním uzlu.
Musí to být jedinečné v rámci fondu batch. Přijatelné hodnoty jsou mezi 1 a 65535 s výjimkou 29876 a 29877, protože jsou rezervované. Pokud jsou zadaná nějaká rezervovaná hodnota, požadavek selže se stavovým kódem HTTP 400.
frontendPortRangeEnd

integer

Poslední číslo portu v rozsahu externích portů, které se použijí k poskytování příchozího přístupu k back-endPortu na jednotlivých výpočetních uzlech.
Přijatelné hodnoty jsou v rozsahu 1 až 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny službou Batch. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici nějaké 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žijí k poskytování příchozího přístupu k back-endPortu na jednotlivých výpočetních uzlech.
Přijatelné hodnoty jsou v rozsahu od 1 do 65534 s výjimkou portů od 5 0000 do 55000, které jsou vyhrazeny. Všechny rozsahy v rámci fondu musí být odlišné a nesmí se překrývat. Pokud jsou k dispozici 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 Batch, může obsahovat písmena, číslice, podtržítka, tečky a pomlčky. Názvy musí začínat písmenem nebo číslicí, musí končit písmenem, číslem 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 zadána žádná pravidla skupiny zabezpečení sítě, vytvoří se výchozí pravidlo, které povolí příchozí přístup k zadanému back-endportu. Pokud je překročen maximální počet pravidel skupiny zabezpečení sítě, požadavek selže se stavovým kódem HTTP 400.
protocol

InboundEndpointProtocol

Protokol koncového bodu.

InterNodeCommunicationState

Určuje, jestli fond povoluje 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í pro veřejné IP adresy 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žije se ke zřízení výpočetních uzlů.

LinuxUserConfiguration

Vlastnosti použité k vytvoření uživatelského účtu v uzlu Linuxu

Name Typ Description
gid

integer

ID skupiny pro uživatelský účet.
Vlastnosti uid a gid musí být zadány společně nebo ne vůbec. Pokud není zadaný základní operační systém, vybere 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 asymetrického ověřování založeného na klíči pro SSH mezi uzly ve fondu Linuxu, pokud je vlastnost enableInterNodeCommunication fondu true (je ignorována, pokud enableInterNodeCommunication je false). To provede umístěním páru klíčů do adresáře .ssh uživatele. Pokud není zadáno, není mezi uzly nakonfigurovaný protokol SSH bez hesla (není provedena žá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 ne vůbec. Pokud není zadaný 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 interaktivnímu režimu přihlášení. Pokud se jedná o aplikaci použitou ve vaší úloze, doporučuje se tato možnost.

ManagedDisk

Name Typ Description
securityProfile

VMDiskSecurityProfile

Určuje profil zabezpečení spravovaného disku.
Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Je možné ji nastavit pouze pro důvěrné virtuální počítače a je vyžadována při použití důvěrných virtuálních počítačů.
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 azure Storage, který se má připojit pomocí FUSE objektů blob na každém uzlu.
Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi.
azureFileShareConfiguration

AzureFileShareConfiguration

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

CIFSMountConfiguration

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

NFSMountConfiguration

Systém souborů NFS, který se má připojit ke každému uzlu.
Tato vlastnost se vzájemně vylučují 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

Určuje, jestli má tento fond povolit akcelerované síťové služby.
Akcelerované síťové služby umožňují virtualizaci V/V s jedním kořenovým serverem (SR-IOV) na virtuální počítač, což může vést ke zvýšení výkonu sítě. Další podrobnosti najdete v tématu: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration

PoolEndpointConfiguration

Konfigurace koncových bodů na výpočetních uzlech ve fondu Batch
publicIPAddressConfiguration

PublicIPAddressConfiguration

Konfigurace Public IPAddress pro výpočetní uzly ve fondu Batch.
Konfigurace veřejné IP adresy síťové konfigurace fondu.
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 formulář /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 pro přizpůsobení počtu 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 roli Přispěvatel klasických virtuálních počítačů Role-Based řízení přístupu (RBAC) pro zadanou virtuální síť. Zadaná podsíť musí umožňovat komunikaci ze služby Azure Batch, aby mohla plánovat úkoly na výpočetních uzlech. To je možné ověřit kontrolou, jestli má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG). Pokud skupina zabezpečení sítě odepře komunikaci s výpočetními uzly v zadané podsíti, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Pokud má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG), musí být pro příchozí komunikaci povolených několik vyhrazených systémových portů, včetně portů 29876 a 29877. Povolte také odchozí připojení ke službě Azure Storage na portu 443. Další podrobnosti najdete v tématu: 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 u příchozího koncového bodu.

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. Můžete například zadat pravidla 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 nějaké rezervované nebo duplicitní hodnoty, požadavek selže se stavovým kódem HTTP 400.
sourceAddressPrefix

string

Předpona zdrojové adresy nebo značka odpovídající pravidlu.
Platné hodnoty jsou jedna IP adresa (tj. 10.10.10.10.10), podsíť PROTOKOLU IP (tj. 192.168.1.0/24), výchozí značka nebo * (pro všechny adresy). Pokud jsou zadány jakékoli jiné 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 – 65535) nebo pole portů nebo rozsahů portů (tj. 100–200). Porty by měly být v rozsahu 0 až 65535 a rozsahy portů nebo porty se nesmí překrývat. Pokud jsou zadány jakékoli jiné 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é pro připojení k systému souborů NFS.

Name Typ Description
mountOptions

string

Další možnostipříkazového
Jedná se o možnosti net use ve Windows a připojení v Linuxu.
relativeMountPath

string

Relativní cesta na výpočetním uzlu, kde se připojí systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři služby Batch, 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ý komunikační režim vyžadují příchozí komunikaci TCP na portech 29876 a 29877 z modulu BatchNodeManagement. Značka služby {region} a odchozí komunikace TCP na portu 443 s "Storage.region" a BatchNodeManagement. Značky služeb {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 s BatchNodeManagement. Značka služby {region}. Nejsou vyžadovány žádné otevřené příchozí porty.

NodePlacementConfiguration

Konfigurace umístění uzlu pro fondy dávek

Name Typ Description
policy

NodePlacementPolicyType

Typ zásad umístění uzlu ve fondech batch
Zásady přidělování, které služba Batch používá ke zřízení uzlů. Pokud není zadáno, služba Batch použije regionální politiku.

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ženy mezi různé zóny s vyrovnává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. Jen pro čtení 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

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 batch.
Typ identity, který se používá pro fond 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 se požaduje licence, která se nepodporuje, 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í ovlivňují všechny nové výpočetní uzly připojující se k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nezomagí. V jakémkoli 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. automatické škálováníSettings se používají.
properties.certificates

CertificateReference[]

Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu.
Pro výpočetní uzly Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úkolu a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR se do úlohy zadají, aby se dotazoval na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{user-name}/certs) a certifikáty v daném adresáři.

Upozornění: Tato vlastnost je zastaralá a bude odebrána po únoru 2024. 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 výpočetníchuzlůchch
properties.currentNodeCommunicationMode

NodeCommunicationMode

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

DeploymentConfiguration

Tato vlastnost popisuje virtuální počítače, na které se budou nasazovat uzly fondu.
properties.displayName

string

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

InterNodeCommunicationState

Určuje, jestli fond povoluje přímou komunikaci mezi uzly.
To platí pro omezení, ke kterým uzlům je možné přiřadit fond. Povolení této hodnoty může snížit pravděpodobnost přidělení požadovaného počtu uzlů ve fondu. Pokud není zadána, tato hodnota je ve výchozím nastavení zakázaná.
properties.lastModified

string

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

MetadataItem[]

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

MountConfiguration[]

Seznam systémů souborů, které se mají připojit ke každému uzlu ve fondu.
To podporuje Soubory Azure, 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 poslední dokončené operaci změny velikosti.
Popisuje buď aktuální operaci (pokud fond AllocationState provádí změnu 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é se mají přidružit 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 při vytvoření účtu Batch 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án požadovaný cílovýDedicatedNodes, nebo "autoScale", který definuje vzorec, který se pravidelně znovu vyhodnocuje. Pokud tato vlastnost není zadána, bude mít fond pevné škálování s 0 targetDedicatedNodes.
properties.startTask

StartTask

Úloha zadaná ke spuštění na každém výpočetním uzlu, když se připojí k fondu.
V operaci PATCH (update) lze tuto vlastnost nastavit na prázdný objekt, který odebere spouštěcí úlohu z fondu.
properties.targetNodeCommunicationMode

NodeCommunicationMode

Režim komunikace požadovaného uzlu pro fond.
Pokud tuto hodnotu vynecháte, výchozí hodnota je Výchozí.
properties.taskSchedulingPolicy

TaskSchedulingPolicy

Jak se úkoly distribuují mezi výpočetní uzly ve fondu.
Pokud není zadáno, výchozí hodnota se rozloží.
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ší 4krát počet 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čů najdete v tématu Velikosti virtuálních počítačů (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti virtuálních počítačů (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 těch, které mají službu Premium Storage (STANDARD_GS, STANDARD_DS a STANDARD_DSV2 series).
tags

object

Značky prostředku.
type

string

Typ prostředku.

PoolEndpointConfiguration

Konfigurace koncového bodu pro fond.

Name Typ Description
inboundNatPools

InboundNatPool[]

Seznam příchozích fondů překladu adres (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 batch je 5. Pokud je překročen maximální počet příchozích fondů překladu adres (NAT), požadavek selže se stavovým kódem HTTP 400. Tuto hodnotu nelze zadat, pokud je IPAddressProvisioningType NoPublicIPAddresses.

PoolIdentityType

Typ identity, který se používá pro fond batch.

Name Typ Description
None

string

Fond Batch nemá přidruženou žádnou identitu. Nastavení None ve fondu aktualizací odebere existující identity.
UserAssigned

string

Fond Batch má přiřazené identity 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 ke spouštění úloh 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ů.
Počet ZDE zadaných IP adres omezuje maximální velikost fondu – 100 vyhrazených uzlů nebo 100 uzlů s spotovou/nízkou prioritou je možné přidělit pro každou veřejnou IP adresu. Například fond, který potřebuje 250 vyhrazených virtuálních počítačů, by potřeboval alespoň 3 veřejné IP adresy zadané. 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

Při změně velikosti fondu došlo k chybě.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity 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 provádění poslední změny velikosti fondu
Tato vlastnost je nastavena pouze v případě, že došlo k chybě během poslední změny velikosti fondu, a pouze pokud je stav přidělení fondu stabilní.
nodeDeallocationOption

ComputeNodeDeallocationOption

Určuje, co dělat s uzlem a jeho spuštěnými úlohami, pokud se velikost fondu snižuje.
Výchozí hodnota je znovu vyměněná.
resizeTimeout

string

Časový limit 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 přímo rozhraní REST API, 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 výpočetních uzlů s nízkou prioritou ve fondu

ResourceFile

Jeden soubor nebo více souborů, které se mají stáhnout 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 je nutné zadat jeden z nich.
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ým názvem souboru nebo podadresářem. Pokud předpona není zadaná, stáhnou se všechny soubory v kontejneru.
fileMode

string

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

string

Umístění na výpočetním uzlu, ke kterému chcete soubor stáhnout, vzhledem k pracovnímu adresáři úkolu.
Pokud je zadána vlastnost httpUrl, je souborPath vyžadován a popisuje cestu, do které se soubor stáhne, včetně názvu souboru. Jinak je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je nepovinný a je adresář ke stažení souborů. V případě, že se filePath používá jako adresář, všechny adresářové struktury, které jsou již přidruženy ke vstupním datům, se zachovají v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže přerušit pracovní adresář úkolu (například pomocí ..).
httpUrl

string

Adresa URL souboru, který chcete stáhnout.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. 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 objektu blob v úložišti Azure: zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použít spravovanou identitu s oprávněním ke čtení nebo nastavit seznam ACL objektu blob nebo jeho kontejneru tak, aby umožňoval veřejný přístup.
identityReference

ComputeNodeIdentityReference

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

string

Adresa URL kontejneru objektů blob v rámci služby Azure Blob Storage.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Tato adresa URL musí být čitelná a vypisovatelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL kontejneru v úložišti Azure: zahrnutí sdíleného přístupového podpisu (SAS) udělujícího oprávnění ke čtení a seznamu v kontejneru, použití spravované identity s oprávněními ke čtení a seznamu nebo nastavení seznamu ACL pro kontejner tak, aby umožňoval veřejný přístup.

RollingUpgradePolicy

Parametry konfigurace použité při postupném upgradu.

Name Typ Description
enableCrossZoneUpgrade

boolean

Povolte VMSS ignorovat hranice AZ při vytváření dávek upgradu. Zvažte aktualizaci domény a maxBatchInstancePercent k určení velikosti dávky. Pokud toto pole není nastavené, Azure Batch nenastaví výchozí hodnotu. Hodnota enableCrossZoneUpgrade na vytvořené VirtualMachineScaleSet bude rozhodnuto ve výchozích konfiguracích v VirtualMachineScaleSet. Toto pole je možné nastavit na hodnotu true nebo false pouze při použití NodePlacementConfiguration jako zónového pole.
maxBatchInstancePercent

integer

Maximální procento celkových instancí virtuálních počítačů, které budou upgradovány současně postupným upgradem 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 se zajistila vyšší spolehlivost. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent.
maxUnhealthyInstancePercent

integer

Maximální procento celkových instancí virtuálních počítačů ve škálovací sadě, které může být současně v pořádku, buď v důsledku upgradu, nebo zjištěním stavu, který není v pořádku, kontroluje stav virtuálního počítače před přerušením postupného upgradu. Toto omezení se zkontroluje 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 s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent.
maxUnhealthyUpgradedInstancePercent

integer

Maximální procento upgradovanýchinstancích Tato kontrola proběhne po upgradu každé dávky. Pokud se toto procento někdy překročí, průběžná aktualizace se přeruší. Hodnota tohoto pole by měla být v rozmezí od 0 do 100 (včetně).
pauseTimeBetweenBatches

string

Doba čekání mezi dokončením aktualizace pro všechny virtuální počítače 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 všemi 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 pevné škálování se vzájemně vylučují a je nutné zadat jednu z vlastností.
fixedScale

FixedScaleSettings

Opravili jsme nastavení škálování fondu.
Tato vlastnost a automatické škálování se vzájemně vylučují a je nutné zadat jednu z vlastností.

SecurityEncryptionTypes

Určuje Typ šifrování spravovaného disku. Je nastavená na VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: Při použití důvěrných virtuálních počítačů je možné ho nastavit pouze pro důvěrné virtuální počítače a vyžadovat.

Name Typ Description
NonPersistedTPM

string

VMGuestStateOnly

string

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 povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli.
securityType

SecurityTypes

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

UefiSettings

Určuje nastavení zabezpečení, jako je zabezpečené spouštění a 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 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é povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu.

Name Typ Description
confidentialVM

string

Důvěrné výpočetní prostředí Azure nabízí důvěrné virtuální počítače pro tenanty s vysokými požadavky na zabezpečení a důvěrnost. Tyto virtuální počítače poskytují silnou hranici vynucenou hardwarem, která pomáhá splnit vaše potřeby zabezpečení. Důvěrné virtuální počítače můžete použít pro migrace, aniž byste museli provádět změny kódu, přičemž platforma chrání stav virtuálního počítače před čtením nebo úpravou.
trustedLaunch

string

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

ServiceArtifactReference

Určuje ID odkazu na artefakt služby použité 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
Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StartTask

Úloha, která se spustí při připojení výpočetního uzlu k fondu ve službě Azure Batch nebo při restartování nebo obnovení výpočetního uzlu.

Name Typ Default value Description
commandLine

string

Příkazový řádek spouštěcího úkolu.
Příkazový řádek se nespustí pod prostředím, 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í na příkazovém řádku, například pomocí příkazu cmd /c MyCommand ve Windows nebo /bin/sh -c MyCommand v Linuxu. Vyžaduje se, pokud jsou zadány jakékoli další vlastnosti startTask.
containerSettings

TaskContainerSettings

Nastavení kontejneru, pod kterým se spouští spouštěcí úloha.
Po zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen adresářů Azure Batch 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 je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohu. 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í spouštěcí úloha.
Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úkol jedinečný.
waitForSuccess

boolean

Jestli má služba Batch čekat na úspěšné dokončení spouštěcí úlohy (tj. ukončit s ukončovacím kódem 0) před naplánováním všech úkolů na výpočetním uzlu.
Pokud hodnota true a spouštěcí úkol 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 po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje do něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o plánování chyb. Pokud je false, služba Batch nebude čekat na dokončení spouštěcí úlohy. V tomto případě můžou na výpočetním uzlu začít spouštět jiné úkoly, zatímco spouštěcí úkol je stále spuštěný; i v případě, že spouštěcí úkol selže, budou na uzlu i nadále naplánované nové úkoly. Výchozí hodnota je true.

StorageAccountType

Typ účtu úložiště pro použití při vytváření datových disků nebo disku 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 místně redundantní úložiště SSD úrovně Standard.
Standard_LRS

string

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

TaskContainerSettings

Nastavení kontejneru pro úlohu.

Name Typ Description
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

Cesty, které chcete připojit k úloze kontejneru.
Pokud je toto pole null nebo není k dispozici, úloha kontejneru připojí celou dočasnou diskovou jednotku ve Windows (nebo AZ_BATCH_NODE_ROOT_DIR v Linuxu). Pokud je toto pole nastavené jako prázdné, nepřipoje do kontejneru žádné cesty k datům.
containerRunOptions

string

Další možnosti příkazu create kontejneru
Tyto další možnosti se předávají jako argumenty příkazu "docker create" kromě těch, které řídí služba Batch.
imageName

string

Image, která se má použít k vytvoření kontejneru, ve kterém se úloha spustí.
Toto je úplný odkaz na image, jak by bylo určeno pro docker pull. Pokud v názvu image není k dispozici žá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 již bylo k dispozici při vytváření fondu.
workingDirectory

ContainerWorkingDirectory

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

TaskSchedulingPolicy

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

Name Typ Default value Description
nodeFillType

ComputeNodeFillType

Spread

Jak se mají úkoly distribuovat napříč výpočetními uzly.

UefiSettings

Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM 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 má být na virtuálním počítači povolený virtuální počítač 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í virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade.

Automatické – 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

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

string

Existující instance ve škálovací sadě se přenesou do dávek, které se mají upgradovat. Po dokončení upgradované dávky začnou instance znovu zabírají provoz a začne další dávka. To pokračuje, dokud se všechny instance nepřenesou up-to-date.

UpgradePolicy

Popisuje zásady upgradu – automatické, ruční nebo postupné.

Name Typ Description
automaticOSUpgradePolicy

AutomaticOSUpgradePolicy

Parametry konfigurace používané k provádění automatického upgradu operačního systému
Parametry konfigurace používané k automatickému 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í – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade.

Automatické – 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.
rollingUpgradePolicy

RollingUpgradePolicy

Parametry konfigurace použité při postupném upgradu.
Parametry konfigurace použité při postupném upgradu.

UserAccount

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

Name Typ Description
elevationLevel

ElevationLevel

Úroveň zvýšení úrovně 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 neníadmin.
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 pro uživatelský účet.
windowsUserConfiguration

WindowsUserConfiguration

Konfigurace uživatele specifická pro Systém Windows pro uživatelský účet.
Tuto vlastnost lze zadat pouze v případě, že je uživatel ve fondu Windows. Pokud není zadaný a ve fondu Windows, vytvoří se uživatel 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 se úloha spouští.

Name Typ Description
autoUser

AutoUserSpecification

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

string

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

VirtualMachineConfiguration

Konfigurace výpočetních uzlů ve fondu založená na infrastruktuře virtuálních počítačů Azure.

Name Typ Description
containerConfiguration

ContainerConfiguration

Konfigurace kontejneru pro fond.
Pokud je zadáno, 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í určovat vlastnost containerSettings a všechny ostatní úkoly ho 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 musí 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.
V případě zadání se rozšíření uvedená v této konfiguraci 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.
Týká se to jenom imagí, které obsahují operační systém Windows, a měly by se používat jenom v případě, že pro uzly, které budou nasazeny, uchovávat platné místní licence. Pokud tento parametr vynecháte, nepoužije 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říkazového a řídicího rozhraní mezi uzlem a službou Batch. Existují různé implementace agenta uzlu, označovaného jako SKU, pro různé operační systémy. Musíte 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 agenta uzlu spolu s jejich seznamem ověřených odkazů na image, přečtěte si operaci Výpis podporovaných skladových položek agenta uzlu.
nodePlacementConfiguration

NodePlacementConfiguration

Konfigurace umístění uzlu pro fond.
Tato konfigurace určuje pravidla, jak budou uzly ve fondu fyzicky přiděleny.
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 ID odkazu na artefakt služby použité 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.
Id odkazu artefaktů služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{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.

VMDiskSecurityProfile

Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Je možné ji nastavit pouze pro důvěrné virtuální počítače a je vyžadována při použití důvěrných virtuálních počítačů.

Name Typ Description
securityEncryptionType

SecurityEncryptionTypes

Určuje Typ šifrování spravovaného disku. Je nastavená na VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: Při použití důvěrných virtuálních počítačů je možné ho nastavit pouze pro důvěrné virtuální počítače a vyžadovat.

VMExtension

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

Name Typ Description
autoUpgradeMinorVersion

boolean

Určuje, jestli má rozšíření 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á být rozšíření automaticky upgradováno platformou, 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ých je potřeba toto rozšíření zřídit.
publisher

string

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

object

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

string

Typ rozšíření.
typeHandlerVersion

string

Verze obslužné rutiny skriptu.

WindowsConfiguration

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

Name Typ Description
enableAutomaticUpdates

boolean

Určuje, jestli jsou na virtuálním počítači povolené automatické aktualizace.
Pokud tuto hodnotu vynecháte, 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 je Interactive.