Pool - Add

Service:

Batch Service

API Version:

2023-11-01.18.0

Přidá fond k zadanému účtu.
Při pojmenování fondů nepoužívejte citlivé informace, jako jsou uživatelská jména nebo názvy tajných projektů. Tyto informace se můžou objevit v protokolech telemetrie, které jsou přístupné pro techniky podpora Microsoftu.

POST {batchUrl}/pools?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools?timeout={timeout}&api-version=2023-11-01.18.0

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
batchUrl	path	True	string	Základní adresa URL pro všechny požadavky Azure Batch služby.
api-version	query	True	string	Verze rozhraní API klienta.
timeout	query		integer int32	Maximální doba, kterou může server strávit zpracováním požadavku( v sekundách). Výchozí hodnota je 30 sekund.

Hlavička požadavku

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

Name	Vyžadováno	Typ	Description
client-request-id		string uuid	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Určuje, jestli má server v odpovědi vrátit client-request-id.
ocp-date		string date-time-rfc1123	Čas, kdy byla žádost vydána. Klientské knihovny obvykle nastavit na aktuální systémový čas hodin; pokud voláte rozhraní REST API přímo, explicitně ho nastavte.

Text požadavku

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

Name	Vyžadováno	Typ	Description
id	True	string	Řetězec, který jednoznačně identifikuje fond v rámci účtu. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně spojovníků a podtržítků a nesmí obsahovat více než 64 znaků. ID zachovává malá a malá písmena a nerozlišuje se (to znamená, že v rámci účtu nemusíte mít dvě ID fondu, která se liší pouze velikostí písmen).
vmSize	True	string	Velikost virtuálních počítačů ve fondu. Všechny virtuální počítače ve fondu mají stejnou velikost. Informace o dostupných velikostech virtuálních počítačů pro fondy Cloud Services (fondy vytvořené pomocí cloudServiceConfiguration) najdete v tématu Velikosti pro Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch podporuje všechny velikosti virtuálních počítačů Cloud Services s výjimkou ExtraSmall, A1V2 a A2V2. Informace o dostupných velikostech virtuálních počítačů pro fondy využívající image z Virtual Machines Marketplace (fondy vytvořené pomocí virtualMachineConfiguration) najdete v tématu Velikosti pro Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti pro Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch podporuje všechny velikosti virtuálních počítačů Azure s výjimkou STANDARD_A0 a virtuálních počítačů se službou Premium Storage (řady STANDARD_GS, STANDARD_DS a STANDARD_DSV2).
applicationLicenses		string[]	Seznam licencí aplikací, které služba Batch zpřístupní na každém výpočetním uzlu ve fondu. Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud je požadována licence, která není podporována, vytvoření fondu se nezdaří.
applicationPackageReferences		ApplicationPackageReference[]	Seznam balíčků, které se mají nainstalovat na každý výpočetní uzel ve fondu. Při vytváření fondu musí být ID aplikace balíčku plně kvalifikované (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Změny odkazů na balíčky ovlivní všechny nové uzly, které se připojují k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nereimagí. V každém daném fondu je maximálně 10 odkazů na balíčky.
autoScaleEvaluationInterval		string	Časový interval, ve kterém se má velikost fondu automaticky upravit podle vzorce automatického škálování. Výchozí hodnota je 15 minut. Minimální a maximální hodnota je 5 minut a 168 hodin. Pokud zadáte hodnotu kratší než 5 minut nebo větší než 168 hodin, vrátí služba Batch chybu; Pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (Chybný požadavek).
autoScaleFormula		string	Vzorec pro požadovaný počet výpočetních uzlů ve fondu. Tato vlastnost nesmí být zadána, pokud je vlastnost enableAutoScale nastavená na hodnotu false. Vyžaduje se, pokud je vlastnost enableAutoScale nastavená na hodnotu true. Platnost vzorce se kontroluje před vytvořením fondu. Pokud vzorec není platný, služba Batch požadavek odmítne s podrobnými informacemi o chybě. Další informace o zadání tohoto vzorce najdete v tématu Automatické škálování výpočetních uzlů ve fondu Azure Batch (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
certificateReferences		CertificateReference[]	Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu. V případě uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. V případě linuxových výpočetních uzlů jsou certifikáty uložené v adresáři v pracovním adresáři úlohy a proměnná prostředí AZ_BATCH_CERTIFICATES_DIR je předána úkolu, který se má dotazovat na toto umístění. V případě certifikátů s viditelností remoteUser se adresář certs vytvoří v domovském adresáři uživatele (např. /home/{uživatelské_jméno}/certs) a certifikáty se umístí do tohoto adresáře. Upozornění: Tato vlastnost je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .
cloudServiceConfiguration		CloudServiceConfiguration	Konfigurace cloudové služby pro fond Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a jedna z vlastností musí být zadána. Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na hodnotu UserSubscription.
displayName		string	Zobrazovaný název fondu. Zobrazovaný název nemusí být jedinečný a může obsahovat jakékoli znaky Unicode až do maximální délky 1024.
enableAutoScale		boolean	Určuje, jestli se má velikost fondu v průběhu času automaticky upravovat. Pokud false, musí být zadána alespoň jedna z targetDedicatedNodes a targetLowPriorityNodes. Pokud je hodnota true, vlastnost autoScaleFormula je povinná a velikost fondu se automaticky změní podle vzorce. Výchozí hodnota je False.
enableInterNodeCommunication		boolean	Určuje, jestli fond umožňuje přímou komunikaci mezi výpočetními uzly. Povolení komunikace mezi uzly omezuje maximální velikost fondu z důvodu omezení nasazení na výpočetní uzly fondu. To může mít za následek, že fond nedosáhne požadované velikosti. Výchozí hodnota je False.
metadata		MetadataItem[]	Seznam dvojic název-hodnota přidružených k fondu jako metadata. Služba Batch nepřiřazuje metadatům žádný význam; slouží výhradně k použití uživatelského kódu.
mountConfiguration		MountConfiguration[]	Připojte úložiště pomocí zadaného systému souborů po celou dobu životnosti fondu. Připojte úložiště pomocí sdílené složky Azure, systému souborů NFS, CIFS nebo systému souborů založeného na blobfuse.
networkConfiguration		NetworkConfiguration	Konfigurace sítě pro fond. Konfigurace sítě pro fond.
resizeTimeout		string	Časový limit pro přidělení výpočetních uzlů do fondu. Tento časový limit platí pouze pro ruční škálování. pokud je vlastnost enableAutoScale nastavená na hodnotu true, nemá žádný vliv. Výchozí hodnota je 15 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch vrátí chybu; Pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (Chybný požadavek).
resourceTags		object	Uživatelem zadané značky přidružené k fondu. Uživatelem definované značky, které mají být přidruženy k fondu Azure Batch. Po zadání se tyto značky rozšíří do záložních prostředků Azure přidružených k fondu. Tuto vlastnost je možné zadat pouze v případě, že byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na hodnotu UserSubscription.
startTask		StartTask	Úkol určený ke spuštění na každém výpočetním uzlu při připojení k fondu. Úloha se spustí při přidání výpočetního uzlu do fondu nebo při restartování výpočetního uzlu.
targetDedicatedNodes		integer	Požadovaný počet vyhrazených výpočetních uzlů ve fondu Tato vlastnost nesmí být zadána, pokud je vlastnost enableAutoScale nastavená na hodnotu true. Pokud je vlastnost enableAutoScale nastavená na hodnotu false, musíte nastavit buď targetDedicatedNodes, targetLowPriorityNodes, nebo obojí.
targetLowPriorityNodes		integer	Požadovaný počet spotových výpočetních uzlů nebo výpočetních uzlů s nízkou prioritou ve fondu Tato vlastnost nesmí být zadána, pokud je vlastnost enableAutoScale nastavená na hodnotu true. Pokud je vlastnost enableAutoScale nastavená na hodnotu false, musíte nastavit buď targetDedicatedNodes, targetLowPriorityNodes, nebo obojí.
targetNodeCommunicationMode		NodeCommunicationMode	Požadovaný režim komunikace uzlu pro fond. Pokud ho vynecháte, výchozí hodnota je Výchozí.
taskSchedulingPolicy		TaskSchedulingPolicy	Způsob distribuce úkolů mezi výpočetní uzly ve fondu Pokud není zadaný, je výchozí hodnota rozložena.
taskSlotsPerNode		integer	Počet slotů úloh, které lze použít ke spouštění souběžných úloh na jednom výpočetním uzlu ve fondu. Výchozí hodnota je 1. Maximální hodnota je menší ze 4násobku počtu jader vmSize fondu nebo 256.
userAccounts		UserAccount[]	Seznam uživatelských účtů, které se mají vytvořit na každém výpočetním uzlu ve fondu.
virtualMachineConfiguration		VirtualMachineConfiguration	Konfigurace virtuálního počítače pro fond. Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a musí být zadána jedna z vlastností.

Odpovědi

Name	Typ	Description
201 Created		Požadavek na službu Batch byl úspěšný. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Chyba ze služby Batch.

Zabezpečení

azure_auth

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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Authorization

Type: apiKey
In: header

Příklady

Add a CloudServiceConfiguration pool

Add a pool with accelerated networking

Add a pool with mount drive specified

Add a pool with SecurityProfile

Add a simple pool with resourceTags

Add a VirtualMachineConfiguration pool

Add a VirtualMachineConfiguration pool with containers

Add a VirtualMachineConfiguration pool with extensions

Add a VirtualMachineConfiguration pool with OS disk

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Add a CloudServiceConfiguration pool

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "poolId",
  "vmSize": "small",
  "cloudServiceConfiguration": {
    "osFamily": "4"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Status code:

201

Add a pool with accelerated networking

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool01",
  "vmSize": "Standard_D1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2,
  "networkConfiguration": {
    "enableAcceleratedNetworking": true
  }
}

Sample Response

Status code:

201

Add a pool with mount drive specified

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0


{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "mountConfiguration": [
    {
      "azureBlobFileSystemConfiguration": {
        "accountName": "accountName",
        "containerName": "blobContainerName",
        "accountKey": "accountKey",
        "relativeMountPath": "bfusepath"
      }
    },
    {
      "azureFileShareConfiguration": {
        "accountName": "accountName",
        "azureFileUrl": "https://myaccount.file.core.windows.net/fileshare",
        "accountKey": "accountKey",
        "relativeMountPath": "filesharepath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "nfsMountConfiguration": {
        "source": "somesource nfs url",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "cifsMountConfiguration": {
        "username": "accountName",
        "password": "password",
        "source": "//myaccount.file.core.windows.net/file",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    }
  ],
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Status code:

201

Add a pool with SecurityProfile

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04",
    "securityProfile": {
      "securityType": "trustedLaunch",
      "encryptionAtHost": true,
      "uefiSettings": {
        "secureBootEnabled": false
      }
    }
  },
  "targetDedicatedNodes": 1
}

Sample Response

Status code:

201

Add a simple pool with resourceTags

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04"
  },
  "targetDedicatedNodes": 1,
  "resourceTags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  }
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with containers

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "120_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "containerConfiguration": {
      "type": "dockerCompatible",
      "containerImageNames": [
        "busybox"
      ]
    }
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with extensions

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "extensions": [
      {
        "name": "batchextension1",
        "type": "KeyVaultForLinux",
        "publisher": "Microsoft.Azure.KeyVault",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": "{\"secretsManagementSettingsKey\":\"secretsManagementSettingsValue\",\"authenticationSettingsKey\":\"authenticationSettingsValue\"}"
      }
    ]
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ],
  "targetNodeCommunicationMode": "simplified"
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with OS disk

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "standard_d2s_v3",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "osDisk": {
      "diskSizeGB": 100,
      "managedDisk": {
        "storageAccountType": "standardssd_lrs"
      },
      "caching": "readwrite",
      "ephemeralOSDiskSettings": {
        "placement": "CacheDisk"
      }
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 1,
  "enableAutoScale": false
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Sample Request

HTTP

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool002",
  "vmSize": "Standard_A1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "windowsConfiguration": {
      "enableAutomaticUpdates": false
    },
    "serviceArtifactReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2
}

Sample Response

Status code:

201

Definice

Name	Description
ApplicationPackageReference	Odkaz na balíček, který se má nasadit do výpočetních uzlů.
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é pro připojení ke kontejneru služby Azure Storage pomocí blobfuse
AzureFileShareConfiguration	Informace používané pro připojení ke sdílené složce Azure
BatchError	Služba Azure Batch obdržela chybovou odpověď.
BatchErrorDetail	Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi.
CachingType	Typ ukládání do mezipaměti, který se má pro disk povolit.
CertificateReference	Odkaz na certifikát, který se má nainstalovat na výpočetní uzly ve fondu.
CertificateStoreLocation	Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.
CertificateVisibility	Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu.
CIFSMountConfiguration	Informace používané pro připojení k systému souborů CIFS
CloudServiceConfiguration	Konfigurace výpočetních uzlů ve fondu na základě platformy Azure Cloud Services.
ComputeNodeFillType	Jak se úlohy distribuují mezi výpočetní uzly ve fondu.
ComputeNodeIdentityReference	Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude výpočetní uzel používat.
ContainerConfiguration	Konfigurace pro fondy s podporou kontejnerů.
ContainerRegistry	Privátní registr kontejneru.
ContainerType	Technologie kontejneru, která se má použít.
ContainerWorkingDirectory	Umístění pracovního adresáře úloh kontejneru.
DataDisk	Nastavení, která budou používat datové disky přidružené k výpočetním uzlům ve fondu. Pokud používáte připojené datové disky, musíte je připojit a naformátovat z virtuálního počítače, abyste je mohli používat.
DiffDiskPlacement	Určuje dočasné umístění disku pro disk s operačním systémem pro všechny výpočetní uzly (virtuální počítače) ve fondu.
DiffDiskSettings	Určuje dočasné nastavení disku pro disk operačního systému používaný výpočetním uzlem (virtuálním počítačem).
DiskEncryptionConfiguration	Konfigurace šifrování disku použitá na výpočetních uzlech ve fondu Konfigurace šifrování disků se nepodporuje ve fondu Linuxu vytvořeném s imagí Azure Compute Gallery.
DiskEncryptionTarget	Seznam cílových disků bude služba Batch šifrovat na výpočetním uzlu.
DynamicVNetAssignmentScope	Rozsah dynamického přiřazení virtuální sítě.
ElevationLevel	Úroveň zvýšení oprávnění uživatele.
EnvironmentSetting	Proměnná prostředí, která se má nastavit v procesu úlohy.
ErrorMessage	Chybová zpráva přijatá v Azure Batch chybovou odpověď.
ImageReference	Odkaz na image Azure Virtual Machines Marketplace nebo image Azure Compute Gallery. Pokud chcete získat seznam všech odkazů na Azure Marketplace image ověřených Azure Batch, podívejte se na operaci Výpis podporovaných imagí.
InboundEndpointProtocol	Protokol koncového bodu.
InboundNATPool	Fond příchozího překladu adres (NAT), který je možné použít k externímu adresní adrese konkrétních portů na výpočetních uzlech ve fondu služby Batch.
IPAddressProvisioningType	Typ zřizování veřejných IP adres pro fond.
LinuxUserConfiguration	Vlastnosti použité k vytvoření uživatelského účtu na výpočetním uzlu s Linuxem
LoginMode	Režim přihlášení pro uživatele
ManagedDisk
MetadataItem	Pár název-hodnota přidružený k prostředku služby Batch.
MountConfiguration	Systém souborů, který se má připojit k jednotlivým uzlům.
NetworkConfiguration	Konfigurace sítě pro fond
NetworkSecurityGroupRule	Pravidlo skupiny zabezpečení sítě, které se použije na příchozí koncový bod.
NetworkSecurityGroupRuleAccess	Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku.
NFSMountConfiguration	Informace používané pro připojení k systému souborů NFS
NodeCommunicationMode	Určuje, jak fond komunikuje se službou Batch.
NodePlacementConfiguration	Konfigurace umístění uzlů pro fond
NodePlacementPolicyType	Zásady umístění pro přidělování uzlů ve fondu.
OSDisk	Nastavení pro disk operačního systému výpočetního uzlu
PoolAddParameter	Fond ve službě Azure Batch, který chcete přidat.
PoolEndpointConfiguration	Konfigurace koncového bodu pro fond
PublicIPAddressConfiguration	Konfigurace veřejné IP adresy síťové konfigurace fondu.
ResourceFile	Jeden soubor nebo více souborů ke stažení do výpočetního uzlu
SecurityProfile	Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.
SecurityTypes	Určuje typ zabezpečení virtuálního počítače. Aby bylo možné UefiSettings povolit, musí být nastavená na libovolnou zadanou hodnotu.
ServiceArtifactReference	Určuje REFERENČNÍ ID artefaktu služby, které se používá k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image.
StartTask	Úloha, která se spustí při připojení uzlu k fondu ve službě Azure Batch nebo při restartování nebo opětovném nastavení 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 virtuálnítpm použité při vytváření virtuálního počítače.
UserAccount	Vlastnosti použité k vytvoření uživatele sloužícího ke spouštění úloh na výpočetním uzlu Azure Batch.
UserIdentity	Definice identity uživatele, pod kterou je úloha spuštěna.
VirtualMachineConfiguration	Konfigurace výpočetních uzlů ve fondu na základě infrastruktury Azure Virtual Machines
VMExtension	Konfigurace pro rozšíření virtuálních počítačů
WindowsConfiguration	Nastavení operačního systému Windows, která se mají použít pro virtuální počítač.
WindowsUserConfiguration	Vlastnosti použité k vytvoření uživatelského účtu na výpočetním uzlu Windows.

ApplicationPackageReference

Odkaz na balíček, který se má nasadit do výpočetních uzlů.

Name	Typ	Description
applicationId	string	ID aplikace, která se má nasadit. Při vytváření fondu musí být ID aplikace balíčku plně kvalifikované (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Verze aplikace, která se má nasadit. Pokud tento parametr vynecháte, nasadí se výchozí verze. Pokud je ve fondu vynechána a pro tuto aplikaci není zadána žádná výchozí verze, požadavek selže s kódem chyby InvalidApplicationPackageReferences a stavovým kódem HTTP 409. Pokud je tato možnost u úlohy vynechána a pro tuto aplikaci není zadána žádná výchozí verze, úloha selže s chybou předběžného zpracování.

AutoUserScope

Obor automatického uživatele

Name	Typ	Description
pool	string	Určuje, že se úloha spustí jako společný účet automatického uživatele, který se vytvoří na každém výpočetním uzlu ve fondu.
task	string	Určuje, že služba by měla pro úlohu vytvořit nového uživatele.

AutoUserSpecification

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

Name	Typ	Description
elevationLevel	ElevationLevel	Úroveň zvýšení oprávnění automatického uživatele. Výchozí hodnota je nonAdmin.
scope	AutoUserScope	Obor automatického uživatele Výchozí hodnota je fond. Pokud fond používá Systém Windows, měla by být zadána hodnota Úloha, pokud je vyžadována přísnější izolace mezi úkoly. Pokud například úloha zmutuje registr způsobem, který by mohl mít vliv na jiné úlohy, nebo pokud byly ve fondu zadány certifikáty, které by neměly být přístupné pro běžné úlohy, ale měly by být přístupné pro StartTasks.

AzureBlobFileSystemConfiguration

Informace používané pro 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čuje s sasKey a identity; přesně jeden musí být zadán.
accountName	string	Název účtu služby Azure Storage.
blobfuseOptions	string	Další možnosti příkazového řádku, které se mají předat příkazu mount. Jedná se o možnosti net use ve Windows a možnosti připojení v Linuxu.
containerName	string	Název kontejneru Azure Blob Storage.
identityReference	ComputeNodeIdentityReference	Odkaz na identitu přiřazenou uživatelem, která se použije pro přístup k názvu kontejneru containerName Tato vlastnost se vzájemně vylučuje s accountKey a sasKey; přesně jeden musí být zadán.
relativeMountPath	string	Relativní cesta na výpočetním uzlu, ke které se připojí systém souborů Všechny systémy souborů jsou připojené vzhledem k adresáři připojení služby Batch a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.
sasKey	string	Token SAS služby Azure Storage. Tato vlastnost se vzájemně vylučuje s accountKey a identity; přesně jeden musí být zadán.

AzureFileShareConfiguration

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

Name	Typ	Description
accountKey	string	Klíč účtu Azure Storage.
accountName	string	Název účtu služby Azure Storage.
azureFileUrl	string	Adresa URL Azure Files. Toto je ve formátu https://{account}.file.core.windows.net/.
mountOptions	string	Další možnosti příkazového řádku, které se mají předat příkazu mount. Jedná se o možnosti net use ve Windows a možnosti připojení v Linuxu.
relativeMountPath	string	Relativní cesta na výpočetním uzlu, ke které se připojí systém souborů Všechny systémy souborů jsou připojené vzhledem k adresáři připojení služby Batch a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.

BatchError

Služba Azure Batch obdržela chybovou odpověď.

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou neutrální a mají být využívány programově.
message	ErrorMessage	Zpráva popisující chybu, která má být vhodná k zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi.

Name	Typ	Description
key	string	Identifikátor určující význam value vlastnost.
value	string	Další informace zahrnuté v chybové odpovědi.

CachingType

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

Name	Typ	Description
none	string	Režim ukládání do mezipaměti pro disk není povolený.
readonly	string	Režim ukládání do mezipaměti pro disk je jen pro čtení.
readwrite	string	Režim ukládání do mezipaměti pro disk je čtení a zápis.

CertificateReference

Odkaz na certifikát, který se má nainstalovat na výpočetní uzly ve fondu.

Name	Typ	Description
storeLocation	CertificateStoreLocation	Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat. Výchozí hodnota je currentuser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované pomocí výpočetních uzlů Windows (to znamená vytvořených pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). V případě linuxových výpočetních uzlů jsou certifikáty uložené v adresáři v pracovním adresáři úlohy a proměnná prostředí AZ_BATCH_CERTIFICATES_DIR je předána úkolu, který se má dotazovat na toto umístění. V případě certifikátů s viditelností remoteUser se adresář certs vytvoří v domovském adresáři uživatele (např. /home/{uživatelské_jméno}/certs) a certifikáty se umístí do tohoto adresáře.
storeName	string	Název úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat. Tato vlastnost se vztahuje pouze na fondy nakonfigurované pomocí výpočetních uzlů Windows (to znamená vytvořených pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Mezi běžné názvy obchodů patří: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale je možné použít také jakýkoli vlastní název obchodu. Výchozí hodnota je My.
thumbprint	string	Kryptografický otisk certifikátu.
thumbprintAlgorithm	string	Algoritmus, se kterým je kryptografický otisk přidružený. To musí být sha1.
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. V této kolekci můžete zadat více než jednu viditelnost. Výchozí hodnota je všechny účty.

CertificateStoreLocation

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

Name	Typ	Description
currentuser	string	Certifikáty by se měly nainstalovat do úložiště certifikátů CurrentUser.
localmachine	string	Certifikáty by se měly nainstalovat do úložiště certifikátů LocalMachine.

CertificateVisibility

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

Name	Typ	Description
remoteuser	string	Certifikát by měl být viditelný pro uživatelské účty, pod kterými uživatelé vzdáleně přistupují k výpočetnímu uzlu.
starttask	string	Certifikát by měl být viditelný pro uživatelský účet, pod kterým se spouští StartTask. Všimněte si, že pokud je obor automatického uživatele fond pro startTask i úkol, bude tento certifikát viditelný i pro úkol.
task	string	Certifikát by měl být viditelný pro uživatelské účty, pod kterými se spouští úlohy.

CIFSMountConfiguration

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

Name	Typ	Description
mountOptions	string	Další možnosti příkazového řádku, které se mají předat příkazu mount. Jedná se o možnosti net use ve Windows a možnosti 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, ke které se připojí systém souborů Všechny systémy souborů jsou připojené vzhledem k adresáři připojení služby Batch a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.
source	string	Identifikátor URI systému souborů, který chcete připojit.
username	string	Uživatel, který se má použít k ověřování v systému souborů CIFS.

CloudServiceConfiguration

Konfigurace výpočetních uzlů ve fondu na základě platformy Azure Cloud Services.

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

ComputeNodeFillType

Jak se úlohy distribuují mezi výpočetní uzly ve fondu.

Name	Typ	Description
pack	string	Každému výpočetnímu uzlu ve fondu by mělo být přiřazeno co nejvíce úkolů (taskSlotsPerNode) před přiřazením k dalšímu výpočetnímu uzlu ve fondu.
spread	string	Úkoly by měly být přiřazeny rovnoměrně napříč všemi výpočetními uzly ve fondu.

ComputeNodeIdentityReference

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

Name	Typ	Description
resourceId	string	ID prostředku ARM identity přiřazené uživatelem.

ContainerConfiguration

Konfigurace pro fondy s podporou kontejnerů.

Name	Typ	Description
containerImageNames	string[]	Kolekce názvů imagí kontejneru. Toto je úplný odkaz na image, který by byl zadán pro "docker pull". Image bude zdrojem z výchozího registru Dockeru, pokud image není plně kvalifikovaná s alternativním registrem.
containerRegistries	ContainerRegistry[]	Další privátní registry, ze kterých je možné kontejnery načíst. Pokud je nutné stáhnout nějaké image z privátního registru, který vyžaduje přihlašovací údaje, musí být tyto přihlašovací údaje uvedené tady.
type	ContainerType	Technologie kontejneru, která se má použít.

ContainerRegistry

Privátní registr kontejneru.

Name	Typ	Description
identityReference	ComputeNodeIdentityReference	Odkaz na identitu přiřazenou uživatelem, která se použije pro přístup k Azure Container Registry místo uživatelského jména a hesla. Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude výpočetní uzel používat.
password	string	Heslo pro přihlášení k serveru registru.
registryServer	string	Adresa URL registru. Pokud ho vynecháte, výchozí hodnota je "docker.io".
username	string	Uživatelské jméno pro přihlášení k serveru registru.

ContainerType

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

Name	Typ	Description
criCompatible	string	Ke spuštění kontejnerů se použije technologie CRI.
dockerCompatible	string	Ke spuštění kontejnerů se použije technologie kontejnerů kompatibilní s Dockerem.

ContainerWorkingDirectory

Umístění pracovního adresáře úloh kontejneru.

Name	Typ	Description
containerImageDefault	string	Použijte pracovní adresář definovaný v imagi kontejneru. Mějte na pozoru, že tento adresář nebude obsahovat soubory prostředků stažené službou Batch.
taskWorkingDirectory	string	Použijte standardní pracovní adresář úkolů služby Batch, který bude obsahovat soubory zdrojů úkolů naplněné službou Batch.

DataDisk

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

Name	Typ	Description
caching	CachingType	Typ ukládání do mezipaměti, který se má povolit pro datové disky. Výchozí hodnota pro ukládání do mezipaměti je readwrite. Informace o možnostech ukládání do mezipaměti najdete tady: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	Počáteční velikost disku v gigabajtech.
lun	integer	Číslo logické jednotky. Logická jednotka se používá k jedinečné identifikaci jednotlivých datových disků. Pokud připojujete více disků, každý z nich by měl mít jinou logickou jednotku. Hodnota musí být mezi 0 a 63 včetně.
storageAccountType	StorageAccountType	Typ účtu úložiště, který se má použít pro datový disk. Pokud je vynechán, výchozí hodnota je "standard_lrs".

DiffDiskPlacement

Určuje dočasné umístění disku pro disk s operačním systémem pro všechny výpočetní uzly (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ý výpočetním uzlem (virtuálním počítačem).

Name	Typ	Description
placement	DiffDiskPlacement	Určuje umístění dočasného disku pro disk operačního systému pro všechny virtuální počítače ve fondu. Tuto vlastnost může uživatel v požadavku použít k volbě umístění, 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 velikost disku s dočasným operačním systémem najdete v tématu Požadavky na velikost dočasného disku s operačním systémem pro virtuální počítače s Windows na https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a virtuální počítače s Linuxem na adrese https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

Konfigurace šifrování disku použitá na výpočetních uzlech ve fondu Konfigurace šifrování disků se nepodporuje ve fondu Linuxu vytvořeném s imagí Azure Compute Gallery.

Name	Typ	Description
targets	DiskEncryptionTarget[]	Seznam cílových disků bude služba Batch šifrovat na výpočetním uzlu. Pokud ji vynecháte, nebudou zašifrovány žádné disky na výpočetních uzlech ve fondu. Ve fondu Linuxu se podporuje pouze Dočasný disk. ve fondu Windows musí být zadány "OsDisk" a "TemporaryDisk".

DiskEncryptionTarget

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

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

DynamicVNetAssignmentScope

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

Name	Typ	Description
job	string	Dynamické přiřazení virtuální sítě se provádí pro každou úlohu.
none	string	Není povolené žádné dynamické přiřazení virtuální sítě.

ElevationLevel

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

Name	Typ	Description
admin	string	Uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce.
nonadmin	string	Uživatel je standardní uživatel bez zvýšeného přístupu.

EnvironmentSetting

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

Name	Typ	Description
name	string	Název proměnné prostředí.
value	string	Hodnota proměnné prostředí.

ErrorMessage

Chybová zpráva přijatá v Azure Batch chybovou odpověď.

Name	Typ	Description
lang	string	Kód jazyka chybové zprávy
value	string	Text zprávy

ImageReference

Odkaz na image Azure Virtual Machines Marketplace nebo image Azure Compute Gallery. Pokud chcete získat seznam všech odkazů na Azure Marketplace image ověřených Azure Batch, podívejte se na operaci Výpis podporovaných imagí.

Name	Typ	Description
exactVersion	string	Konkrétní verze image platformy nebo image marketplace použité k vytvoření uzlu Toto pole jen pro čtení se liší od verze pouze v případě, že hodnota zadaná pro "version" při vytvoření fondu byla "nejnovější".
offer	string	Typ nabídky image Azure Virtual Machines Marketplace. Například UbuntuServer nebo WindowsServer.
publisher	string	Vydavatel image Azure Virtual Machines Marketplace. Například Canonical nebo MicrosoftWindowsServer.
sku	string	Skladová položka image Azure Virtual Machines Marketplace. Například 18.04-LTS nebo 2019-Datacenter.
version	string	Verze image Azure Virtual Machines Marketplace. Pro výběr nejnovější verze image je možné zadat hodnotu "latest". Pokud je vynechán, výchozí hodnota je "nejnovější".
virtualMachineImageId	string	Identifikátor prostředku ARM image Azure Compute Gallery. Výpočetní uzly ve fondu se vytvoří pomocí tohoto ID image. Toto je ve formátu /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} nebo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} pro vždy výchozí nejnovější verzi image. Tato vlastnost se vzájemně vylučuje s jinými vlastnostmi ImageReference. Image Azure Compute Gallery musí mít repliky ve stejné oblasti a musí být ve stejném předplatném jako účet Azure Batch. Pokud verze image není v identifikátoru imageId zadána, použije se nejnovější verze. Informace o nastavení brány firewall pro agenta Výpočetního uzlu služby Batch pro komunikaci se službou Batch najdete v tématu https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Protokol koncového bodu.

Name	Typ	Description
tcp	string	Jako koncový bod použijte protokol TCP.
udp	string	Jako koncový bod použijte UDP.

InboundNATPool

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

Name	Typ	Description
backendPort	integer	Číslo portu na výpočetním uzlu. Musí být jedinečný v rámci fondu služby Batch. Přijatelné hodnoty jsou mezi 1 a 65535 s výjimkou 22, 3389, 29876 a 29877, protože jsou rezervované. Pokud jsou zadány rezervované hodnoty, požadavek selže se stavovým kódem HTTP 400.
frontendPortRangeEnd	integer	Poslední číslo portu v rozsahu externích portů, které se použije k poskytování příchozího přístupu k backendPortu na jednotlivých výpočetních uzlech. Přípustné hodnoty jsou v rozsahu od 1 do 65534 s výjimkou portů od 50000 do 55000, které jsou rezervované službou Batch. Všechny oblasti v rámci fondu musí být odlišné a nesmí se překrývat. Každý rozsah musí obsahovat alespoň 40 portů. Pokud jsou zadány rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400.
frontendPortRangeStart	integer	První číslo portu v rozsahu externích portů, které se použije k poskytování příchozího přístupu k backendPortu na jednotlivých výpočetních uzlech. Přípustné hodnoty jsou v rozsahu od 1 do 65534 s výjimkou rezervovaných portů od 50000 do 55000. Všechny oblasti v rámci fondu musí být odlišné a nesmí se překrývat. Každý rozsah musí obsahovat alespoň 40 portů. Pokud jsou zadány rezervované nebo překrývající se hodnoty, požadavek selže se stavovým kódem HTTP 400.
name	string	Název koncového bodu. Název musí být jedinečný v rámci fondu služby Batch a musí 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, číslicí nebo podtržítkem a nesmí být delší než 77 znaků. Pokud jsou zadány neplatné hodnoty, požadavek selže se stavovým kódem HTTP 400.
networkSecurityGroupRules	NetworkSecurityGroupRule[]	Seznam pravidel skupiny zabezpečení sítě, která se použijí na koncový bod. Maximální počet pravidel, která je možné zadat ve všech koncových bodech ve fondu batch, je 25. Pokud nejsou zadaná žádná pravidla skupiny zabezpečení sítě, vytvoří se výchozí pravidlo, které povolí příchozí přístup k zadanému backendPortu. Pokud dojde k překročení maximálního počtu pravidel skupiny zabezpečení sítě, požadavek selže se stavovým kódem HTTP 400.
protocol	InboundEndpointProtocol	Protokol koncového bodu.

IPAddressProvisioningType

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

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	Nebude vytvořena žádná veřejná IP adresa.
usermanaged	string	Veřejné IP adresy poskytuje uživatel a použijí se ke zřízení výpočetních uzlů.

LinuxUserConfiguration

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

Name	Typ	Description
gid	integer	ID skupiny pro uživatelský účet. Vlastnosti uid a gid musí být zadány společně, nebo vůbec. Pokud není zadán základní operační systém vybere gid.
sshPrivateKey	string	Privátní klíč SSH uživatelského účtu. Privátní klíč nesmí být chráněný heslem. Privátní klíč se používá k automatické konfiguraci ověřování na základě asymetrického klíče pro SSH mezi výpočetními uzly ve fondu Linuxu, pokud má vlastnost enableInterNodeCommunication fondu hodnotu true (pokud má vlastnost enableInterNodeCommunication hodnotu false), je ignorována). Provede to tak, že pár klíčů umístí do adresáře .ssh uživatele. Pokud není zadaný, mezi výpočetními uzly se nenakonfiguruje SSH bez hesla (nedojde k žádné úpravě adresáře .ssh uživatele).
uid	integer	ID uživatele uživatelského účtu. Vlastnosti uid a gid musí být zadány společně, nebo vůbec. Pokud není zadáno, základní operační systém vybere identifikátor UID.

LoginMode

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

Name	Typ	Description
batch	string	Režim přihlášení LOGON32_LOGON_BATCH Win32. Režim dávkového přihlášení se doporučuje pro dlouhotrvající paralelní procesy.
interactive	string	Režim přihlášení LOGON32_LOGON_INTERACTIVE Win32. Nástroj Řízení uživatelských účtů je povolený ve fondech konfigurace Windows VirtualMachine. Pokud je tato možnost použita se zvýšenou identitou uživatele ve fondu Windows VirtualMachineConfiguration, relace uživatele nebude zvýšena, pokud aplikace spuštěná příkazovým řádkem task není nakonfigurována tak, aby vždy vyžadovala oprávnění správce nebo aby vždy vyžadovala maximální oprávnění.

ManagedDisk

Name	Typ	Description
storageAccountType	StorageAccountType	Typ účtu úložiště pro spravovaný disk.

MetadataItem

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

Name	Typ	Description
name	string	Název položky metadat.
value	string	Hodnota položky metadat.

MountConfiguration

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

Name	Typ	Description
azureBlobFileSystemConfiguration	AzureBlobFileSystemConfiguration	Kontejner služby Azure Storage, který se má připojit pomocí FUSE objektů blob na každém uzlu. Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.
azureFileShareConfiguration	AzureFileShareConfiguration	Sdílená složka Azure, která se připojí k jednotlivým uzlům. Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.
cifsMountConfiguration	CIFSMountConfiguration	Systém souborů CIFS/SMB, který se připojí k jednotlivým uzlům. Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.
nfsMountConfiguration	NFSMountConfiguration	Systém souborů NFS, který se připojí k jednotlivým uzlům. Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.

NetworkConfiguration

Konfigurace sítě pro fond

Name	Typ	Description
dynamicVNetAssignmentScope	DynamicVNetAssignmentScope	Rozsah dynamického přiřazení virtuální sítě.
enableAcceleratedNetworking	boolean	Jestli má tento fond povolit akcelerované síťové služby. Akcelerované síťové služby umožňují virtualizaci SR-IOV (Single Root I/O Virtualization) na virtuálním počítači, což může vést k lepšímu výkonu sítě. Další podrobnosti najdete tady: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration	PoolEndpointConfiguration	Konfigurace pro koncové body na výpočetních uzlech ve fondu služby Batch. Konfigurace koncového bodu fondu se podporuje pouze u fondů s vlastností virtualMachineConfiguration.
publicIPAddressConfiguration	PublicIPAddressConfiguration	Konfigurace veřejné IP adresy pro výpočetní uzly ve fondu služby Batch. Vlastnost konfigurace veřejné IP adresy se podporuje pouze u fondů s vlastností virtualMachineConfiguration.
subnetId	string	Identifikátor prostředku ARM podsítě virtuální sítě, ke které se připojí výpočetní uzly fondu. Toto je ve formátu /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Virtuální síť musí být ve stejné oblasti a předplatném jako účet Azure Batch. Zadaná podsíť by měla mít dostatek volných IP adres, aby pojala počet výpočetních uzlů ve fondu. Pokud podsíť nemá dostatek volných IP adres, fond částečně přidělí uzly a dojde k chybě změny velikosti. Instanční objekt MicrosoftAzureBatch musí mít pro zadanou virtuální síť roli přispěvatele klasických virtuálních počítačů Role-Based Access Control (RBAC). Zadaná podsíť musí umožňovat komunikaci ze služby Azure Batch, aby bylo možné plánovat úlohy na uzlech. Můžete to ověřit tak, že zkontrolujete, jestli má zadaná virtuální síť nějaké přidružené skupiny zabezpečení sítě (NSG). Pokud skupina zabezpečení sítě odmítne komunikaci s uzly v zadané podsíti, nastaví služba Batch stav výpočetních uzlů na nepoužitelné. Pro fondy vytvořené pomocí virtualMachineConfiguration se podporují jenom virtuální sítě ARM (Microsoft.Network/virtualNetworks), ale pro fondy vytvořené pomocí cloudServiceConfiguration se podporují virtuální sítě ARM i klasické virtuální sítě. Pokud zadaná virtuální síť nemá žádné přidružené skupiny zabezpečení sítě (NSG), musí být pro několik vyhrazených systémových portů povolena příchozí komunikace. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 a také port 22 pro Linux a port 3389 pro Windows. Pro fondy vytvořené s konfigurací cloudové služby povolte porty 10100, 20100 a 30100. Povolte také odchozí připojení ke službě Azure Storage na portu 443. Další podrobnosti najdete tady: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

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

Name	Typ	Description
access	NetworkSecurityGroupRuleAccess	Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku.
priority	integer	Priorita tohoto pravidla. Priority v rámci fondu musí být jedinečné a vyhodnocují se v pořadí podle priority. Čím nižší je číslo, tím vyšší je priorita. Pravidla mohou být například určena s čísly objednávek 150, 250 a 350. Pravidlo s číslem objednávky 150 má přednost před pravidlem, které má pořadí 250. Povolené priority jsou 150 až 4096. Pokud jsou zadány rezervované nebo duplicitní hodnoty, požadavek selže se stavovým kódem HTTP 400.
sourceAddressPrefix	string	Předpona zdrojové adresy nebo značka, která se má shodovat s pravidlem. Platnými hodnotami jsou jedna IP adresa (tj. 10.10.10.10), podsíť PROTOKOLU IP (tj. 192.168.1.0/24), výchozí značka nebo * (pro všechny adresy). Pokud jsou zadané nějaké další hodnoty, požadavek selže se stavovým kódem HTTP 400.
sourcePortRanges	string[]	Rozsahy zdrojových portů, které se mají shodovat s pravidlem. Platné hodnoty jsou '' (pro všechny porty 0 až 65535), konkrétní port (tj. 22) nebo rozsah portů (tj. 100–200). Porty musí být v rozsahu od 0 do 65535. Každá položka v této kolekci nesmí překrývat žádnou jinou položku (buď rozsah, nebo jednotlivý port). Pokud jsou zadané nějaké další hodnoty, požadavek selže se stavovým kódem HTTP 400. Výchozí hodnota je .

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žnosti příkazového řádku, které se mají předat příkazu mount. Jedná se o možnosti net use ve Windows a možnosti připojení v Linuxu.
relativeMountPath	string	Relativní cesta na výpočetním uzlu, ke které se připojí systém souborů Všechny systémy souborů jsou připojené vzhledem k adresáři připojení služby Batch a jsou přístupné prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.
source	string	Identifikátor URI systému souborů, který chcete připojit.

NodeCommunicationMode

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

Name	Typ	Description
classic	string	Uzly používající klasický režim komunikace vyžadují příchozí komunikaci TCP na portech 29876 a 29877 ze služby BatchNodeManagement. Značka služby {region} a odchozí komunikace TCP na portu 443 s úložištěm Storage.region a BatchNodeManagement. Značky služby {region}
default	string	Režim komunikace uzlu je automaticky nastaven službou Batch.
simplified	string	Uzly používající zjednodušený režim komunikace vyžadují odchozí komunikaci TCP na portu 443 do služby BatchNodeManagement. Značka služby {region} Nevyžadují se žádné otevřené příchozí porty.

NodePlacementConfiguration

Konfigurace umístění uzlů pro fond

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

NodePlacementPolicyType

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

Name	Typ	Description
regional	string	Všechny uzly ve fondu budou přiděleny ve stejné oblasti.
zonal	string	Uzly ve fondu budou rozdělené do různých zón dostupnosti s vyrovnáváním maximálního úsilí.

OSDisk

Nastavení pro disk operačního systému výpočetního uzlu

Name	Typ	Description
caching	CachingType	Určuje požadavky na ukládání do mezipaměti. Možné hodnoty jsou: None, ReadOnly, ReadWrite. Výchozí hodnoty jsou: Žádné pro úložiště úrovně Standard. ReadOnly pro Premium Storage. Výchozí hodnota pro ukládání do mezipaměti je žádná. Informace o možnostech ukládání do mezipaměti najdete tady: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	Počáteční velikost disku v GB při vytváření nového disku s operačním systémem
ephemeralOSDiskSettings	DiffDiskSettings	Určuje dočasné nastavení disku pro disk operačního systému používaný výpočetním uzlem (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.

PoolAddParameter

Fond ve službě Azure Batch, který chcete přidat.

Name	Typ	Description
applicationLicenses	string[]	Seznam licencí aplikací, které služba Batch zpřístupní na každém výpočetním uzlu ve fondu. Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud je požadována licence, která není podporovaná, vytvoření fondu se nezdaří.
applicationPackageReferences	ApplicationPackageReference[]	Seznam balíčků, které se mají nainstalovat na každý výpočetní uzel ve fondu. Při vytváření fondu musí být ID aplikace balíčku plně kvalifikované (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Změny odkazů na balíčky mají vliv na všechny nové uzly, které se připojují k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nereimagují. V každém daném fondu je maximálně 10 odkazů na balíčky.
autoScaleEvaluationInterval	string	Časový interval, ve kterém se má velikost fondu automaticky upravit podle vzorce automatického škálování. Výchozí hodnota je 15 minut. Minimální a maximální hodnota je 5 minut a 168 hodin. Pokud zadáte hodnotu menší než 5 minut nebo více než 168 hodin, vrátí služba Batch chybu; Pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (chybný požadavek).
autoScaleFormula	string	Vzorec pro požadovaný počet výpočetních uzlů ve fondu. Tato vlastnost nesmí být zadána, pokud je vlastnost enableAutoScale nastavená na hodnotu false. Vyžaduje se, pokud je vlastnost enableAutoScale nastavená na hodnotu true. Platnost vzorce se kontroluje před vytvořením fondu. Pokud vzorec není platný, služba Batch požadavek odmítne s podrobnými informacemi o chybě. Další informace o zadání tohoto vzorce najdete v tématu Automatické škálování výpočetních uzlů ve fondu Azure Batch (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
certificateReferences	CertificateReference[]	Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu. U uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště certifikátů a umístění. V případě linuxových výpočetních uzlů se certifikáty ukládají v adresáři v pracovním adresáři úlohy a do úlohy se zadává proměnná prostředí, AZ_BATCH_CERTIFICATES_DIR se má dotazovat na toto umístění. U certifikátů s viditelností remoteUser se v domovském adresáři uživatele vytvoří adresář certs (např. /home/{user-name}/certs) a certifikáty se umístí do tohoto adresáře. Upozornění: Tato vlastnost je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .
cloudServiceConfiguration	CloudServiceConfiguration	Konfigurace cloudové služby pro fond Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a jedna z vlastností musí být zadána. Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na hodnotu UserSubscription.
displayName	string	Zobrazovaný název fondu. Zobrazovaný název nemusí být jedinečný a může obsahovat jakékoli znaky Unicode až do maximální délky 1024.
enableAutoScale	boolean	Určuje, jestli se má velikost fondu v průběhu času automaticky upravovat. Pokud false, musí být zadána alespoň jedna z targetDedicatedNodes a targetLowPriorityNodes. Pokud je hodnota true, vlastnost autoScaleFormula je povinná a velikost fondu se automaticky změní podle vzorce. Výchozí hodnota je False.
enableInterNodeCommunication	boolean	Jestli fond umožňuje přímou komunikaci mezi výpočetními uzly. Povolení komunikace mezi uzly omezuje maximální velikost fondu kvůli omezením nasazení na výpočetních uzlech fondu. To může vést k tomu, že fond nedosáhne požadované velikosti. Výchozí hodnota je False.
id	string	Řetězec, který jednoznačně identifikuje fond v rámci účtu. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně spojovníků a podtržítků a nesmí obsahovat více než 64 znaků. ID zachovává malá a malá písmena a nerozlišuje se (to znamená, že v rámci účtu nemusíte mít dvě ID fondu, která se liší pouze velikostí písmen).
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 určen výhradně pro použití uživatelského kódu.
mountConfiguration	MountConfiguration[]	Připojte úložiště pomocí zadaného systému souborů po celou dobu životnosti fondu. Připojte úložiště pomocí sdílené složky Azure, systému souborů NFS, CIFS nebo systému souborů blobfuse.
networkConfiguration	NetworkConfiguration	Konfigurace sítě pro fond Konfigurace sítě pro fond
resizeTimeout	string	Časový limit pro přidělení výpočetních uzlů do fondu. Tento časový limit platí pouze pro ruční škálování. pokud je vlastnost enableAutoScale nastavená na hodnotu true, nemá žádný vliv. Výchozí hodnota je 15 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch vrátí chybu; Pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (Chybný požadavek).
resourceTags	object	Uživatelem zadané značky přidružené k fondu. Uživatelem definované značky, které mají být přidruženy k fondu Azure Batch. Po zadání se tyto značky rozšíří do záložních prostředků Azure přidružených k fondu. Tuto vlastnost lze zadat pouze v případě, že byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na UserSubscription.
startTask	StartTask	Úloha určená ke spuštění na každém výpočetním uzlu při připojení k fondu. Úloha se spustí při přidání výpočetního uzlu do fondu nebo při restartování výpočetního uzlu.
targetDedicatedNodes	integer	Požadovaný počet vyhrazených výpočetních uzlů ve fondu Tato vlastnost nesmí být zadána, pokud je vlastnost enableAutoScale nastavená na hodnotu true. Pokud je vlastnost enableAutoScale nastavená na hodnotu false, musíte nastavit buď targetDedicatedNodes, targetLowPriorityNodes, nebo obojí.
targetLowPriorityNodes	integer	Požadovaný počet spotových výpočetních uzlů nebo výpočetních uzlů s nízkou prioritou ve fondu Tato vlastnost nesmí být zadána, pokud je vlastnost enableAutoScale nastavená na hodnotu true. Pokud je vlastnost enableAutoScale nastavená na hodnotu false, musíte nastavit buď targetDedicatedNodes, targetLowPriorityNodes, nebo obojí.
targetNodeCommunicationMode	NodeCommunicationMode	Požadovaný režim komunikace uzlu pro fond. Pokud je vynechán, výchozí hodnota je Výchozí.
taskSchedulingPolicy	TaskSchedulingPolicy	Jak se úlohy distribuují mezi výpočetní uzly ve fondu. Pokud není zadáno, je výchozí rozprostřený.
taskSlotsPerNode	integer	Počet slotů úloh, které lze použít ke spouštění souběžných úloh na jednom výpočetním uzlu ve fondu. Výchozí hodnota je 1. Maximální hodnota je menší ze 4násobku počtu jader vmSize fondu nebo 256.
userAccounts	UserAccount[]	Seznam uživatelských účtů, které se mají vytvořit na každém výpočetním uzlu ve fondu.
virtualMachineConfiguration	VirtualMachineConfiguration	Konfigurace virtuálního počítače pro fond. Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a musí být zadána jedna z vlastností.
vmSize	string	Velikost virtuálních počítačů ve fondu. Všechny virtuální počítače ve fondu mají stejnou velikost. Informace o dostupných velikostech virtuálních počítačů pro fondy Cloud Services (fondy vytvořené pomocí cloudServiceConfiguration) najdete v tématu Velikosti pro Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch podporuje všechny velikosti virtuálních počítačů Cloud Services s výjimkou ExtraSmall, A1V2 a A2V2. Informace o dostupných velikostech virtuálních počítačů pro fondy využívající image z Virtual Machines Marketplace (fondy vytvořené pomocí virtualMachineConfiguration) najdete v tématu Velikosti pro Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) nebo Velikosti pro Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch podporuje všechny velikosti virtuálních počítačů Azure s výjimkou STANDARD_A0 a virtuálních počítačů se službou Premium Storage (řady STANDARD_GS, STANDARD_DS a STANDARD_DSV2).

PoolEndpointConfiguration

Konfigurace koncového bodu pro fond

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

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 – pro každou veřejnou IP adresu je možné přidělit 100 vyhrazených uzlů nebo 100 uzlů spotové/s nízkou prioritou. Například fond, který potřebuje 250 vyhrazených virtuálních počítačů, bude potřebovat aspoň 3 veřejné IP adresy. Každý prvek této kolekce má tvar: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.
provision	IPAddressProvisioningType	Typ zřizování pro veřejné IP adresy fondu. Výchozí hodnota je BatchManaged.

ResourceFile

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

Name	Typ	Description
autoStorageContainerName	string	Název kontejneru úložiště v účtu automatického úložiště. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána.
blobPrefix	string	Předpona objektu blob, která se má použít při stahování objektů blob z kontejneru Azure Storage. Stáhnou se jenom objekty blob, jejichž názvy začínají zadanou předponou. Vlastnost je platná pouze při použití autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečný název souboru nebo podadresář. Pokud není předpona zadána, stáhnou se všechny soubory v kontejneru.
fileMode	string	Atribut režimu oprávnění k souboru v osmičkovém formátu. Tato vlastnost se vztahuje pouze na soubory stahované do výpočetních uzlů s Linuxem. Pokud je zadaný pro resourceFile, který se stáhne do výpočetního uzlu Windows, bude ignorován. Pokud tato vlastnost není pro výpočetní uzel s Linuxem zadaná, použije se pro soubor výchozí hodnota 0770.
filePath	string	Umístění na výpočetním uzlu, do kterého se mají stáhnout soubory, vzhledem k pracovnímu adresáři úlohy. Pokud je zadána vlastnost httpUrl, filePath je povinný a popisuje cestu, do které bude soubor stažen, včetně názvu souboru. Jinak pokud je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je nepovinný a je adresář ke stažení souborů do. V případě použití filePath jako adresáře se veškerá adresářová struktura, která je již přidružená ke vstupním datům, zachovají v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže být oddělena od pracovního adresáře úlohy (například pomocí ..).
httpUrl	string	Adresa URL souboru, který chcete stáhnout. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána. Pokud adresa URL odkazuje na Azure Blob Storage, musí být čitelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL pro objekt blob ve službě Azure Storage: patří sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použití spravované identity s oprávněním ke čtení nebo nastavení seznamu ACL pro objekt blob nebo jeho kontejner tak, aby umožňoval veřejný přístup.
identityReference	ComputeNodeIdentityReference	Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup k Azure Blob Storage určené pomocí storageContainerUrl nebo httpUrl Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude používat výpočetní uzel.
storageContainerUrl	string	Adresa URL kontejneru objektů blob v rámci Azure Blob Storage. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána. Tato adresa URL musí být čitelná a vypsatelná z výpočetních uzlů. Existují tři způsoby, jak takovou adresu URL pro kontejner ve službě Azure Storage získat: můžete zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení a seznamu v kontejneru, použít spravovanou identitu s oprávněními ke čtení a seznamu seznamů nebo nastavit seznam ACL pro kontejner tak, aby umožňoval veřejný přístup.

SecurityProfile

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

Name	Typ	Description
encryptionAtHost	boolean	Tuto vlastnost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím se povolí šifrování pro všechny disky, včetně disku prostředku nebo dočasného disku v samotném hostiteli.
securityType	SecurityTypes	Určuje SecurityType virtuálního počítače. Pokud chcete povolit UefiSettings, musí být nastavena na libovolnou zadanou hodnotu.
uefiSettings	UefiSettings	Určuje nastavení zabezpečení, jako je zabezpečené spouštění a virtuální počítač vTPM použitý při vytváření virtuálního počítače. Určuje nastavení zabezpečení, jako je zabezpečené spouštění a virtuální počítač vTPM použitý při vytváření virtuálního počítače.

SecurityTypes

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

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

ServiceArtifactReference

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

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

StartTask

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

Name	Typ	Description
commandLine	string	Příkazový řádek StartTask. Příkazový řádek se nespouští v prostředí, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd /c MyCommand" ve Windows nebo "/bin/sh -c MyCommand" v Linuxu. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (vzhledem k pracovnímu adresáři Úloh) nebo proměnnou prostředí poskytovanou službou Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
containerSettings	TaskContainerSettings	Nastavení kontejneru, ve kterém běží StartTask. Když je tato možnost zadána, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) se mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úlohy se spustí v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na disku hostitele, což znamená, že rozhraní API služby Batch nebudou mít k těmto souborům přístup.
environmentSettings	EnvironmentSetting[]	Seznam nastavení proměnných prostředí pro StartTask.
maxTaskRetryCount	integer	Maximální počet opakování úkolu. Služba Batch opakuje úlohu, pokud její ukončovací kód není nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch tuto úlohu jednou vyzkouší a až do tohoto limitu se může zkusit znovu. Pokud je například maximální počet opakování 3, služba Batch zkusí úlohu až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch nezkusí úlohu zopakovat. Pokud je maximální počet opakování -1, služba Batch opakuje úlohu bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (bez opakování).
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. Seznam souborů prostředků má maximální velikost. Při překročení maximální velikosti požadavek selže a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí se zmenšit velikost kolekce ResourceFiles. Toho můžete dosáhnout pomocí souborů .zip, balíčků aplikací nebo kontejnerů Dockeru. Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úlohy.
userIdentity	UserIdentity	Identita uživatele, pod kterou běží StartTask. Pokud je úloha vynechána, spustí se jako uživatel bez oprávnění správce, který je jedinečný pro danou úlohu.
waitForSuccess	boolean	Jestli má služba Batch čekat na úspěšné dokončení startTask (tj. na ukončení s ukončovacím kódem 0) před plánováním úkolů na výpočetním uzlu. Pokud je hodnota true a startTask selže na uzlu, služba Batch opakuje startTask až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úloha ani po všech opakováních úspěšně nedokončila, služba Batch označí uzel jako nepoužitelný a nebude na něj plánovat úkoly. Tuto podmínku je možné zjistit prostřednictvím podrobností o stavu výpočetního uzlu a informací o selhání. Pokud je false, služba Batch nebude čekat na dokončení StartTask. V takovém případě se na výpočetním uzlu můžou spustit další úkoly, zatímco startTask je stále spuštěný. a i když startTask selže, budou se nové úkoly dál plánovat na výpočetním uzlu. 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.
standard_lrs	string	Datový disk nebo disk s operačním systémem by měl používat standardní místně redundantní úložiště.
standardssd_lrs	string	Datový disk nebo disk s operačním systémem by měl používat standardní místně redundantní úložiště SSD.

TaskContainerSettings

Nastavení kontejneru pro úlohu.

Name	Typ	Description
containerRunOptions	string	Další možnosti příkazu container create Tyto další možnosti jsou kromě možností řízených službou Batch k dispozici jako argumenty příkazu docker create.
imageName	string	Image, která se má použít k vytvoření kontejneru, ve kterém bude úloha spuštěna. Toto je úplný odkaz na image, který by byl zadán pro "docker pull". Pokud jako součást názvu obrázku není uvedena žádná značka, použije se jako výchozí značka ":latest".
registry	ContainerRegistry	Privátní registr, který obsahuje image kontejneru. Toto nastavení je možné vynechat, pokud už jste ho zadali při vytváření fondu.
workingDirectory	ContainerWorkingDirectory	Umístění pracovního adresáře úloh kontejneru. Výchozí hodnota je taskWorkingDirectory.

TaskSchedulingPolicy

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

Name	Typ	Description
nodeFillType	ComputeNodeFillType	Způsob distribuce úkolů mezi výpočetní uzly ve fondu Pokud není zadaný, je výchozí hodnota rozložena.

UefiSettings

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

Name	Typ	Description
secureBootEnabled	boolean	Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění.
vTpmEnabled	boolean	Určuje, jestli se má na virtuálním počítači povolit vTPM.

UserAccount

Vlastnosti použité k vytvoření uživatele sloužícího ke spouštění úloh na výpočetním uzlu Azure Batch.

Name	Typ	Description
elevationLevel	ElevationLevel	Úroveň zvýšení oprávnění uživatelského účtu. Výchozí hodnota je nonAdmin.
linuxUserConfiguration	LinuxUserConfiguration	Konfigurace uživatele specifická pro Linux pro uživatelský účet. Tato vlastnost je ignorována, 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, uživatel se vytvoří s výchozími možnostmi.

UserIdentity

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

Name	Typ	Description
autoUser	AutoUserSpecification	Automatický uživatel, pod kterým je úloha spuštěna. Vlastnosti userName a autoUser se vzájemně vylučují; musíte zadat jeden, ale ne oba.
username	string	Název identity uživatele, pod kterou je úloha spuštěna. Vlastnosti userName a autoUser se vzájemně vylučují; musíte zadat jeden, ale ne oba.

VirtualMachineConfiguration

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

Name	Typ	Description
containerConfiguration	ContainerConfiguration	Konfigurace kontejneru pro fond. Pokud je tato možnost zadána, provede se na každém výpočetním uzlu ve fondu nastavení, 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 ji mohou určit.
dataDisks	DataDisk[]	Konfigurace datových disků připojených k výpočetním uzlům ve fondu Tato vlastnost musí být zadána, pokud výpočetní uzly ve fondu potřebují mít připojené prázdné datové disky. Tuto aktualizaci nelze aktualizovat. Každý výpočetní uzel získá svůj vlastní disk (disk není sdílená složka). Existující disky nelze připojit, každý připojený disk je prázdný. Při odebrání výpočetního uzlu z fondu se disk a všechna data k němu přidružená také odstraní. Disk není po připojení naformátovaný, musí být před použitím naformátován – další informace najdete v tématu https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux a https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.
diskEncryptionConfiguration	DiskEncryptionConfiguration	Konfigurace šifrování disku pro fond. Pokud je zadáno, šifrování se provádí na každém uzlu ve fondu během zřizování uzlů.
extensions	VMExtension[]	Rozšíření virtuálního počítače pro fond. Pokud je tato hodnota zadána, rozšíření uvedená v této konfiguraci se nainstalují na každý uzel.
imageReference	ImageReference	Odkaz na image Azure Virtual Machines Marketplace nebo vlastní image virtuálního počítače, která se má použít.
licenseType	string	Typ místní licence, která se má použít při nasazování operačního systému. To platí jenom pro image, které obsahují operační systém Windows, a měly by se používat jenom v případě, že máte platné místní licence pro výpočetní uzly, které se nasadí. Pokud je tato možnost vynechána, neuplatní se žádná sleva za místní licencování. Hodnoty jsou: Windows_Server – místní licence je určená pro Windows Server. Windows_Client – místní licence je určená pro klienta Windows.
nodeAgentSKUId	string	Skladová položka agenta výpočetního uzlu Služby Batch, která se má zřídit na výpočetních uzlech ve fondu. Agent výpočetního uzlu služby Batch je program, který běží na každém výpočetním uzlu ve fondu a poskytuje rozhraní pro příkazy a řízení mezi výpočetním uzlem a službou Batch. Existují různé implementace agenta výpočetního uzlu, označovaného jako skladové položky, pro různé operační systémy. Musíte zadat skladovou položku agenta výpočetního uzlu, která odpovídá vybranému odkazu na image. Pokud chcete získat seznam podporovaných skladových položek agenta výpočetního uzlu spolu se seznamem ověřených odkazů na image, přečtěte si operaci Výpis podporovaných skladových položek agenta výpočetního uzlu.
nodePlacementConfiguration	NodePlacementConfiguration	Konfigurace umístění uzlu pro fond. Tato konfigurace určí pravidla, jak se budou uzly ve fondu fyzicky přidělovat.
osDisk	OSDisk	Nastavení pro disk operačního systému virtuálního počítače.
securityProfile	SecurityProfile	Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.
serviceArtifactReference	ServiceArtifactReference	Určuje REFERENČNÍ ID artefaktu služby, které se používá k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image. Referenční ID artefaktu služby ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}
windowsConfiguration	WindowsConfiguration	Nastavení operačního systému Windows na virtuálním počítači. Tato vlastnost nesmí být zadána, pokud vlastnost imageReference určuje image operačního systému Linux.

VMExtension

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

Name	Typ	Description
autoUpgradeMinorVersion	boolean	Označuje, jestli by rozšíření mělo používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.
enableAutomaticUpgrade	boolean	Určuje, jestli má platforma rozšíření automaticky upgradovat, pokud je k dispozici novější verze rozšíření.
name	string	Název rozšíření virtuálního počítače.
protectedSettings	object	Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault nebo vůbec žádné chráněné nastavení.
provisionAfterExtensions	string[]	Kolekce názvů rozšíření. Kolekce názvů rozšíření, po které je potřeba toto rozšíření zřídit.
publisher	string	Název vydavatele obslužné rutiny rozšíření.
settings	object	Veřejná nastavení rozšíření formátovaná ve formátu JSON
type	string	Typ rozšíření.
typeHandlerVersion	string	Verze obslužné rutiny skriptu.

WindowsConfiguration

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

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

WindowsUserConfiguration

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

Name	Typ	Description
loginMode	LoginMode	Režim přihlášení pro uživatele Výchozí hodnota pro fondy VirtualMachineConfiguration je batch a pro CloudServiceConfiguration Pools je interaktivní.