Sdílet prostřednictvím


Job - Add

Přidá úlohu do zadaného účtu.
Služba Batch podporuje dva způsoby řízení práce provedené jako součást úlohy. V prvním přístupu uživatel určuje úlohu správce úloh. Služba Batch spustí tuto úlohu, jakmile je připravena spustit úlohu. Úloha Správce úloh řídí všechny ostatní úkoly spuštěné v této úloze pomocí rozhraní API úloh. Ve druhém přístupu uživatel přímo řídí provádění úkolů v rámci aktivní úlohy pomocí rozhraní API úloh. Poznámka: Při pojmenování úloh 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é technikům podpory Microsoftu.

POST {batchUrl}/jobs?api-version=2024-07-01.20.0
POST {batchUrl}/jobs?timeout={timeout}&api-version=2024-07-01.20.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 služby Azure Batch.

api-version
query True

string

Verze rozhraní API klienta.

timeout
query

integer

int32

Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.

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, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.

ocp-date

string

date-time-rfc1123

Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.

Text požadavku

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

Name Vyžadováno Typ Description
id True

string

Řetězec, který jednoznačně identifikuje úlohu v rámci účtu.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. ID se zachovává a nerozlišuje malá a velká písmena (to znamená, že v rámci účtu nesmíte mít dvě ID, která se liší pouze v případě).

poolInfo True

PoolInformation

Fond, na kterém služba Batch spouští úlohy.

allowTaskPreemption

boolean

Zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou
Pokud je hodnota nastavena na Hodnotu True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moci znovu vytvořit frontu úkolů z této úlohy. Po vytvoření pomocí rozhraní API úlohy aktualizace můžete aktualizovat funkci allowTaskPreemption.

commonEnvironmentSettings

EnvironmentSetting[]

Seznam běžných nastavení proměnných prostředí Tyto proměnné prostředí jsou nastavené pro všechny úkoly v úloze (včetně správce úloh, přípravy úloh a úkolů uvolnění úloh).
Jednotlivé úlohy můžou přepsat nastavení prostředí zadané zde zadáním stejného názvu nastavení s jinou hodnotou.

constraints

JobConstraints

Omezení provádění pro úlohu.
Omezení provádění pro úlohu.

displayName

string

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

jobManagerTask

JobManagerTask

Podrobnosti o úloze správce úloh, která se má spustit při spuštění úlohy
Pokud úloha úlohu nezadá, uživatel musí do úlohy explicitně přidat úkoly. Pokud úloha zadá úlohu Správce úloh, služba Batch vytvoří úkol Správce úloh při vytvoření úlohy a pokusí se naplánovat úkol Správce úloh před naplánováním dalších úkolů v úloze. Typickým účelem úlohy správce úloh je řídit a/nebo monitorovat provádění úlohy, například rozhodováním o tom, jaké další úkoly se mají spustit, určit, kdy je práce dokončena atd. (Úloha správce úloh ale není omezena na tyto aktivity – jedná se o plnohodnotný úkol v systému a provádění jakýchkoli akcí požadovaných pro úlohu.) Například úloha Správce úloh může stáhnout soubor zadaný jako parametr, analyzovat obsah tohoto souboru a odeslat další úkoly na základě tohoto obsahu.

jobPreparationTask

JobPreparationTask

Úkol přípravy úlohy.
Pokud má úloha úlohu přípravy úlohy, služba Batch spustí úlohu přípravy úlohy na uzlu před spuštěním všech úkolů této úlohy na daném výpočetním uzlu.

jobReleaseTask

JobReleaseTask

Úloha uvolnění úlohy.
Úkol uvolnění úlohy nelze zadat bez zadání úkolu přípravy úlohy pro úlohu. Služba Batch spouští úlohu uvolnění úlohy na uzlech, které mají spuštěnou úlohu přípravy úlohy. Primárním účelem úlohy uvolnění úlohy je vrátit změny výpočetních uzlů provedených úkolem přípravy úlohy. Mezi příklady aktivit patří odstranění místních souborů nebo vypnutí služeb, které byly spuštěny v rámci přípravy úlohy.

maxParallelTasks

integer

Maximální počet úkolů, které lze pro úlohu spustit paralelně.
Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadána. Pokud není zadáno, výchozí hodnota je -1, což znamená, že neexistuje žádný limit počtu úkolů, které lze spustit najednou. Po vytvoření můžete aktualizovat maxParallelTasks úlohy pomocí rozhraní API úlohy aktualizace.

metadata

MetadataItem[]

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

networkConfiguration

JobNetworkConfiguration

Konfigurace sítě pro úlohu.

onAllTasksComplete

OnAllTasksComplete

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu.
Všimněte si, že pokud úloha neobsahuje žádné úkoly, považují se všechny úkoly za dokončené. Tato možnost se proto nejčastěji používá s úkolem Správce úloh; Pokud chcete použít automatické ukončení úlohy bez Správce úloh, měli byste nejprve nastavit onAllTasksComplete na noaction a aktualizovat vlastnosti úlohy nastavit onAllTasksComplete ukončitjob po dokončení přidávání úkolů. Výchozí hodnota je noaction.

onTaskFailure

OnTaskFailure

Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze.
Úloha se považuje za neúspěšnou, pokud má informace o selhání. Informace o selhání se nastaví, pokud se úkol dokončí s nenulovým ukončovacím kódem po vyčerpání počtu opakování nebo pokud došlo k chybě při spuštění úlohy, například kvůli chybě při stahování souboru prostředků. Výchozí hodnota je noaction.

priority

integer

Priorita úlohy.
Hodnoty priority mohou být v rozsahu od -1000 do 1 000, přičemž -1000 nejnižší prioritou a 1000 nejvyšší prioritou. Výchozí hodnota je 0.

usesTaskDependencies

boolean

Určuje, zda úkoly v úloze mohou definovat závislosti na sobě navzájem. Výchozí hodnota je false.

Odpovědi

Name Typ Description
201 Created

Požadavek na službu Batch byl úspěšný.

Hlavičky

  • 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

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

Authorization

Typ: apiKey
V: header

Příklady

Add a basic job
Add a complex job

Add a basic job

Ukázkový požadavek

POST account.region.batch.azure.com/jobs?api-version=2024-07-01.20.0



{
  "id": "jobId",
  "priority": 0,
  "poolInfo": {
    "poolId": "poolId"
  }
}

Ukázková odpověď

Add a complex job

Ukázkový požadavek

POST account.region.batch.azure.com/jobs?api-version=2024-07-01.20.0



{
  "id": "jobId",
  "priority": 100,
  "constraints": {
    "maxWallClockTime": "PT1H",
    "maxTaskRetryCount": -1
  },
  "jobManagerTask": {
    "id": "taskId",
    "commandLine": "myprogram.exe",
    "resourceFiles": [
      {
        "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
        "filePath": "myprogram.exe"
      },
      {
        "storageContainerUrl": "http://mystorage1.blob.core.windows.net/data?sas",
        "filePath": "datafolder"
      }
    ],
    "environmentSettings": [
      {
        "name": "myvariable",
        "value": "myvalue"
      }
    ],
    "constraints": {
      "maxWallClockTime": "PT1H",
      "maxTaskRetryCount": 0,
      "retentionTime": "PT1H"
    },
    "requiredSlots": 2,
    "killJobOnCompletion": false,
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "admin"
      }
    },
    "runExclusive": true
  },
  "poolInfo": {
    "autoPoolSpecification": {
      "autoPoolIdPrefix": "mypool",
      "poolLifetimeOption": "job",
      "pool": {
        "vmSize": "STANDARD_D2S_V3",
        "virtualMachineConfiguration": {
          "imageReference": {
            "publisher": "MicrosoftWindowsServer",
            "offer": "WindowsServer",
            "sku": "2016-datacenter-smalldisk",
            "version": "latest"
          },
          "nodeAgentSKUId": "batch.node.windows amd64",
          "windowsConfiguration": {
            "enableAutomaticUpdates": false
          },
          "nodePlacementConfiguration": {
            "policy": "zonal"
          }
        },
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 3,
        "targetLowPriorityNodes": 0,
        "taskSlotsPerNode": 2,
        "taskSchedulingPolicy": {
          "nodeFillType": "spread"
        },
        "enableAutoScale": false,
        "enableInterNodeCommunication": true,
        "startTask": {
          "commandLine": "myprogram2.exe",
          "resourceFiles": [
            {
              "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram2.exe?sas",
              "filePath": "myprogram2.exe"
            }
          ],
          "environmentSettings": [
            {
              "name": "myvariable",
              "value": "myvalue"
            }
          ],
          "userIdentity": {
            "autoUser": {
              "scope": "task",
              "elevationLevel": "admin"
            }
          },
          "maxTaskRetryCount": 2,
          "waitForSuccess": true
        },
        "certificateReferences": [
          {
            "thumbprint": "0123456789abcdef0123456789abcdef01234567",
            "thumbprintAlgorithm": "sha1",
            "storeLocation": "localmachine",
            "storeName": "Root",
            "visibility": [
              "task"
            ]
          }
        ],
        "metadata": [
          {
            "name": "myproperty",
            "value": "myvalue"
          }
        ],
        "targetNodeCommunicationMode": "default"
      }
    }
  },
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Ukázková odpověď

Definice

Name Description
AccessScope

Prostředky služby Batch, ke kterým token uděluje přístup.

ApplicationPackageReference

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

AuthenticationTokenSettings

Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch.

AutomaticOSUpgradePolicy

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

AutoPoolSpecification

Určuje charakteristiky dočasného automatického fondu. Služba Batch vytvoří tento automatický fond při odeslání úlohy.

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

BatchError

Odpověď na chybu přijatá ze služby Azure Batch

BatchErrorDetail

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

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.

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 ve 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.

ComputeNodeFillType

Jak se úkoly distribuují mezi výpočetní 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.

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

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

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.

DiffDiskPlacement

Určuje dočasné umístění disku pro disk operačního systému 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 (VM).

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í Galerie výpočetních prostředků Azure.

DiskEncryptionTarget

Seznam cílů disku služby Batch bude na výpočetním uzlu šifrovat.

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 v procesu úkolu.

ErrorMessage

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

HttpHeader

Pár název-hodnota hlavičky HTTP

ImageReference

Odkaz na image Azure Virtual Machines Marketplace nebo image galerie výpočetních prostředků Azure Pokud chcete získat seznam všech odkazů na image z Azure Marketplace ověřených službou Azure Batch, podívejte se na operaci Výpis podporovaných imagí.

InboundEndpointProtocol

Protokol koncového bodu.

InboundNATPool

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

IPAddressProvisioningType

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

JobAddParameter

Přidání úlohy Azure Batch

JobConstraints

Omezení provádění pro úlohu.

JobManagerTask

Určuje podrobnosti úlohy správce úloh.

JobNetworkConfiguration

Konfigurace sítě pro úlohu.

JobPreparationTask

Úkol přípravy úlohy, který se má spustit před všemi úkoly úlohy v libovolném výpočetním uzlu.

JobReleaseTask

Úloha uvolnění úlohy, která se má spustit při dokončení úlohy na libovolném výpočetním uzlu, na kterém je úloha spuštěná.

LinuxUserConfiguration

Vlastnosti používané 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 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 fond

NodePlacementPolicyType

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

OnAllTasksComplete

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu.

OnTaskFailure

Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze.

OSDisk

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

OutputFile

Specifikace pro nahrání souborů z výpočetního uzlu Služby Azure Batch do jiného umístění po dokončení provádění procesu úlohy

OutputFileBlobContainerDestination

Určuje cíl nahrání souboru v kontejneru úložiště objektů blob v Azure.

OutputFileDestination

Cíl, do kterého se má soubor nahrát.

OutputFileUploadCondition

Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů.

OutputFileUploadOptions

Podrobnosti o operaci nahrávání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést.

PoolEndpointConfiguration

Konfigurace koncového bodu pro fond.

PoolInformation

Určuje, jak se má úloha přiřadit k fondu.

PoolLifetimeOption

Minimální životnost vytvořených automatických fondů a způsob přiřazení více úloh podle plánu fondům.

PoolSpecification

Specifikace pro vytvoření nového fondu

PublicIPAddressConfiguration

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

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.

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: Je možné ji nastavit jenom 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čů.

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í 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.

TaskConstraints

Omezení provádění, která se mají použít pro úlohu.

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žívané k vytvoření uživatele, který se používá ke spouštění úkolů na výpočetním uzlu služby Azure Batch.

UserIdentity

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

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 vyžadovat ji 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žívané k vytvoření uživatelského účtu na výpočetním uzlu Windows

AccessScope

Prostředky služby Batch, ke kterým token uděluje přístup.

Name Typ Description
job

string

Uděluje přístup k provádění všech operací v úloze obsahující úkol.

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 tuto hodnotu vynecháte, nasadí se výchozí verze.
Pokud se tento parametr vynechá ve fondu 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 tento parametr vynechán u úlohy a pro tuto aplikaci není zadána žádná výchozí verze, úloha selže s chybou předběžného zpracování.

AuthenticationTokenSettings

Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch.

Name Typ Description
access

AccessScope[]

Prostředky služby Batch, ke kterým token uděluje přístup.
Ověřovací token uděluje přístup k omezené sadě operací služby Batch. V současné době je jedinou podporovanou hodnotou vlastnosti přístupu úloha, která uděluje přístup ke všem operacím souvisejícím s úlohou, která obsahuje úkol.

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.

AutoPoolSpecification

Určuje charakteristiky dočasného automatického fondu. Služba Batch vytvoří tento automatický fond při odeslání úlohy.

Name Typ Description
autoPoolIdPrefix

string

Předpona, která se má přidat k jedinečnému identifikátoru při automatickém vytvoření fondu.
Služba Batch přiřadí každému automatickému fondu jedinečný identifikátor při vytváření. Chcete-li rozlišovat mezi fondy vytvořenými pro různé účely, můžete zadat tento prvek pro přidání předpony k přiřazené ID. Předpona může mít délku až 20 znaků.

keepAlive

boolean

Určuje, jestli se má automatický fond udržovat naživu po vypršení jeho životnosti.
Pokud je hodnota false, služba Batch odstraní fond po vypršení jeho životnosti (podle nastavení poolLifetimeOption). to znamená, že po dokončení úlohy nebo plánu úlohy. Pokud je hodnota true, služba Batch fond automaticky neodstraní. Je na uživateli, aby pomocí této možnosti odstranil automatické fondy vytvořené.

pool

PoolSpecification

Specifikace fondu pro automatický fond.

poolLifetimeOption

PoolLifetimeOption

Minimální životnost vytvořených automatických fondů a způsob přiřazení více úloh podle plánu fondům.

AutoUserScope

Obor automatického uživatele

Name Typ Description
pool

string

Určuje, že úloha se spustí jako běž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 neníadmin.

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 Úlohy, pokud je vyžadována přísnější izolace mezi úlohami. Pokud například úloha ztlumí registr způsobem, který by mohl mít vliv na 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é nástrojem StartTasks.

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.

BatchError

Odpověď na chybu přijatá ze služby Azure Batch

Name Typ Description
code

string

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

message

ErrorMessage

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

values

BatchErrorDetail[]

Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name Typ Description
key

string

Identifikátor určující význam vlastnosti Value.

value

string

Další informace zahrnuté v odpovědi na chybu.

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.

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é 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 úlohy a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR je zadána do úlohy, která se má dotazovat na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{uživatelské jméno}/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.

thumbprint

string

Kryptografický otisk certifikátu.

thumbprintAlgorithm

string

Algoritmus, ke kterému je kryptografický otisk přidružený. To musí být sha1.

visibility

CertificateVisibility[]

Které uživatelské účty ve 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 ve 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, ve kterých uživatelé vzdáleně přistupuje 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 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.

ComputeNodeFillType

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

Name Typ Description
pack

string

Co nejvíce úkolů (taskSlotsPerNode) by mělo být přiřazeno každému výpočetnímu uzlu ve fondu předtím, než se všechny úkoly přiřadí 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 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 k "docker pull". Image bude zdroj 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

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

Name Typ Description
containerImageDefault

string

Použijte pracovní adresář definovaný v imagi 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ář úlohy 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.
Výchozí hodnota pro ukládání do mezipaměti je readwrite. 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 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ý 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.

DiffDiskPlacement

Určuje dočasné umístění disku pro disk operačního systému 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 (VM).

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í, například místa 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/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a virtuálních počítačích s Linuxem na https://docs.microsoft.com/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í Galerie výpočetních prostředků Azure.

Name Typ Description
targets

DiskEncryptionTarget[]

Seznam cílů disku služby Batch bude na výpočetním uzlu šifrovat.
Seznam cílů disku služby Batch bude na výpočetním uzlu šifrovat.

DiskEncryptionTarget

Seznam cílů disku služby Batch bude na výpočetním uzlu šifrovat.

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.

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 v procesu úkolu.

Name Typ Description
name

string

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

value

string

Hodnota proměnné prostředí.

ErrorMessage

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name Typ Description
lang

string

Kód jazyka chybové zprávy

value

string

Text zprávy.

HttpHeader

Pár název-hodnota hlavičky HTTP

Name Typ Description
name

string

Název hlavičky bez rozlišování malých a velkých písmen, který se má použít při nahrávání výstupních souborů

value

string

Hodnota hlavičky, která se má použít při nahrávání výstupních souborů

ImageReference

Odkaz na image Azure Virtual Machines Marketplace nebo image galerie výpočetních prostředků Azure Pokud chcete získat seznam všech odkazů na image z Azure Marketplace ověřených službou Azure Batch, podívejte se na operaci Výpis podporovaných imagí.

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.

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 verzi při vytvoření fondu byla "latest".

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 2019-Datacenter.

version

string

Verze image Azure Virtual Machines Marketplace.
Hodnotu "latest" je možné zadat, pokud chcete vybrat nejnovější verzi image. Pokud tento parametr vynecháte, výchozí hodnota je nejnovější.

virtualMachineImageId

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} nebo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} pro vždy výchozí nastavení nejnovější verze image.
Tato vlastnost se vzájemně vylučují s jinými vlastnostmi ImageReference. Image galerie výpočetních prostředků Azure 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í zadaná v id image, použije se nejnovější verze. Informace o nastavení brány firewall pro agenta výpočetního uzlu služby Batch ke komunikaci se službou Batch najdete v tématu https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

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 překladu adres (NAT), který lze použít k externímu řešení konkrétních portů na výpočetních uzlech ve fondu Batch.

Name Typ Description
backendPort

integer

Číslo portu ve 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 22, 3389, 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. Každá oblast musí obsahovat alespoň 40 portů. 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žije 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. Každá oblast musí obsahovat alespoň 40 portů. 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 dávkového fondu, 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á lze 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.

IPAddressProvisioningType

Typ zřizování pro veřejné IP adresy 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žije se ke zřízení výpočetních uzlů.

JobAddParameter

Přidání úlohy Azure Batch

Name Typ Default value Description
allowTaskPreemption

boolean

Zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou
Pokud je hodnota nastavena na Hodnotu True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moci znovu vytvořit frontu úkolů z této úlohy. Po vytvoření pomocí rozhraní API úlohy aktualizace můžete aktualizovat funkci allowTaskPreemption.

commonEnvironmentSettings

EnvironmentSetting[]

Seznam běžných nastavení proměnných prostředí Tyto proměnné prostředí jsou nastavené pro všechny úkoly v úloze (včetně správce úloh, přípravy úloh a úkolů uvolnění úloh).
Jednotlivé úlohy můžou přepsat nastavení prostředí zadané zde zadáním stejného názvu nastavení s jinou hodnotou.

constraints

JobConstraints

Omezení provádění pro úlohu.
Omezení provádění pro úlohu.

displayName

string

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

id

string

Řetězec, který jednoznačně identifikuje úlohu v rámci účtu.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. ID se zachovává a nerozlišuje malá a velká písmena (to znamená, že v rámci účtu nesmíte mít dvě ID, která se liší pouze v případě).

jobManagerTask

JobManagerTask

Podrobnosti o úloze správce úloh, která se má spustit při spuštění úlohy
Pokud úloha úlohu nezadá, uživatel musí do úlohy explicitně přidat úkoly. Pokud úloha zadá úlohu Správce úloh, služba Batch vytvoří úkol Správce úloh při vytvoření úlohy a pokusí se naplánovat úkol Správce úloh před naplánováním dalších úkolů v úloze. Typickým účelem úlohy správce úloh je řídit a/nebo monitorovat provádění úlohy, například rozhodováním o tom, jaké další úkoly se mají spustit, určit, kdy je práce dokončena atd. (Úloha správce úloh ale není omezena na tyto aktivity – jedná se o plnohodnotný úkol v systému a provádění jakýchkoli akcí požadovaných pro úlohu.) Například úloha Správce úloh může stáhnout soubor zadaný jako parametr, analyzovat obsah tohoto souboru a odeslat další úkoly na základě tohoto obsahu.

jobPreparationTask

JobPreparationTask

Úkol přípravy úlohy.
Pokud má úloha úlohu přípravy úlohy, služba Batch spustí úlohu přípravy úlohy na uzlu před spuštěním všech úkolů této úlohy na daném výpočetním uzlu.

jobReleaseTask

JobReleaseTask

Úloha uvolnění úlohy.
Úkol uvolnění úlohy nelze zadat bez zadání úkolu přípravy úlohy pro úlohu. Služba Batch spouští úlohu uvolnění úlohy na uzlech, které mají spuštěnou úlohu přípravy úlohy. Primárním účelem úlohy uvolnění úlohy je vrátit změny výpočetních uzlů provedených úkolem přípravy úlohy. Mezi příklady aktivit patří odstranění místních souborů nebo vypnutí služeb, které byly spuštěny v rámci přípravy úlohy.

maxParallelTasks

integer

-1

Maximální počet úkolů, které lze pro úlohu spustit paralelně.
Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadána. Pokud není zadáno, výchozí hodnota je -1, což znamená, že neexistuje žádný limit počtu úkolů, které lze spustit najednou. Po vytvoření můžete aktualizovat maxParallelTasks úlohy pomocí rozhraní API úlohy aktualizace.

metadata

MetadataItem[]

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

networkConfiguration

JobNetworkConfiguration

Konfigurace sítě pro úlohu.

onAllTasksComplete

OnAllTasksComplete

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu.
Všimněte si, že pokud úloha neobsahuje žádné úkoly, považují se všechny úkoly za dokončené. Tato možnost se proto nejčastěji používá s úkolem Správce úloh; Pokud chcete použít automatické ukončení úlohy bez Správce úloh, měli byste nejprve nastavit onAllTasksComplete na noaction a aktualizovat vlastnosti úlohy nastavit onAllTasksComplete ukončitjob po dokončení přidávání úkolů. Výchozí hodnota je noaction.

onTaskFailure

OnTaskFailure

Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze.
Úloha se považuje za neúspěšnou, pokud má informace o selhání. Informace o selhání se nastaví, pokud se úkol dokončí s nenulovým ukončovacím kódem po vyčerpání počtu opakování nebo pokud došlo k chybě při spuštění úlohy, například kvůli chybě při stahování souboru prostředků. Výchozí hodnota je noaction.

poolInfo

PoolInformation

Fond, na kterém služba Batch spouští úlohy.

priority

integer

Priorita úlohy.
Hodnoty priority mohou být v rozsahu od -1000 do 1 000, přičemž -1000 nejnižší prioritou a 1000 nejvyšší prioritou. Výchozí hodnota je 0.

usesTaskDependencies

boolean

Určuje, zda úkoly v úloze mohou definovat závislosti na sobě navzájem. Výchozí hodnota je false.

JobConstraints

Omezení provádění pro úlohu.

Name Typ Description
maxTaskRetryCount

integer

Maximální počet opakování každého ú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í každou ú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 úlohy. Pokud je maximální počet opakování -1, služba Batch opakuje úlohy bez omezení. Výchozí hodnota je 0 (žádné opakování).

maxWallClockTime

string

Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku vytvoření úlohy.
Pokud se úloha nedokončí v rámci časového limitu, služba Batch ji ukončí a všechny úkoly, které jsou stále spuštěné. V tomto případě bude důvodem ukončení MaxWallClockTimeExpiry. Pokud tato vlastnost není zadána, neexistuje žádný časový limit, jak dlouho může úloha běžet.

JobManagerTask

Určuje podrobnosti úlohy správce úloh.

Name Typ Description
allowLowPriorityNode

boolean

Určuje, jestli se úloha Správce úloh může spouštět na výpočetním uzlu s nízkou prioritou.
Výchozí hodnota je true.

applicationPackageReferences

ApplicationPackageReference[]

Seznam balíčků aplikací, které služba Batch nasadí do výpočetního uzlu před spuštěním příkazového řádku.
Balíčky aplikací se stáhnou a nasadí do sdíleného adresáře, ne do pracovního adresáře úlohy. Proto pokud odkazovaný balíček aplikace je již na výpočetním uzlu a je aktuální, pak se znovu nestáhnou; Použije se existující kopie výpočetního uzlu. Pokud odkazovaný balíček aplikace nelze nainstalovat, například protože balíček byl odstraněn nebo protože stahování selhalo, úloha selže.

authenticationTokenSettings

AuthenticationTokenSettings

Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch.
Pokud je tato vlastnost nastavená, služba Batch poskytuje úlohu ověřovací token, který se dá použít k ověřování operací služby Batch, aniž by vyžadovala přístupový klíč účtu. Token se poskytuje prostřednictvím proměnné prostředí AZ_BATCH_AUTHENTICATION_TOKEN. Operace, které může úloha provádět pomocí tokenu, závisí na nastavení. Úkol může například požádat o oprávnění úlohy, aby mohl do úlohy přidat další úkoly, nebo zkontrolovat stav úlohy nebo jiných úkolů v rámci úlohy.

commandLine

string

Příkazový řádek úlohy Správce úloh.
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. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

constraints

TaskConstraints

Omezení, která platí pro úlohu Správce úloh.

containerSettings

TaskContainerSettings

Nastavení kontejneru, pod kterým běží úloha Správce úloh.
Pokud má fond, který bude tuto úlohu spouštět, nastavený kontejnerConfiguration, musí být také nastaven. Pokud fond, který spustí tuto úlohu, nemá nastavenou konfiguraci kontejneru, nesmí být nastavena. 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 v kontejneru se spustí příkazový řádek úkolu. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na hostitelském disku, což znamená, že rozhraní API souborů batch nebudou mít přístup k těmto souborům.

displayName

string

Zobrazovaný název úlohy Správce úloh.
Nemusí být jedinečný a může obsahovat jakékoli znaky Unicode až do maximální délky 1024.

environmentSettings

EnvironmentSetting[]

Seznam nastavení proměnných prostředí pro úlohu Správce úloh.

id

string

Řetězec, který jednoznačně identifikuje úlohu Správce úloh v rámci úlohy.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků.

killJobOnCompletion

boolean

Určuje, zda dokončení úlohy správce úloh označuje dokončení celé úlohy.
Pokud je hodnota true, po dokončení úlohy Správce úloh služba Batch označí úlohu jako dokončenou. Pokud jsou některé úkoly v tuto chvíli stále spuštěné (jiné než verze úlohy), tyto úkoly se ukončí. Pokud je hodnota false, dokončení úlohy správce úloh nemá vliv na stav úlohy. V tomto případě byste buď měli použít atribut onAllTasksComplete k ukončení úlohy, nebo mít klienta nebo uživatele ukončit úlohu explicitně. Příkladem je, že správce úloh vytvoří sadu úkolů, ale pak ve svém provádění nebude provádět žádnou další roli. Výchozí hodnota je true. Pokud používáte atributy onAllTasksComplete a onTaskFailure k řízení životnosti úlohy a použití úlohy správce úloh pouze k vytvoření úkolů pro úlohu (ne monitorování průběhu), je důležité nastavit killJobOnCompletion na false.

outputFiles

OutputFile[]

Seznam souborů, které služba Batch nahraje z výpočetního uzlu po spuštění příkazového řádku
U úloh s více instancemi se soubory nahrají jenom z výpočetního uzlu, na kterém je spuštěn primární úkol.

requiredSlots

integer

Počet slotů plánování, které úloha vyžaduje ke spuštění.
Výchozí hodnota je 1. Úkol je možné naplánovat tak, aby běžel pouze na výpočetním uzlu, pokud má uzel k dispozici dostatek volných slotů plánování. U úloh s více instancemi není tato vlastnost podporována a nesmí být zadána.

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.
Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu. 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í být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru.

runExclusive

boolean

Určuje, jestli úloha Správce úloh vyžaduje výhradní použití výpočetního uzlu, na kterém běží.
Pokud je hodnota true, nebudou se na stejném uzlu spouštět žádné další úkoly, pokud je spuštěný Správce úloh. Pokud je false, můžou ostatní úkoly běžet současně se Správcem úloh na výpočetním uzlu. Úloha Správce úloh se počítá normálně do limitu souběžných úloh výpočetního uzlu, takže to platí jenom v případě, že výpočetní uzel umožňuje více souběžných úloh. Výchozí hodnota je true.

userIdentity

UserIdentity

Identita uživatele, pod kterou se spouští úloha Správce úloh.
Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úlohu jedinečný.

JobNetworkConfiguration

Konfigurace sítě pro úlohu.

Name Typ Description
skipWithdrawFromVNet

boolean

Určuje, jestli se mají výpočetní uzly z virtuální sítě stahovat do DNC při ukončení nebo odstranění úlohy.
Pokud je hodnota true, uzly zůstanou připojené k virtuální síti k DNC. Pokud je false, uzly se automaticky stáhnou, jakmile úloha skončí. Výchozí hodnota je false.

subnetId

string

Identifikátor prostředku ARM podsítě virtuální sítě, ke které výpočetní uzly, na kterých běží úkoly z úlohy, se připojí po dobu trvání úlohy.
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 vyhovovala počtu výpočetních uzlů, které budou spouštět úkoly z úlohy. Může to být až počet výpočetních uzlů ve fondu. 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íť, aby služba Azure Batch mohl plánovat úlohy na 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 je komunikace s uzly v zadané podsíti odepřena skupinou zabezpečení sítě, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Toto je formulář /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Pokud má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG), musí být pro příchozí komunikaci ze služby Azure Batch povolené několik vyhrazených systémových portů. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 a port 22 pro Linux a port 3389 pro Windows. Port 443 je také potřeba otevřít pro odchozí připojení pro komunikaci se službou Azure Storage. Další podrobnosti najdete v tématu: https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

Úkol přípravy úlohy, který se má spustit před všemi úkoly úlohy v libovolném výpočetním uzlu.

Name Typ Description
commandLine

string

Příkazový řádek úkolu přípravy úlohy.
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. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

constraints

TaskConstraints

Omezení, která platí pro úkol přípravy úlohy.

containerSettings

TaskContainerSettings

Nastavení kontejneru, pod kterým se spouští úloha přípravy úlohy.
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 v kontejneru se spustí příkazový řádek úkolu. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na hostitelském disku, což znamená, že rozhraní API souborů batch nebudou mít přístup k těmto souborům.

environmentSettings

EnvironmentSetting[]

Seznam nastavení proměnných prostředí pro úkol přípravy úlohy.

id

string

Řetězec, který jednoznačně identifikuje úkol přípravy úlohy v rámci úlohy.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. Pokud tuto vlastnost nezadáte, služba Batch přiřadí výchozí hodnotu jobpreparation. Žádný jiný úkol v úloze nemůže mít stejné ID jako úkol přípravy úlohy. Pokud se pokusíte odeslat úkol se stejným ID, služba Batch odmítne požadavek s kódem chyby TaskIdSameAsJobPreparationTask; Pokud rozhraní REST API voláte přímo, stavový kód HTTP je 409 (konflikt).

rerunOnNodeRebootAfterSuccess

boolean

Jestli má služba Batch po restartování výpočetního uzlu znovu spustit úlohu přípravy úlohy.
Úkol přípravy úlohy se vždy znovu spustí, pokud je výpočetní uzel zmagí nebo pokud se úkol přípravy úlohy nedokončil (např. restartování proběhlo při spuštění úkolu). Proto byste měli vždy napsat úlohu přípravy úlohy, která má být idempotentní a správně se chovat, pokud se spustí vícekrát. Výchozí hodnota je true.

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.
Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu. 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í být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru.

userIdentity

UserIdentity

Identita uživatele, pod kterou se spouští úloha přípravy úlohy.
Pokud tento parametr vynecháte, úloha se spustí jako uživatel bez oprávnění správce, který je jedinečný pro úlohu na výpočetních uzlech Windows, nebo jako uživatel, který není správcem, který je pro fond na výpočetních uzlech Linuxu jedinečný.

waitForSuccess

boolean

Jestli má služba Batch čekat na úspěšné dokončení úlohy přípravy úlohy před naplánování všech ostatních úkolů úlohy na výpočetním uzlu. Úloha přípravy úlohy se úspěšně dokončila, pokud se ukončí s ukončovacím kódem 0.
Pokud je hodnota true a úloha přípravy úlohy na uzlu selže, služba Batch opakuje úkol přípravy úlohy až do maximálního počtu opakování (jak je uvedeno v elementu omezení). Pokud úloha po všech opakováních ještě nebyla úspěšně dokončena, služba Batch neplánuje úkoly úlohy do uzlu. Uzel zůstává aktivní a má nárok na spouštění úkolů jiných úloh. Pokud je hodnota false, služba Batch nečeká na dokončení úlohy přípravy úlohy. V tomto případě mohou ostatní úkoly úlohy začít spouštět na výpočetním uzlu, zatímco úloha přípravy úlohy je stále spuštěna; a i když úloha přípravy úlohy selže, budou nové úkoly i nadále naplánované na výpočetním uzlu. Výchozí hodnota je true.

JobReleaseTask

Úloha uvolnění úlohy, která se má spustit při dokončení úlohy na libovolném výpočetním uzlu, na kterém je úloha spuštěná.

Name Typ Description
commandLine

string

Příkazový řádek úlohy uvolnění úlohy.
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. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Nastavení kontejneru, pod kterým běží úloha uvolnění úlohy.
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 v kontejneru se spustí příkazový řádek úkolu. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na hostitelském disku, což znamená, že rozhraní API souborů batch nebudou mít přístup k těmto souborům.

environmentSettings

EnvironmentSetting[]

Seznam nastavení proměnných prostředí pro úlohu uvolnění úlohy.

id

string

Řetězec, který jednoznačně identifikuje úlohu uvolnění úlohy v rámci úlohy.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. Pokud tuto vlastnost nezadáte, služba Batch přiřadí výchozí hodnotu jobrelease. Žádný jiný úkol v úloze nemůže mít stejné ID jako úloha uvolnění úlohy. Pokud se pokusíte odeslat úkol se stejným ID, služba Batch odmítne požadavek s kódem chyby TaskIdSameAsJobReleaseTask; Pokud rozhraní REST API voláte přímo, stavový kód HTTP je 409 (konflikt).

maxWallClockTime

string

Maximální uplynulý čas, po který může úloha uvolnění úlohy běžet na daném výpočetním uzlu měřená od okamžiku spuštění úlohy. Pokud se úkol nedokončí v časovém limitu, služba Batch ji ukončí. Výchozí hodnota je 15 minut. Časový limit nesmí být delší než 15 minut. Pokud to uděláte, služba Batch ji odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek).

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í být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru.
Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu.

retentionTime

string

Minimální doba uchování adresáře úloh pro úlohu uvolnění úlohy na výpočetním uzlu. Po této době může služba Batch odstranit adresář úloh a veškerý jeho obsah.
Výchozí hodnota je 7 dní, tj. adresář úloh se zachovají po dobu 7 dnů, pokud se neodebere výpočetní uzel nebo se úloha odstraní.

userIdentity

UserIdentity

Identita uživatele, pod kterou se spouští úloha uvolnění úlohy.
Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úlohu jedinečný.

LinuxUserConfiguration

Vlastnosti používané 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 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 výpočetními 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í zadaný, není mezi výpočetními uzly nakonfigurovaný protokol SSH bez hesla (není proveden žádný zásah do 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. Řízení uživatelských účtů je povolené ve fondech Windows. Pokud se tato možnost používá se zvýšenou identitou uživatele ve fondu Windows, relace uživatele nebude zvýšena, pokud není aplikace spuštěná příkazovým řádkem úlohy nakonfigurovaná 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
securityProfile

VMDiskSecurityProfile

Určuje nastavení profilu zabezpečení pro spravovaný disk.
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 vyžadovat ji 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 Description
dynamicVNetAssignmentScope

DynamicVNetAssignmentScope

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 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 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 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 je komunikace s uzly v zadané podsíti odepřena skupinou zabezpečení sítě, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Podporují se jenom virtuální sítě ARM (Microsoft.Network/virtualNetworks). Pokud má zadaná virtuální síť přidružené nějaké skupiny zabezpečení sítě (NSG), musí být pro příchozí komunikaci povoleno několik vyhrazených systémových portů. Povolte porty 29876 a 29877 a také port 22 pro Linux a port 3389 pro Windows. Povolte také odchozí připojení ke službě Azure Storage na portu 443. Další podrobnosti najdete v tématu: https://docs.microsoft.com/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), konkrétní port (tj. 22) nebo rozsah portů (tj. 100–200). Porty musí být v rozsahu 0 až 65535. Každá položka v této kolekci nesmí překrývat žádnou jinou položku (buď rozsah, nebo jednotlivý port). Pokud jsou zadány jakékoli jiné 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ž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 fond

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 dostupnosti s vyrovnáváním maximálního úsilí.

OnAllTasksComplete

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu.

Name Typ Description
noaction

string

Nic nedělejte. Úloha zůstane aktivní, pokud není ukončena nebo zakázána jinými prostředky.

terminatejob

string

Ukončete úlohu. Funkce terminateReason je nastavená na AllTasksComplete.

OnTaskFailure

Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze.

Name Typ Description
noaction

string

Nic nedělejte. Úloha zůstane aktivní, pokud není ukončena nebo zakázána jinými prostředky.

performexitoptionsjobaction

string

Proveďte akci přidruženou k podmínce ukončení úlohy v kolekci ExitConditions úlohy. (To může vést k tomu, že se neprovedou žádné akce, pokud to určuje úkol.)

OSDisk

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

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.
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 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 (VM).

managedDisk

ManagedDisk

Parametry spravovaného disku.

writeAcceleratorEnabled

boolean

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

OutputFile

Specifikace pro nahrání souborů z výpočetního uzlu Služby Azure Batch do jiného umístění po dokončení provádění procesu úlohy

Name Typ Description
destination

OutputFileDestination

Cíl výstupních souborů

filePattern

string

Vzor označující, které soubory se mají nahrát.
Podporují se relativní i absolutní cesty. Relativní cesty jsou relativní vzhledem k pracovnímu adresáři úkolu. Podporují se následující zástupné znaky: * odpovídá 0 nebo více znakům (například vzor abc* by odpovídal abc nebo abcdef), ** odpovídá libovolnému adresáři? odpovídá jakémukoli jednomu znaku , [abc] odpovídá jednomu znaku v závorkách a [a-c] odpovídá jednomu znaku v oblasti. Hranaté závorky můžou obsahovat negaci odpovídající libovolnému znaku, který není zadaný (například [!abc] odpovídá libovolnému znaku, ale znaku b nebo c). Pokud název souboru začíná na "" je ve výchozím nastavení ignorován, ale může se shodovat zadáním explicitně (například .gif se neshoduje s .a.gif, ale.gif bude). Jednoduchý příklad: ***.txt odpovídá libovolnému souboru, který se nespustí v "." a končí .txt v pracovním adresáři úkolu nebo v libovolném podadresáři. Pokud název souboru obsahuje zástupný znak, může být řídicí znak pomocí závorek (například abc[] by odpovídal souboru s názvem abc). Všimněte si, že \ a / jsou považovány za oddělovače adresářů ve Windows, ale pouze / je v Linuxu. Proměnné prostředí (%var% ve Windows nebo $var v Linuxu) se před použitím vzoru rozbalí.

uploadOptions

OutputFileUploadOptions

Další možnosti operace nahrávání, včetně toho, za jakých podmínek se má nahrávání provést.

OutputFileBlobContainerDestination

Určuje cíl nahrání souboru v kontejneru úložiště objektů blob v Azure.

Name Typ Description
containerUrl

string

Adresa URL kontejneru ve službě Azure Blob Storage, do které se mají nahrát soubory.
Pokud nepoužíváte spravovanou identitu, musí adresa URL obsahovat sdílený přístupový podpis (SAS), který kontejneru uděluje oprávnění k zápisu.

identityReference

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup ke službě Azure Blob Storage určenou pomocí containerUrl
Identita musí mít přístup k zápisu do kontejneru Azure Blob Storage.

path

string

Cílový objekt blob nebo virtuální adresář v rámci kontejneru Azure Storage.
Pokud filePattern odkazuje na určitý soubor (tj. neobsahuje žádné zástupné cardy), cesta je název objektu blob, do kterého chcete tento soubor nahrát. Pokud filePattern obsahuje jeden nebo více zástupných znaků (a proto může odpovídat více souborům), pak cesta je název virtuálního adresáře objektu blob (který je před každým názvem objektu blob), do kterého se mají nahrát soubory. Pokud tento parametr vynecháte, soubory se nahrají do kořenového adresáře kontejneru s názvem objektu blob, který odpovídá názvu souboru.

uploadHeaders

HttpHeader[]

Seznam párů název-hodnota pro hlavičky, které se mají použít při nahrávání výstupních souborů
Tyto hlavičky se zadají při nahrávání souborů do Azure Storage. Oficiální dokument o povolených hlavičkách při nahrávání objektů blob: https://docs.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Cíl, do kterého se má soubor nahrát.

Name Typ Description
container

OutputFileBlobContainerDestination

Umístění v úložišti objektů blob v Azure, do kterého se soubory nahrají.

OutputFileUploadCondition

Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů.

Name Typ Description
taskcompletion

string

Po ukončení procesu úkolu nahrajte soubory bez ohledu na to, co byl ukončovací kód.

taskfailure

string

Nahrajte soubory až po ukončení procesu úkolu s nenulovým ukončovacím kódem.

tasksuccess

string

Nahrajte soubory až po ukončení procesu úkolu s ukončovacím kódem 0.

OutputFileUploadOptions

Podrobnosti o operaci nahrávání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést.

Name Typ Description
uploadCondition

OutputFileUploadCondition

Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů.
Výchozí hodnota je dokončení úkolu.

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 adresování konkrétních portů na jednotlivých výpočetních uzlech externě.
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.

PoolInformation

Určuje, jak se má úloha přiřadit k fondu.

Name Typ Description
autoPoolSpecification

AutoPoolSpecification

Charakteristiky dočasného "automatického fondu". Služba Batch vytvoří tento automatický fond při odeslání úlohy.
Pokud automatické vytváření fondu selže, služba Batch přesune úlohu do dokončeného stavu a chyba vytvoření fondu se nastaví ve vlastnosti chyby plánování úlohy. Služba Batch spravuje dobu života (vytvoření i pokud není zadána možnost keepAlive, odstranění) automatického fondu. Všechny akce uživatele, které ovlivňují dobu života automatického fondu, když je úloha aktivní, způsobí neočekávané chování. Musíte zadat BUĎ ID fondu, nebo specifikaci automatického fondu, ale ne obojí.

poolId

string

ID existujícího fondu. Všechny úkoly úlohy budou spuštěny v zadaném fondu.
Musíte zajistit, aby fond odkazovaný touto vlastností existoval. Pokud fond v době, kdy se služba Batch pokusí naplánovat úlohu, nebudou spuštěny žádné úkoly pro úlohu, dokud nevytváříte fond s tímto ID. Všimněte si, že služba Batch neodmítne žádost o úlohu; Úkoly se jednoduše nespustí, dokud fond neexistuje. Musíte zadat BUĎ ID fondu, nebo specifikaci automatického fondu, ale ne obojí.

PoolLifetimeOption

Minimální životnost vytvořených automatických fondů a způsob přiřazení více úloh podle plánu fondům.

Name Typ Description
job

string

Fond existuje po celou dobu životnosti úlohy, pro kterou je vyhrazená. Služba Batch vytvoří fond při vytváření úlohy. Pokud se u plánu úlohy použije možnost Úloha, služba Batch vytvoří nový automatický fond pro každou úlohu vytvořenou v plánu.

jobschedule

string

Fond existuje po celou dobu životnosti plánu úlohy. Služba Batch vytvoří fond, když v plánu vytvoří první úlohu. Tuto možnost můžete použít jenom pro plány úloh, ne pro úlohy.

PoolSpecification

Specifikace pro vytvoření nového fondu

Name Typ Description
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 připojující se k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo znovu nezomagí. V každém daném fondu je maximálně 10 odkazů na balíček.

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 delší než 168 hodin, služba Batch odmítne požadavek s chybou neplatné hodnoty vlastnosti; Pokud voláte přímo rozhraní REST API, 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 enableAutoScale nastavena na false. Vyžaduje se, pokud je možnost enableAutoScale nastavená na hodnotu true. Vzorec se před vytvořením fondu zkontroluje, jestli je platnost platná. Pokud vzorec není platný, služba Batch žádost odmítne s podrobnými informacemi o chybě.

certificateReferences

CertificateReference[]

Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu.
Pro uzly Systému Windows služba Batch nainstaluje certifikáty do zadaného úložiště certifikátů a umístění. Pro výpočetní uzly s Linuxem jsou certifikáty uložené v adresáři v pracovním adresáři úlohy a proměnné prostředí, AZ_BATCH_CERTIFICATES_DIR je zadána do úlohy, která se má dotazovat na toto umístění. Pro certifikáty s viditelností remoteUser se vytvoří adresář certs v domovském adresáři uživatele (např. /home/{uživatelské jméno}/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.

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.

enableAutoScale

boolean

Určuje, jestli se velikost fondu má v průběhu času automaticky upravit.
Pokud je false, musí být zadán nejméně jeden z targetDedicatedNodes a targetLowPriorityNodes. Pokud je true, je povinný prvek autoScaleFormula. Fond automaticky změní velikost podle vzorce. Výchozí hodnota je false.

enableInterNodeCommunication

boolean

Určuje, jestli fond povoluje 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.

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.

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.

networkConfiguration

NetworkConfiguration

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

resizeTimeout

string

Časový limit přidělení výpočetních uzlů do fondu.
Tento časový limit platí pouze pro ruční škálování; Nemá žádný účinek, pokud je enableAutoScale nastavena na hodnotu true. Výchozí hodnota je 15 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).

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.

startTask

StartTask

Úkol, který se má spustit na každém výpočetním uzlu, když se připojí 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.
Služba Batch bude opakovat úlohy, když se na uzlu aktivuje operace obnovení. Příklady operací obnovení zahrnují (ale nejsou omezené) při restartování uzlu, který není v pořádku, nebo výpočetní uzel zmizel kvůli selhání hostitele. Opakované pokusy z důvodu operací obnovení jsou nezávislé na hodnotě maxTaskRetryCount a nezapočítávají se do hodnoty maxTaskRetryCount. I když je hodnota maxTaskRetryCount 0, může dojít k internímu opakování kvůli operaci obnovení. Z tohoto důvodu by všechny úkoly měly být idempotentní. To znamená, že úkoly musí tolerovat přerušení a restartování, aniž by to způsobilo poškození nebo duplicitní data. Osvědčeným postupem pro dlouhotrvající úlohy je použití určité formy vytváření kontrolních bodů. V některých případech se startTask může znovu spustit, i když se výpočetní uzel nerestartoval. Je potřeba věnovat zvláštní pozornost tomu, aby se zabránilo spuštění startTasks, které vytvářejí odrušovací proces nebo instalují nebo spouštějí služby z pracovního adresáře StartTask, protože to službě Batch znemožní opětovné spuštění StartTask.

targetDedicatedNodes

integer

Požadovaný počet vyhrazených výpočetních uzlů ve fondu.
Tato vlastnost nesmí být zadána, pokud je enableAutoScale nastavena na hodnotu true. Pokud je enableAutoScale nastavena na false, musíte nastavit buď targetDedicatedNodes, targetLowPriorityNodes, nebo obojí.

targetLowPriorityNodes

integer

Požadovaný počet výpočetních uzlů s nízkou prioritou ve fondu
Tato vlastnost nesmí být zadána, pokud je enableAutoScale nastavena na hodnotu true. Pokud je enableAutoScale nastavena na false, musíte nastavit buď targetDedicatedNodes, targetLowPriorityNodes, nebo obojí.

targetNodeCommunicationMode

NodeCommunicationMode

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

taskSchedulingPolicy

TaskSchedulingPolicy

Jak se úkoly distribuují mezi výpočetní uzly ve fondu.
Pokud není zadáno, výchozí hodnota se rozloží.

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.

upgradePolicy

UpgradePolicy

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

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 musí být zadána.

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čů ve fondech najdete v tématu Volba velikosti virtuálního počítače pro výpočetní uzly ve fondu služby Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

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 nebo nízkou prioritou, které 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.

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 výpočetního uzlu Windows. Pokud tato vlastnost není zadána pro výpočetní 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 stáhnout soubory vzhledem k pracovnímu adresáři úlohy.
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 rozdělit 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. 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

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: Je možné ji nastavit jenom 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
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. Další informace o šifrování v požadavcích na hostitele najdete v tématu https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes.

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í uzlu k fondu ve službě Azure Batch nebo při restartování nebo obnovení výpočetního uzlu.

Name Typ Description
commandLine

string

Příkazový řádek StartTask.
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. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Nastavení kontejneru, pod kterým běží StartTask.
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 v kontejneru se spustí příkazový řádek úkolu. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na hostitelském disku, což znamená, že rozhraní API souborů batch nebudou mít přístup k těmto souborům.

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 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 nezopakuje úlohu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné 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í být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru.
Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu.

userIdentity

UserIdentity

Identita uživatele, pod kterou se spouští StartTask.
Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úlohu jedinečný.

waitForSuccess

boolean

Jestli má služba Batch čekat na úspěšné dokončení startTask (tj. ukončit s ukončovacím kódem 0) před naplánování všech úkolů na výpočetním uzlu.
Pokud hodnota true a StartTask selže na uzlu, služba Batch opakuje hodnotu StartTask 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čí nepoužitelný uzel a nenaplánuje do něj úkoly. Tuto podmínku lze zjistit prostřednictvím podrobností o stavu výpočetního uzlu a informacích o selhání. Pokud je false, služba Batch nebude čekat na dokončení startTask. V tomto případě se na výpočetním uzlu můžou spustit jiné úlohy, zatímco startTask je stále spuštěný; a i když startTask selže, budou nové úlohy i nadále naplánované 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 místně redundantní úložiště úrovně Standard.

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.

TaskConstraints

Omezení provádění, která se mají použít pro úlohu.

Name Typ Description
maxTaskRetryCount

integer

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í spustitelného souboru úlohy kvůli nenulovém ukončovacímu kódu. 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 po prvním pokusu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné opakování).

maxWallClockTime

string

Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku spuštění úlohy. Pokud se úkol nedokončí v časovém limitu, služba Batch ji ukončí.
Pokud není zadaný, neexistuje žádný časový limit, jak dlouho může úloha běžet.

retentionTime

string

Minimální doba uchovávání adresáře úloh na výpočetním uzlu, na kterém byl spuštěný, od okamžiku dokončení provádění. Po této době může služba Batch odstranit adresář úloh a veškerý jeho obsah.
Výchozí hodnota je 7 dní, tj. adresář úloh se zachovají po dobu 7 dnů, pokud se neodebere výpočetní uzel nebo se úloha odstraní.

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 k "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 už bylo k dispozici při vytváření fondu.

workingDirectory

ContainerWorkingDirectory

Umístění pracovního adresáře úlohy 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

Jak se úkoly distribuují mezi výpočetní uzly ve fondu.
Pokud není zadáno, výchozí hodnota se rozloží.

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žívané k vytvoření uživatele, který se používá ke spouštění úkolů na výpočetním uzlu služby Azure Batch.

Name Typ Description
elevationLevel

ElevationLevel

Úroveň zvýšení úrovně uživatelského účtu.
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

Jméno 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 jednu, ale ne obě.

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 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 výpočetním uzlu ve fondu, aby se úlohy mohly spouštět v kontejnerech. Všechny běžné úkoly 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. 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 odstraní také disk a všechna data přidružená k němu. Disk není po připojení formátován, musí být před použitím formátován – další informace naleznete v tématu https://docs.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux a https://docs.microsoft.com/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.
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.
To platí jenom pro image, které obsahují operační systém Windows, a měly by se používat jenom v případě, že uchováváte platné místní licence pro výpočetní uzly, které se nasadí. 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 výpočetního uzlu 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í příkazového a řídicího rozhraní mezi výpočetním uzlem a službou Batch. Existují různé implementace agenta výpočetního uzlu, označovaného jako SKU, 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ích uzlů spolu s jejich seznamem ověřených odkazů na image, podívejte se na operaci Výpis podporovaných skladových položek agenta výpočetních uzlů.

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.

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 vlastnost 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 vyžadovat ji 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: Je možné ji nastavit jenom 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čů.

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žívané 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 je batch.