Jobs - Replace Job

Aktualizuje vlastnosti zadané práce.
Tím se plně nahrazují všechny aktualizovatelné vlastnosti Jobu. Například pokud má úloha přiřazená omezení a pokud tato omezení nejsou specifikována tímto požadavkem, pak dávková služba odstraní stávající omezení.

PUT {endpoint}/jobs/{jobId}?api-version=2025-06-01
PUT {endpoint}/jobs/{jobId}?api-version=2025-06-01&timeOut={timeOut}

Parametry identifikátoru URI

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

string (uri)

Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).

jobId
path True

string

ID práce, jejíž vlastnosti chcete aktualizovat.

api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

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

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-rfc7231)

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

If-Modified-Since

string (date-time-rfc7231)

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

If-Unmodified-Since

string (date-time-rfc7231)

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

If-Match

string

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

If-None-Match

string

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

Text požadavku

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

Name Vyžadováno Typ Description
poolInfo True

BatchPoolInfo

Nastavení fondu přidružené k úloze.

allowTaskPreemption

boolean

Určuje, zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou. (Tato vlastnost není ve výchozím nastavení dostupná. Pro více informací kontaktujte podporu) Pokud je hodnota nastavena na True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moci znovu zařadit úlohy z této úlohy. Po vytvoření pomocí rozhraní API úlohy aktualizace můžete aktualizovat funkci allowTaskPreemption.

constraints

BatchJobConstraints

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

maxParallelTasks

integer (int32)

Maximální počet úkolů, které lze pro úlohu spustit paralelně. (Tato vlastnost není ve výchozím nastavení dostupná. Další informace vám poskytne podpora) Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadaná. 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

BatchMetadataItem[]

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.

onAllTasksComplete

BatchAllTasksCompleteMode

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. Výchozí hodnota je noaction.

priority

integer (int32)

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.

Odpovědi

Name Typ Description
200 OK

Požadavek byl úspěšný.

Hlavičky

  • DataServiceId: string
  • ETag: string
  • Last-Modified: string
  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

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

Rozsahy

Name Description
https://batch.core.windows.net//.default

Příklady

Job patch

Ukázkový požadavek

PUT {endpoint}/jobs/jobId?api-version=2025-06-01



{
  "priority": 100,
  "constraints": {
    "maxWallClockTime": "PT1H",
    "maxTaskRetryCount": -1
  },
  "poolInfo": {
    "poolId": "poolId"
  }
}

Ukázková odpověď

Definice

Name Description
AutomaticOsUpgradePolicy

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

AutoUserScope

AutoUserScope enums

AutoUserSpecification

Specifikuje možnosti pro automatického uživatele, který spouští Azure Batch Task.

AzureBlobFileSystemConfiguration

Informace použité pro připojení k Azure Storage Container pomocí Blobfuse.

AzureFileShareConfiguration

Informace používané pro připojení k Azure Fileshare.

BatchAllTasksCompleteMode

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

BatchApplicationPackageReference

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

BatchAutoPoolSpecification

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

BatchContainerConfiguration

Konfigurace pro fondy s podporou kontejneru.

BatchDiffDiskSettings

Určuje dočasné nastavení disku pro disk operačního systému používaný výpočetním uzlem (VM).

BatchError

Chybová odpověď přijatá ze služby Azure Batch.

BatchErrorDetail

Další informace zahrnutá v odpovědi na chybu v Azure Batch.

BatchErrorMessage

Chybová zpráva přijatá v odpovědi na chybu v Azure Batch.

BatchErrorSourceCategory

BatchErrorSourceCategory enumy

BatchInboundNatPool

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.

BatchJob

An Azure Batch Job.

BatchJobConstraints

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

BatchJobDefaultOrder

BatchJobDefaultOrder enumy

BatchJobExecutionInfo

Obsahuje informace o spuštění úlohy v Azure Batch službě.

BatchJobManagerTask

Určuje podrobnosti úlohy správce úloh. Úloha Správce úloh se automaticky spustí při vytvoření úlohy. Služba Batch se pokusí naplánovat úlohu Správce úloh před všemi ostatními úkoly v úloze. Při zmenšování fondu se služba Batch pokusí zachovat uzly, ve kterých běží úkoly Správce úloh co nejdéle (to znamená, že výpočetní uzly se spuštěnými "normální" úkoly se odeberou před výpočetními uzly, na kterých běží úkoly Správce úloh). Pokud úloha Správce úloh selže a je třeba ji restartovat, systém se pokusí naplánovat ji s nejvyšší prioritou. Pokud nejsou dostupné žádné nečinné výpočetní uzly, může systém ukončit některý ze spuštěných úkolů ve fondu a vrátit ho do fronty, aby se uvolnilo místo pro restartování úlohy Správce úloh. Všimněte si, že úkol Správce úloh v jedné úloze nemá prioritu oproti úkolům v jiných úlohách. V rámci úloh se pozorují pouze priority na úrovni úlohy. Například pokud je třeba restartovat správce úloh v prioritě 0 Úloha, nepřesune úkoly priority 1 Úloha. 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ů.

BatchJobNetworkConfiguration

(Tato vlastnost není ve výchozím nastavení dostupná. Pro více informací kontaktujte podporu) Síťová konfigurace pro úlohu.

BatchJobPreparationTask

Úkol přípravy úlohy, který se má spustit před všemi úkoly úlohy v libovolném výpočetním uzlu. Přípravu úlohy můžete použít k přípravě uzlu na spouštění úkolů pro úlohu. Mezi aktivity běžně prováděné při přípravě úlohy patří: Stahování běžných souborů prostředků používaných všemi úkoly v úloze. Úkol přípravy úlohy může stáhnout tyto běžné soubory prostředků do sdíleného umístění v uzlu. (AZ_BATCH_NODE_ROOT_DIR\shared) nebo spuštění místní služby na uzlu, aby s ní mohly komunikovat všechny úlohy. Pokud úloha přípravy úlohy selže (tj. vyčerpá její počet opakování před ukončením s ukončovacím kódem 0), služba Batch nespustí úkoly této úlohy na uzlu. Výpočetní uzel zůstává způsobilý ke spouštění úkolů této úlohy, dokud nebude znovu zmagován. Výpočetní uzel zůstane aktivní a dá se použít pro jiné úlohy. Úkol přípravy úlohy může běžet vícekrát na stejném uzlu. Proto byste měli napsat úlohu přípravy úlohy pro zpracování opětovného spuštění. Pokud se uzel restartuje, úloha přípravy úlohy se před plánováním jakékoli jiné úlohy úlohy spustí znovu na výpočetním uzlu, pokud je true znovu spustitOnNodeRebootAfterSuccess nebo pokud úloha přípravy úlohy nebyla dokončena dříve. Pokud je uzel znovu zmagován, úloha přípravy úlohy se spustí znovu před naplánování libovolného úkolu úlohy. 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ů.

BatchJobReleaseTask

Ú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á. Úloha uvolnění úlohy se spustí, když úloha skončí, z důvodu jedné z následujících možností: Uživatel zavolá rozhraní API pro ukončení úlohy nebo rozhraní API úlohy delete, zatímco úloha je stále aktivní, dosáhne se maximálního časového omezení doby trvání úlohy a úloha je stále aktivní nebo úloha správce úloh je dokončena a úloha je nakonfigurována tak, aby se ukončila po dokončení správce úloh. Úloha uvolnění úlohy běží na každém uzlu, kde jsou spuštěné úkoly úlohy, a úloha přípravy úlohy byla spuštěna a dokončena. Pokud uzel znovu naimajete po spuštění úkolu přípravy úlohy a úloha skončí bez jakýchkoli dalších úkolů úlohy spuštěné na daném uzlu (a proto se úloha přípravy úlohy znovu nespustí), úloha uvolnění úlohy se na daném výpočetním uzlu nespustí. Pokud se uzel restartuje, zatímco úloha uvolnění úlohy je stále spuštěná, úloha uvolnění úlohy se spustí znovu při spuštění výpočetního uzlu. Úloha není označena jako dokončená, dokud se nedokončily všechny úkoly uvolnění úlohy. Úloha uvolnění úlohy se spouští na pozadí. Nezabývá plánovací slot; to znamená, že se nezapočítává do limitu taskSlotsPerNode zadaného ve fondu.

BatchJobSchedulingError

Při plánování úlohy došlo u služby Batch k chybě.

BatchJobState

BatchJobState enums

BatchJobStatistics

Statistika využití prostředků pro úlohu

BatchMetadataItem

Služba Batch nepřiřazuje k tomuto metadatu žádný význam; je výhradně pro použití uživatelského kódu.

BatchNodeFillType

Enumy BatchNodeFillType

BatchNodeIdentityReference

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

BatchNodePlacementConfiguration

Pro místní umístění budou uzly ve fondu přiděleny ve stejné oblasti. V případě zónového umístění budou uzly ve fondu rozloženy mezi různé zóny s vyrovnáváním maximálního úsilí.

BatchNodePlacementPolicyType

BatchNodePlacementPolicyType enumy

BatchOsDisk

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

BatchPoolEndpointConfiguration

Konfigurace koncového bodu pro fond.

BatchPoolIdentityReference

Odkaz na jednu z identit fondu pro šifrování disku. Tato identita se použije pro přístup k trezoru klíčů.

BatchPoolInfo

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

BatchPoolLifetimeOption

Enums BatchPoolLifetimeOption

BatchPoolSpecification

Specifikace pro vytvoření nového fondu

BatchPublicIpAddressConfiguration

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

BatchStartTask

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.

BatchTaskConstraints

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

BatchTaskContainerSettings

Nastavení kontejneru pro úlohu.

BatchTaskFailureMode

Enumy TaskFailure

BatchTaskSchedulingPolicy

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

BatchUefiSettings

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.

BatchVmDiskSecurityProfile

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

BatchVmImageReference

Odkaz na obrázek z Azure Virtual Machines Marketplace nebo na obraz Azure Compute Gallery. Pro ověření seznamu všech odkazů na obrázky v Azure Marketplace od Azure Batch se podívejte na operaci 'List Supported Images'.

CachingType

CachingType enums

CifsMountConfiguration

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

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.

ContainerRegistryReference

Privátní registr kontejneru.

ContainerType

ContainerType enums

ContainerWorkingDirectory

ContainerWorkingDirectory enums

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

Specifikuje dočasné umístění disku operačního systému pro všechny výpočetní uzly (VM) v poolu. Tuto vlastnost může uživatel v požadavku použít k výběru umístění, ve kterém má být operační systém. Například místo na disku mezipaměti pro dočasné zřizování disku s operačním systémem. Pro více informací o požadavcích na velikost disku Ephemeral OS prosím viz požadavky na velikost disku Ephemeral OS pro Windows VM na https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a Linux VM na https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

DiskCustomerManagedKey

Odkaz na klíč spravovaný zákazníkem pro šifrování disku.

DiskEncryptionConfiguration

Konfigurace šifrování disku použitá na výpočetní uzly ve fondu. Konfigurace šifrování disku není podporována v Linux poolu vytvořeném pomocí Azure Compute Gallery Image.

DiskEncryptionSetParameters

ID prostředku ARM sady šifrování disku.

DiskEncryptionTarget

Enums DiskEncryptionTarget

DynamicVNetAssignmentScope

DynamicVNetAssignmentScope enums

ElevationLevel

Enumy ElevationLevel

EnvironmentSetting

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

HostEndpointSettings

Určuje konkrétní nastavení koncového bodu hostitele.

HostEndpointSettingsModeTypes

Enumy HostEndpointSettingsModeTypes

InboundEndpointProtocol

Enums InboundEndpointProtocol

IpAddressProvisioningType

IPAddressProvisioningType enums

IPFamily

Rodiny IP adres používané k určení verzí IP dostupných pro fond.

IPTag

Obsahuje značku IP přidruženou k veřejné IP adrese.

LinuxUserConfiguration

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

LoginMode

LoginMode enums

ManagedDisk

Parametry spravovaného disku.

MountConfiguration

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

NameValuePair

Představuje dvojici název-hodnota.

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

Enums NetworkSecurityGroupRuleAccess

NfsMountConfiguration

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

OutputFile

Při každém nahrání souboru služba Batch zapíše do výpočetního uzlu dva soubory protokolu,fileuploadout.txtafileuploaderr.txt. Tyto soubory protokolu slouží k získání dalších informací o konkrétním selhání.

OutputFileBlobContainerDestination

Specifikuje cíl pro nahrání souboru v rámci Azure blob storage kontejneru.

OutputFileDestination

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

OutputFileUploadCondition

OutputFileUploadCondition enums

OutputFileUploadConfig

Možnosti operace nahrání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést.

OutputFileUploadHeader

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

ProxyAgentSettings

Určuje nastavení proxyagentu při vytváření virtuálního počítače.

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

Enumy SecurityEncryptionTypes

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.

StorageAccountType

Výčty StorageAccountType

UpgradeMode

UpgradeMode enumy

UpgradePolicy

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

UserAccount

Vlastnosti používané k vytvoření uživatele používaného k provádění úloh na Azure Batch Compute Node.

UserIdentity

Definice identity uživatele, pod kterou je úloha spuštěna. Zadejte vlastnost userName nebo autoUser, ale ne obojí.

VirtualMachineConfiguration

Konfigurace pro Compute Nodes v poolu založeném na infrastruktuře Azure Virtual Machines.

VMExtension

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

WindowsConfiguration

Nastavení operačního systému Windows, které se aplikují na virtuální stroj.

WindowsUserConfiguration

Vlastnosti používané k vytvoření uživatelského účtu na Windows Compute Node.

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 toto nastaveno jako true pro Windows pooly, WindowsConfiguration.enableAutomaticUpdates nelze nastavit na 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.

AutoUserScope

AutoUserScope enums

Hodnota Description
task

Specifikuje, že služba by měla vytvořit nového uživatele pro úkol.

pool

Specifikuje, že úkol běží jako společný automatický uživatelský účet, který je vytvořen na každém výpočetním uzlu v poolu.

AutoUserSpecification

Specifikuje možnosti pro automatického uživatele, který spouští Azure Batch Task.

Name Typ Description
elevationLevel

ElevationLevel

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

scope

AutoUserScope

Obor pro automatického uživatele. Výchozí hodnota je fond. Pokud je v poolu běžen Windows, měla by být zadána hodnota Task, pokud je potřeba přísnější izolace mezi úkoly. Například pokud úloha zmutuje registr způsobem, který by mohl mít vliv na jiné úlohy.

AzureBlobFileSystemConfiguration

Informace použité pro připojení k Azure Storage Container pomocí Blobfuse.

Name Typ Description
accountKey

string (password)

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

accountName

string

Název účtu Azure Storage.

blobfuseOptions

string

Další možnostipříkazového Jsou to možnosti "síťového využití" ve Windows a "připojit" v Linuxu.

containerName

string

Název kontejneru Azure Blob Storage.

identityReference

BatchNodeIdentityReference

Odkaz na uživatelem přiřazenou identitu pro přístup k containerName. 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 bude souborový systém připojen. 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 (password)

Azure Storage SAS token. 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í k Azure Fileshare.

Name Typ Description
accountKey

string (password)

Klíč účtu Azure Storage.

accountName

string

Název účtu Azure Storage.

azureFileUrl

string (uri)

URL Azure Files. Toto je formulář "https://{account}.file.core.windows.net/".

mountOptions

string

Další možnostipříkazového Jsou to možnosti "síťového využití" ve Windows a "připojit" v Linuxu.

relativeMountPath

string

Relativní cesta na výpočetním uzlu, kde bude souborový systém připojen. 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.

BatchAllTasksCompleteMode

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

Hodnota Description
noaction

Neprovádět žádnou akci. Práce zůstává aktivní, pokud není propuštěna nebo neaktivována jiným způsobem.

terminatejob

Ukončit práci. Důvod ukončení úkolu je nastaven na 'AllTasksComplete'.

BatchApplicationPackageReference

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

Name Typ Description
applicationId

string

ID aplikace, kterou má nasadit. Při vytváření poolu 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 je tento požadavek v Poolu vynechán a pro tuto aplikaci není určena výchozí verze, požadavek selže s chybovým kódem InvalidApplicationPackageReferences a HTTP stavovým kódem 409. Pokud je tato funkce v úlohe vynechána a není pro tuto aplikaci určena výchozí verze, úloha selže s chybou při předzpracování.

BatchAutoPoolSpecification

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

Prefix, který se přidává k jedinečnému identifikátoru při automatickém vytvoření Poolu. Batch služba při vytvoření přiděluje každému automatickému poolu jedinečný identifikátor. Pro rozlišení poolů vytvořených pro různé účely můžete tento prvek nastavit tak, aby přidal prefix k přiřazenému ID. Prefix může mít až 20 znaků.

keepAlive

boolean

Zda udržet auto pool naživu i po uplynutí jeho životnosti. Pokud je to nepravda, služba Batch smaže Pool po vypršení jeho životnosti (určeného nastavením poolLifetimeOption); tedy když se Job nebo Job Schedule dokončí. Pokud je to pravda, služba Batch automaticky Pool nesmaže. Je na uživateli, aby smazal automatické pooly vytvořené touto možností.

pool

BatchPoolSpecification

Specifikace Pool pro automatický Pool.

poolLifetimeOption

BatchPoolLifetimeOption

Minimální životnost vytvořených automatických poolů a způsob, jakým je více pracovních míst v plánu přiřazeno poolům.

BatchContainerConfiguration

Konfigurace pro fondy s podporou kontejneru.

Name Typ Description
containerImageNames

string[]

Sbírka názvů obrázků kontejnerů. Toto je úplná reference na Image, jak by bylo specifikováno pro "docker pull". Obrázek bude získán z výchozího registru Dockeru, pokud není plně kvalifikovaný s alternativním registrem.

containerRegistries

ContainerRegistryReference[]

Další privátní registry, ze kterých je možné načíst kontejnery. Pokud je nutné stáhnout nějaké obrázky z privátního registru, který vyžaduje přihlašovací údaje, musí být tyto přihlašovací údaje zde uvedeny.

type

ContainerType

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

BatchDiffDiskSettings

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. Pro více informací o požadavcích na velikost disku Ephemeral OS prosím viz požadavky na velikost disku Ephemeral OS pro Windows VM na https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a Linux VM na https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

BatchError

Chybová odpověď 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

BatchErrorMessage

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

Další informace zahrnutá v odpovědi na chybu v 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.

BatchErrorMessage

Chybová zpráva přijatá v odpovědi na chybu v Azure Batch.

Name Typ Description
lang

string

Jazykový kód chybové zprávy.

value

string

Text zprávy.

BatchErrorSourceCategory

BatchErrorSourceCategory enumy

Hodnota Description
usererror

Chyba je způsobena uživatelským problémem, například špatnou konfigurací.

servererror

Chyba je způsobena interním serverovým problémem.

BatchInboundNatPool

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 (int32)

Číslo portu na Compute Node. To musí být v rámci dávkového poolu jedinečné. Přijatelné hodnoty jsou mezi 1 a 65535 s výjimkou 29876 a 29877, protože jsou rezervované. Pokud jsou zadaná nějaká rezervovaná hodnota, požadavek selže se stavovým kódem HTTP 400.

frontendPortRangeEnd

integer (int32)

Poslední číslo portu v rozsahu externích portů, které budou použity k zajištění příchozího přístupu k backendPortu na jednotlivých Compute Nodes. 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 Poolu musí být odlišné a nesmí se překrývat. Každá střelnice 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 (int32)

První číslo portu v řadě externích portů, které budou použity k zajištění příchozího přístupu k backendPort na jednotlivých Compute Nodes. 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 Poolu musí být odlišné a nesmí se překrývat. Každá střelnice 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 Batch Poolu, může obsahovat písmena, čísla, 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 specifikovat napříč všemi koncovými body dávkového poolu, 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.

BatchJob

An Azure Batch Job.

Name Typ Default value Description
allowTaskPreemption

boolean

Určuje, zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou. (Tato vlastnost není ve výchozím nastavení dostupná. Pro více informací kontaktujte podporu) Pokud je hodnota nastavena na True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moci znovu zařadit úlohy 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

BatchJobConstraints

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

creationTime

string (date-time)

Čas vytvoření úlohy.

displayName

string

Zobrazovaný název úlohy.

eTag

string

ETag úlohy. Jedná se o neprůhlený řetězec. Můžete ho použít ke zjištění, jestli se úloha mezi požadavky změnila. Konkrétně můžete při aktualizaci úlohy předat značku ETag, abyste určili, že se změny projeví jenom v případě, že do té doby úlohu nikdo jiný nezměnil.

executionInfo

BatchJobExecutionInfo

Informace o spuštění úlohy.

id

string

Řetězec, který jednoznačně identifikuje úlohu v rámci účtu. 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

BatchJobManagerTask

Podrobnosti o úloze správce úloh, která se má spustit při spuštění úlohy

jobPreparationTask

BatchJobPreparationTask

Úkol přípravy úlohy. Úkol přípravy úlohy je speciální úkol spuštěný na každém výpočetním uzlu před jakýmkoli jiným úkolem úlohy.

jobReleaseTask

BatchJobReleaseTask

Úloha uvolnění úlohy. Úloha uvolnění úlohy je zvláštní úkol spuštěný na konci úlohy na každém výpočetním uzlu, který spustil jakoukoli jinou úlohu úlohy.

lastModified

string (date-time)

Čas poslední změny úlohy. Jedná se o čas poslední změny dat na úrovni úlohy, jako je stav úlohy nebo priorita. Nefaktoruje změny na úrovni úkolu, jako je přidání nových úkolů nebo změny stavu úkolů.

maxParallelTasks

integer (int32)

-1

Maximální počet úkolů, které lze pro úlohu spustit paralelně. (Tato vlastnost není ve výchozím nastavení dostupná. Další informace vám poskytne podpora) Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadaná. 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

BatchMetadataItem[]

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

BatchJobNetworkConfiguration

(Tato vlastnost není ve výchozím nastavení dostupná. Pro více informací kontaktujte podporu) Síťová konfigurace pro úlohu.

onAllTasksComplete

BatchAllTasksCompleteMode

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. Výchozí hodnota je noaction.

onTaskFailure

BatchTaskFailureMode

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

BatchPoolInfo

Nastavení fondu přidružené k úloze.

previousState

BatchJobState

Předchozí stav úlohy. Tato vlastnost není nastavena, pokud je úloha v počátečním aktivním stavu.

previousStateTransitionTime

string (date-time)

Čas, kdy úloha přešla do předchozího stavu. Tato vlastnost není nastavena, pokud je úloha v počátečním aktivním stavu.

priority

integer (int32)

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.

state

BatchJobState

Aktuální stav úlohy.

stateTransitionTime

string (date-time)

Čas, kdy úloha vstoupila do aktuálního stavu.

stats

BatchJobStatistics

Statistika využití prostředků po celou dobu životnosti úlohy. Tato vlastnost je naplněna pouze v případě, že služba BatchJob byla načtena s klauzulí rozbalení, včetně atributu 'stats'; jinak má hodnotu null. Statistiky nemusí být okamžitě dostupné. Služba Batch provádí pravidelné zavedení statistik. Typické zpoždění je asi 30 minut.

url

string (uri)

Adresa URL úlohy.

usesTaskDependencies

boolean

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

BatchJobConstraints

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

Name Typ Description
maxTaskRetryCount

integer (int32)

Maximální počet opakování každého úkolu lze zopakovat. 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í. Batch služba vyzkouší každý úkol jednou a poté může zkusit znovu až do tohoto limitu. Například pokud je maximální počet opakování 3, Batch vyzkouší úkol až 4krát (jeden počáteční pokus a 3 pokusy). Pokud je maximální počet opakování 0, dávková služba úkoly nezkouší. Pokud je maximální počet opakování -1, dávková služba znovu zkouší úkoly bez omezení. Výchozí hodnota je 0 (žádné opakování).

maxWallClockTime

string (duration)

Maximální uplynulá doba, po kterou může Práce běžet, měřena od okamžiku, kdy je Práce vytvořena. Pokud se úloha nedokončí v časovém limitu, dávková služba ji ukončí spolu s dalšími běžícími úkoly. V tomto případě bude důvodem ukončení MaxWallClockTimeExpiry. Pokud tato vlastnost není specifikována, neexistuje časové omezení, jak dlouho může Úkol běžet. Doba trvání je specifikována ve formátu ISO 8601.

BatchJobDefaultOrder

BatchJobDefaultOrder enumy

Hodnota Description
none

Úkoly by měly být plánovány rovnoměrně ze všech úloh stejné priority pro pool.

creationtime

Pokud mají práce stejnou prioritu, měly by být úkoly z dříve vytvořených úkolů plánovány jako první.

BatchJobExecutionInfo

Obsahuje informace o spuštění úlohy v Azure Batch službě.

Name Typ Description
endTime

string (date-time)

Čas dokončení práce. Tato vlastnost je nastavena pouze tehdy, pokud je Job ve stavu dokončení.

poolId

string

ID poolu, do kterého je tato práce přiřazena. Tento prvek obsahuje skutečný Pool, kde je Job přiřazen. Když získáte podrobnosti o práci ze služby, obsahují také element poolInfo, který obsahuje konfigurační data poolu od doby, kdy byla práce přidána nebo aktualizována. Tento prvek poolInfo může také obsahovat element poolId. Pokud ano, jsou oba ID stejné. Pokud ne, znamená to, že Job běžel v automatickém poolu a tato vlastnost obsahuje ID tohoto automatického poolu.

schedulingError

BatchJobSchedulingError

Podrobnosti o případných chybách, na které služba narazila při zahájení práce. Tato vlastnost není nastavena, pokud při spuštění práce nedošlo k chybě.

startTime

string (date-time)

Čas začátku práce. To je doba, kdy byla Práce vytvořena.

terminateReason

string

Řetězec popisující důvod, proč Práce skončila. Tato vlastnost je nastavena pouze tehdy, pokud je Job ve stavu dokončení. Pokud služba Batch ukončí úlohu, nastaví důvod následovně: JMComplete – úkol správce úloh dokončen a killJobOnCompletion byl nastaven na true. MaxWallClockTimeExpiry – Job dosáhl svého limitu maxWallClockTime. TerminateJobSchedule – Job byl spuštěn jako součást rozvrhu a schedule byl ukončen. AllTasksComplete - atribut Job onAllTasksComplete je nastaven na terminatejob a všechny úkoly v této práci jsou dokončeny. TaskFailed – atribut onTaskFailure v Jobu je nastaven na performExitOptionsJobAction, a Task in the Job failed s podmínkou ukončení, která určovala jobAction terminatejob. Každý jiný řetězec je uživatelsky definovaný důvod specifikovaný ve volání operace 'Terminate a Job'.

BatchJobManagerTask

Určuje podrobnosti úlohy správce úloh. Úloha Správce úloh se automaticky spustí při vytvoření úlohy. Služba Batch se pokusí naplánovat úlohu Správce úloh před všemi ostatními úkoly v úloze. Při zmenšování fondu se služba Batch pokusí zachovat uzly, ve kterých běží úkoly Správce úloh co nejdéle (to znamená, že výpočetní uzly se spuštěnými "normální" úkoly se odeberou před výpočetními uzly, na kterých běží úkoly Správce úloh). Pokud úloha Správce úloh selže a je třeba ji restartovat, systém se pokusí naplánovat ji s nejvyšší prioritou. Pokud nejsou dostupné žádné nečinné výpočetní uzly, může systém ukončit některý ze spuštěných úkolů ve fondu a vrátit ho do fronty, aby se uvolnilo místo pro restartování úlohy Správce úloh. Všimněte si, že úkol Správce úloh v jedné úloze nemá prioritu oproti úkolům v jiných úlohách. V rámci úloh se pozorují pouze priority na úrovni úlohy. Například pokud je třeba restartovat správce úloh v prioritě 0 Úloha, nepřesune úkoly priority 1 Úloha. 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ů.

Name Typ Description
allowLowPriorityNode

boolean

Zda může úloha správce úloh běžet na spot/nízkoprioritním výpočetním uzlu. Výchozí hodnota je true.

applicationPackageReferences

BatchApplicationPackageReference[]

Seznam aplikačních balíčků, které dávková služba nasadí na Compute Node před spuštěním příkazového řádku. Aplikační balíčky jsou stahovány a nasazovány do sdíleného adresáře, nikoli do pracovního adresáře Task. Pokud je tedy odkazovaný aplikační balíček již na Compute Node a je aktuální, není znovu stahovatelný; používá se existující kopie na Compute Node. Pokud nelze nainstalovat odkazovaný aplikační balíček, například proto, že balíček byl smazán nebo nedošlo ke stažení, úkol selže.

commandLine

string

Příkazový řádek úkolu 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 využít takové funkce, měli byste shell spustit v příkazové řádku, například pomocí "cmd /c MyCommand" v 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

constraints

BatchTaskConstraints

Omezení, která se vztahují na úkol správce úloh.

containerSettings

BatchTaskContainerSettings

Nastavení kontejneru, pod kterým Job Manager Task běží. Pokud má pool, který bude tuto úlohu spouštět, nastaven containerConfiguration, musí být nastaven také. Pokud pool, který bude tuto úlohu spouštět, nemá nastavenou containerConfiguration, nesmí být nastavena. Když je toto specifikováno, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) jsou namapovány do kontejneru, všechny proměnné prostředí úkolu jsou namapovány do kontejneru a příkazový řádek úkolu se vykoná v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR nemusí být zobrazeny na hostitelském disku, což znamená, že dávková API souborů k těmto souborům nebudou mít přístup.

displayName

string

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

environmentSettings

EnvironmentSetting[]

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

id

string

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

killJobOnCompletion

boolean

Zda dokončení úkolu správce práce znamená dokončení celé práce. Pokud je to pravda, po dokončení úlohy správce úloh služba Batch označí úlohu jako dokončenou. Pokud v tuto chvíli stále běží nějaké Tasks (kromě Job Release), tyto Tasks jsou ukončeny. Pokud je to nepravda, dokončení úkolu Správce práce neovlivňuje stav Práce. V takovém případě byste měli buď použít atribut onAllTasksComplete k ukončení práce, nebo nechat klienta či uživatele explicitně ukončit práci. Příkladem je, když správce úloh vytvoří sadu úkolů, ale pak už nehraje žádnou další roli v jejich vykonání. Výchozí hodnota je true. Pokud používáte atributy onAllTasksComplete a onTaskFailure pro kontrolu životnosti práce a Job Manager Task pouze k vytvoření úkolů pro danou práci (ne ke sledování pokroku), je důležité nastavit killJobOnCompletion na false.

outputFiles

OutputFile[]

Seznam souborů, které služba Batch nahraje z Compute Node po spuštění příkazového řádku. U víceinstancových úloh budou soubory nahrávány pouze z Compute Node, na kterém se vykonává primární Task.

requiredSlots

integer (int32)

Počet plánovacích slotů, které úkol vyžaduje k vykonání. Výchozí hodnota je 1. Úkol lze naplánovat k spuštění na výpočetním uzlu pouze tehdy, pokud má uzel dostatek volných slotů pro plánování. Pro víceinsekční úkoly tato vlastnost není podporována a nesmí být specifiková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

Zda úkol správce úloh vyžaduje výhradní použití výpočetního uzlu, kde běží. Pokud je to pravda, žádné jiné úkoly neběží na stejném uzlu tak dlouho, dokud správce úloh běží. Pokud je to nepravda, mohou ostatní úlohy běžet současně se správcem úloh na výpočetním uzlu. Úloha správce úloh se obvykle počítá do limitu souběžných úloh Výpočetního uzlu, takže to je relevantní pouze tehdy, pokud Výpočetní uzel umožňuje více současných úloh. Výchozí hodnota je true.

userIdentity

UserIdentity

Identita uživatele, pod kterou se vykonává úloha správce úloh. Pokud je vynechán, Úkol běží jako neadministrátorský uživatel unikátní pro daný úkol.

BatchJobNetworkConfiguration

(Tato vlastnost není ve výchozím nastavení dostupná. Pro více informací kontaktujte podporu) Síťová konfigurace 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í nastavení 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á 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. Principal služby 'MicrosoftAzureBatch' musí mít roli 'Classic Virtual Machine Contributor' Role-Based Access Control (RBAC) pro specifikovaný VNet, aby Azure Batch služba mohla 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á specifikovaný VNet nějaké přidružené skupiny síťové bezpečnosti (NSG), musí být povoleno několik rezervovaných systémových portů pro příchozí komunikaci ze služby Azure Batch. Pro pooly vytvořené v konfiguraci virtuálního stroje povolte porty 29876 a 29877, stejně jako port 22 pro Linux a port 3389 pro Windows. Port 443 musí být také otevřený pro odchozí spojení pro komunikaci s Azure Storage. Další podrobnosti najdete v tématu: https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

BatchJobPreparationTask

Úkol přípravy úlohy, který se má spustit před všemi úkoly úlohy v libovolném výpočetním uzlu. Přípravu úlohy můžete použít k přípravě uzlu na spouštění úkolů pro úlohu. Mezi aktivity běžně prováděné při přípravě úlohy patří: Stahování běžných souborů prostředků používaných všemi úkoly v úloze. Úkol přípravy úlohy může stáhnout tyto běžné soubory prostředků do sdíleného umístění v uzlu. (AZ_BATCH_NODE_ROOT_DIR\shared) nebo spuštění místní služby na uzlu, aby s ní mohly komunikovat všechny úlohy. Pokud úloha přípravy úlohy selže (tj. vyčerpá její počet opakování před ukončením s ukončovacím kódem 0), služba Batch nespustí úkoly této úlohy na uzlu. Výpočetní uzel zůstává způsobilý ke spouštění úkolů této úlohy, dokud nebude znovu zmagován. Výpočetní uzel zůstane aktivní a dá se použít pro jiné úlohy. Úkol přípravy úlohy může běžet vícekrát na stejném uzlu. Proto byste měli napsat úlohu přípravy úlohy pro zpracování opětovného spuštění. Pokud se uzel restartuje, úloha přípravy úlohy se před plánováním jakékoli jiné úlohy úlohy spustí znovu na výpočetním uzlu, pokud je true znovu spustitOnNodeRebootAfterSuccess nebo pokud úloha přípravy úlohy nebyla dokončena dříve. Pokud je uzel znovu zmagován, úloha přípravy úlohy se spustí znovu před naplánování libovolného úkolu úlohy. 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ů.

Name Typ Description
commandLine

string

Příkazový řádek úkolu Příprava na práci. 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 využít takové funkce, měli byste shell spustit v příkazové řádku, například pomocí "cmd /c MyCommand" v 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

constraints

BatchTaskConstraints

Omezení, která se vztahují na úkol přípravy na práci.

containerSettings

BatchTaskContainerSettings

Nastavení kontejneru, pod kterým Task Preparation Task běží. Když je toto specifikováno, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) jsou namapovány do kontejneru, všechny proměnné prostředí úkolu jsou namapovány do kontejneru a příkazový řádek úkolu se vykoná v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR nemusí být zobrazeny na hostitelském disku, což znamená, že dávková API souborů k těmto souborům nebudou mít přístup.

environmentSettings

EnvironmentSetting[]

Seznam nastavení proměnných prostředí pro úkol Příprava práce.

id

string

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

rerunOnNodeRebootAfterSuccess

boolean

Zda by měla dávková služba znovu spustit úlohu Job Preparation po restartu Compute Node. Úloha přípravy úlohy se vždy znovu spustí, pokud je počítačový uzel znovu nainstalován, nebo pokud úkol přípravy úkolu nebyl dokončen (například protože restart proběhl během běhu úkolu). Proto byste měli vždy napsat úkol přípravy na práci, abyste byli idempotentní a chovali se správně, pokud se spouštějí opakovaně. 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 Task Preparation Task sběží. Pokud je vynechán, Task běží jako neadministrátorský uživatel unikátní pro Task on Windows Compute Nodes, nebo jako neadministrátorský uživatel unikátní pro Pool na Linux Compute Nodes.

waitForSuccess

boolean

Zda by dávková služba měla počkat, až úkol Přípravy úkolu bude úspěšně dokončen, než naplánuje další úkoly úkolu na výpočetním uzlu. Úkol přípravy na práci byl úspěšně dokončen, pokud ukončil s výstupním kódem 0. Pokud je to pravda a úkol přípravy úkolu na uzlu selže, dávková služba znovu zkusí úkol přípravy úkolu až do maximálního počtu opakování (jak je specifikováno v elementu omezení). Pokud úkol po všech pokusech stále není úspěšně dokončen, pak dávková služba nenaplánuje úkoly úkolu na uzel. Uzel zůstává aktivní a je způsobilý k provádění úloh jiných úloh. Pokud je to nepravda, služba Batch nečeká na dokončení úkolu Přípravy úkolu. V takovém případě mohou na Compute Node začít běžet další úlohy úlohy, zatímco Job Preparation Task stále běží; a i když úkol Přípravy úkolu selže, nové úkoly budou nadále plánovány na výpočetním uzlu. Výchozí hodnota je true.

BatchJobReleaseTask

Ú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á. Úloha uvolnění úlohy se spustí, když úloha skončí, z důvodu jedné z následujících možností: Uživatel zavolá rozhraní API pro ukončení úlohy nebo rozhraní API úlohy delete, zatímco úloha je stále aktivní, dosáhne se maximálního časového omezení doby trvání úlohy a úloha je stále aktivní nebo úloha správce úloh je dokončena a úloha je nakonfigurována tak, aby se ukončila po dokončení správce úloh. Úloha uvolnění úlohy běží na každém uzlu, kde jsou spuštěné úkoly úlohy, a úloha přípravy úlohy byla spuštěna a dokončena. Pokud uzel znovu naimajete po spuštění úkolu přípravy úlohy a úloha skončí bez jakýchkoli dalších úkolů úlohy spuštěné na daném uzlu (a proto se úloha přípravy úlohy znovu nespustí), úloha uvolnění úlohy se na daném výpočetním uzlu nespustí. Pokud se uzel restartuje, zatímco úloha uvolnění úlohy je stále spuštěná, úloha uvolnění úlohy se spustí znovu při spuštění výpočetního uzlu. Úloha není označena jako dokončená, dokud se nedokončily všechny úkoly uvolnění úlohy. Úloha uvolnění úlohy se spouští na pozadí. Nezabývá plánovací slot; to znamená, že se nezapočítává do limitu taskSlotsPerNode zadaného ve fondu.

Name Typ Description
commandLine

string

Příkazová řádka úkolu Job Release. 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 využít takové funkce, měli byste shell spustit v příkazové řádku, například pomocí "cmd /c MyCommand" v 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

BatchTaskContainerSettings

Nastavení kontejneru, pod kterým Job Release Task běží. Když je toto specifikováno, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) jsou namapovány do kontejneru, všechny proměnné prostředí úkolu jsou namapovány do kontejneru a příkazový řádek úkolu se vykoná v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR nemusí být zobrazeny na hostitelském disku, což znamená, že dávková API souborů k těmto souborům nebudou mít přístup.

environmentSettings

EnvironmentSetting[]

Seznam nastavení proměnných prostředí pro úkol Job Release.

id

string

Řetězec, který jednoznačně identifikuje úkol Job Release v rámci Job. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítek a nesmí obsahovat více než 64 znaků. Pokud tuto vlastnost nespecifikujete, služba Batch přiřadí výchozí hodnotu 'jobrelease'. Žádný jiný úkol v práci nemůže mít stejné ID jako úkol uvolnění úkolu. Pokud se pokusíte odeslat úkol se stejným ID, dávková služba žádost odmítne s chybovým kódem TaskIdSameAsJobReleaseTask; pokud voláte přímo REST API, HTTP stavový kód je 409 (Konflikt).

maxWallClockTime

string (duration)

Maximální doba, po kterou může úkol Job Release Task na daném Compute Node běžet, měřený od okamžiku spuštění úkolu. Pokud úkol není dokončen v časovém limitu, dávková služba jej ukončí. Výchozí hodnota je 15 minut. Nesmíte specifikovat timeout delší než 15 minut. Pokud ano, služba Batch ji zamítne s chybou; pokud voláte přímo REST API, HTTP stavový kód je 400 (Špatný požadavek). Doba trvání je specifikována ve formátu ISO 8601.

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 (duration)

Minimální doba pro uchování adresáře úloh pro úkol uvolnění úlohy na výpočetním uzlu. Po uplynutí této doby může služba Batch složku úkolů smazat a veškerý jeho obsah. Výchozí je 7 dní, tj. adresář úloh bude ponechán po dobu 7 dní, pokud není Compute Node odstraněn nebo Job smazán. Doba trvání je specifikována ve formátu ISO 8601.

userIdentity

UserIdentity

Uživatelská identita, pod kterou Job Release Task běží. Pokud je vynechán, Úkol běží jako neadministrátorský uživatel unikátní pro daný úkol.

BatchJobSchedulingError

Při plánování úlohy došlo u služby Batch k chybě.

Name Typ Description
category

BatchErrorSourceCategory

Kategorie chyby při plánování úkolů.

code

string

Identifikátor chyby při plánování úloh. Kódy jsou invariantní a mají být využity programově.

details

NameValuePair[]

Seznam dalších chybových detailů souvisejících s chybou při plánování.

message

string

Zpráva popisující chybu plánování úlohy, určená k zobrazení v uživatelském rozhraní.

BatchJobState

BatchJobState enums

Hodnota Description
active

Úkol je k dispozici pro plánování úkolů.

disabling

Uživatel požádal o deaktivaci Práce, ale operace deaktivace stále probíhá (například čekání na ukončení Úloh).

disabled

Uživatel tuto práci deaktivoval. Žádné Tasks neběží a žádné nové Tasks nebudou plánovány.

enabling

Uživatel požádal o povolení úkolu, ale operace povolení stále probíhá.

terminating

Úkol se chystá dokončit, buď proto, že úkol správce úkolů byl dokončen, nebo protože uživatel úkol ukončil, ale operace ukončení stále probíhá (například proto, že běží úlohy uvolnění úloh).

completed

Všechny úkoly byly ukončeny a systém již nepřijímá žádné další úkoly ani další změny v práci.

deleting

Uživatel požádal o smazání úlohy, ale operace mazání stále probíhá (například proto, že systém stále ukončuje spuštěné úlohy).

BatchJobStatistics

Statistika využití prostředků pro úlohu

Name Typ Description
kernelCPUTime

string (duration)

Celkový čas CPU v režimu jádra (sečtěn napříč všemi jádry a všemi výpočetními uzly) spotřebovaný všemi úlohami v dané úlohě. Doba trvání je specifikována ve formátu ISO 8601.

lastUpdateTime

string (date-time)

Doba, kdy byly statistiky naposledy aktualizovány. Všechny statistiky jsou omezeny na rozsah mezi začátkemČasem a PoslednímČasem Aktualizace.

numFailedTasks

string (int64)

Celkový počet úkolů v práci, které selhaly v daném časovém rozmezí. Úkol selže, pokud vyčerpá maximální počet opakování bez vrácení výstupního kódu 0.

numSucceededTasks

string (int64)

Celkový počet úspěšně splněných úkolů v dané době v daném časovém rozmezí. Úkol se úspěšně dokončí, pokud vrátí výstupní kód 0.

numTaskRetries

string (int64)

Celkový počet opakování všech úkolů v práci během daného časového rozmezí.

readIOGiB

number (float)

Celkové množství dat v GiB přečtených z disku všemi úkoly v dané práci.

readIOps

string (int64)

Celkový počet operací čtení z disku provedených všemi úkoly v práci.

startTime

string (date-time)

Čas začátku časového rozpětí pokrytého statistikami.

url

string (uri)

URL statistik.

userCPUTime

string (duration)

Celkový čas CPU uživatelského režimu (součet napříč všemi jádry a všemi výpočetními uzly) spotřebovaný všemi úlohami v dané úlohě. Doba trvání je specifikována ve formátu ISO 8601.

waitTime

string (duration)

Celková doba čekání všech úkolů v práci. Doba čekání na úkol je definována jako uplynulý čas mezi vytvořením úkolu a začátkem jeho vykonání. (Pokud je úkol znovu vyzkoušen kvůli selhání, čekací doba je čas do posledního provedení úkolu.) Tato hodnota je uvedena pouze ve statistice životnosti účtu; není zahrnuta ve statistikách pracovních míst. Doba trvání je specifikována ve formátu ISO 8601.

wallClockTime

string (duration)

Celkový čas na hodinách u všech úkolů v práci. Čas na stěně hodin je uplynulý čas od začátku spuštění úkolu na výpočetním uzlu do jeho dokončení (nebo do poslední aktualizace statistik, pokud úkol do té doby nebyl dokončen). Pokud byl úkol znovu vyzkoušen, zahrnuje to i čas na stěně všech pokusů úkolu. Doba trvání je specifikována ve formátu ISO 8601.

writeIOGiB

number (float)

Celkové množství dat v GiB zapsaných na disk všemi úkoly v práci.

writeIOps

string (int64)

Celkový počet operací zápisu na disk provedených všemi úkoly v dané práci.

BatchMetadataItem

Služba Batch nepřiřazuje k tomuto metadatu žádný význam; je výhradně pro použití uživatelského kódu.

Name Typ Description
name

string

Název položky metadat.

value

string

Hodnota položky metadat.

BatchNodeFillType

Enumy BatchNodeFillType

Hodnota Description
spread

Úkoly by měly být rovnoměrně přiřazeny všem Compute Nodes v poolu.

pack

Co nejvíce úkolů (taskSlotsPerNode) by mělo být přiřazeno ke každému výpočetnímu uzlu ve skupině, než jsou úkoly přiřazeny dalšímu výpočetnímu uzlu ve skupině.

BatchNodeIdentityReference

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 (arm-id)

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

BatchNodePlacementConfiguration

Pro místní umístění budou uzly ve fondu přiděleny ve stejné oblasti. V případě zónového umístění budou uzly ve fondu rozloženy mezi různé zóny s vyrovnáváním maximálního úsilí.

Name Typ Description
policy

BatchNodePlacementPolicyType

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.

BatchNodePlacementPolicyType

BatchNodePlacementPolicyType enumy

Hodnota Description
regional

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

zonal

Uzly v poolu budou rozmístěny do různých zón dostupnosti s maximální vyvážeností.

BatchOsDisk

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.

diskSizeGB

integer (int32)

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

ephemeralOSDiskSettings

BatchDiffDiskSettings

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.

BatchPoolEndpointConfiguration

Konfigurace koncového bodu pro fond.

Name Typ Description
inboundNATPools

BatchInboundNatPool[]

Seznam příchozích NAT poolů, které lze použít k externímu adresování specifických portů na konkrétním Compute Node. Maximální počet příchozích NAT poolů na Batch Pool je 5. Pokud je překročen maximální počet příchozích NAT poolů, požadavek selže s HTTP stavovým kódem 400. Tuto hodnotu nelze zadat, pokud je IPAddressProvisioningType NoPublicIPAddresses.

BatchPoolIdentityReference

Odkaz na jednu z identit fondu pro šifrování disku. Tato identita se použije pro přístup k trezoru klíčů.

Name Typ Description
resourceId

string (arm-id)

ID prostředku ARM identity přiřazené uživatelem. Tento odkaz musí být zahrnut v identitách fondu.

BatchPoolInfo

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

Name Typ Description
autoPoolSpecification

BatchAutoPoolSpecification

Charakteristiky dočasného "automatického poolu". Služba Batch vytvoří tento automatický fond při odeslání úlohy. Pokud automatické vytvoření Poolu selže, služba Batch přesune úkol do stavu dokončení a chyba vytvoření Poolu je nastavena ve vlastnosti chyby plánování úkolu. Dávková služba spravuje životnost (jak vytvoření, tak i smazání, pokud není uvedeno keepAlive) automatického poolu. Jakékoliv uživatelské akce ovlivňující životnost automatického poolu během aktivní práce povedou k neočekávanému chování. Musíte zadat buď ID poolu, nebo automatickou specifikaci poolu, ale ne obojí.

poolId

string

ID existujícího poolu. Všechny úkoly této úlohy budou běžet ve specifikovaném poolu. Musíte zajistit, že Pool, na který tato nemovitost odkazuje, existuje. Pokud pool neexistuje v době, kdy se batch služba pokusí naplánovat úlohu, žádné úkoly pro tuto úlohu nebudou spuštěny, dokud nevytvoríte pool s tímto ID. Všimněte si, že služba Batch žádost o Job neodmítne; jednoduše nebude spouštět Tasks, dokud Pool nebude existovat. Musíte zadat buď ID poolu, nebo automatickou specifikaci poolu, ale ne obojí.

BatchPoolLifetimeOption

Enums BatchPoolLifetimeOption

Hodnota Description
jobschedule

Pool existuje po celou dobu trvání pracovního rozvrhu. Dávková služba vytváří pool, když vytvoří první úkol v plánu. Tuto možnost můžete aplikovat pouze na rozvrhy pracovních míst, nikoli na pracovní místa.

job

Bazén existuje po celou dobu trvání práce, které je věnován. Batch služba vytvoří Pool při vytvoření Job. Pokud je možnost 'úkol' aplikována na plán úloh, dávková služba vytvoří nový automatický pool pro každou práci vytvořenou v plánu.

BatchPoolSpecification

Specifikace pro vytvoření nového fondu

Name Typ Description
applicationPackageReferences

BatchApplicationPackageReference[]

Seznam balíčků, které se mají nainstalovat na každý výpočetní uzel ve fondu. Při vytváření poolu 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 (duration)

Č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). Doba trvání je specifikována ve formátu ISO 8601.

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

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

BatchMetadataItem[]

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. Podporuje Azure Files, NFS, CIFS/SMB a Blobfuse.

networkConfiguration

NetworkConfiguration

Konfigurace sítě pro fond.

resizeTimeout

string (duration)

Č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). Doba trvání je specifikována ve formátu ISO 8601.

startTask

BatchStartTask

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

targetDedicatedNodes

integer (int32)

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 (int32)

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

taskSchedulingPolicy

BatchTaskSchedulingPolicy

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

taskSlotsPerNode

integer (int32)

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. Pro informace o dostupných velikostech virtuálních strojů v poolech viz Choose a VM size for Compute Nodes in an Azure Batch Pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

BatchPublicIpAddressConfiguration

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

Name Typ Description
ipAddressIds

string[] (arm-id)

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á podobu: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft. Network/publicIPAddresses/{ip}.

ipFamilies

IPFamily[]

Rodiny IP adres používané k určení verzí IP dostupných pro fond. Rodiny IP adres se používají k určení fondů s jedním nebo dvěma zásobníky. U jednoho zásobníku je očekávaná hodnota IPv4. U duálního zásobníku jsou očekávané hodnoty IPv4 a IPv6.

ipTags

IPTag[]

Seznam značek IP přidružených k veřejným IP adresám fondu. Značky IP se používají ke kategorizaci a filtrování veřejných IP adres pro účely fakturace a správy.

provision

IpAddressProvisioningType

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

BatchStartTask

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.

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 využít takové funkce, měli byste shell spustit v příkazové řádku, například pomocí "cmd /c MyCommand" v 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

BatchTaskContainerSettings

Nastavení kontejneru, pod kterým StartTask běží. Když je toto specifikováno, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) jsou namapovány do kontejneru, všechny proměnné prostředí úkolu jsou namapovány do kontejneru a příkazový řádek úkolu se vykoná v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR nemusí být zobrazeny na hostitelském disku, což znamená, že dávková API souborů k těmto souborům nebudou mít přístup.

environmentSettings

EnvironmentSetting[]

Seznam nastavení proměnných prostředí pro StartTask

maxTaskRetryCount

integer (int32)

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 StartTask běží. Pokud je vynechán, Úkol běží jako neadministrátorský uživatel unikátní pro daný úkol.

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.

BatchTaskConstraints

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

Name Typ Description
maxTaskRetryCount

integer (int32)

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ě určuje počet opakovaných pokusů pro spustitelný soubor Task kvůli nenulovému výstupní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, dávková služba úkol po prvním pokusu nezkouší znovu. 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 (duration)

Maximální uplynulý čas, který může úkol proběhnout, měřený od okamžiku, kdy úkol začne. Pokud úkol není dokončen v časovém limitu, dávková služba jej ukončí. Pokud to není specifikováno, neexistuje časový limit, jak dlouho může úkol trvat. Doba trvání je specifikována ve formátu ISO 8601.

retentionTime

string (duration)

Minimální doba pro uchování adresáře úloh na Compute Node, kde běžel, je od okamžiku dokončení vykonání. Po uplynutí této doby může služba Batch složku úkolů smazat a veškerý jeho obsah. Výchozí je 7 dní, tj. adresář úloh bude ponechán po dobu 7 dní, pokud není Compute Node odstraněn nebo Job smazán. Doba trvání je specifikována ve formátu ISO 8601.

BatchTaskContainerSettings

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

Obrázek, který použijete k vytvoření kontejneru, ve kterém bude úkol běžet. Toto je úplná reference na Image, jak by bylo specifikováno pro "docker pull". Pokud není v názvu obrázku uveden žádný tag, používá se tag ":latest" jako výchozí.

registry

ContainerRegistryReference

Soukromý registr, který obsahuje obraz kontejneru. Toto nastavení lze vynechat, pokud bylo již při tvorbě Poolu k dispozici.

workingDirectory

ContainerWorkingDirectory

Umístění pracovního adresáře kontejneru Task. Výchozí hodnota je taskWorkingDirectory.

BatchTaskFailureMode

Enumy TaskFailure

Hodnota Description
noaction

Neprovádět žádnou akci. Práce zůstává aktivní, pokud není propuštěna nebo neaktivována jiným způsobem.

performexitoptionsjobaction

Ukončit práci. Důvod ukončení úkolu je nastaven na 'AllTasksComplete'.

BatchTaskSchedulingPolicy

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

Name Typ Default value Description
jobDefaultOrder

BatchJobDefaultOrder

none

Pořadí pro plánování úloh z různých zakázek se stejnou prioritou. Pokud není zadaný, výchozí hodnota je žádná.

nodeFillType

BatchNodeFillType

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

BatchUefiSettings

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.

BatchVmDiskSecurityProfile

Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Lze ji nastavit pouze pro důvěrné virtuální počítače a vyžaduje se 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: Dá se nastavit jenom pro důvěrné virtuální počítače a vyžaduje se při použití důvěrných virtuálních počítačů.

BatchVmImageReference

Odkaz na obrázek z Azure Virtual Machines Marketplace nebo na obraz Azure Compute Gallery. Pro ověření seznamu všech odkazů na obrázky v Azure Marketplace od Azure Batch se podívejte na operaci 'List Supported Images'.

Name Typ Description
communityGalleryImageId

string

Unikátní identifikátor obrázku komunitní galerie. 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 obrazu platformy nebo obrázku tržiště použitého k vytvoření uzlu. Toto pole pouze pro čtení se liší od 'version' pouze tehdy, pokud byla hodnota uvedena pro 'version' při vytvoření poolu 'laput'.

offer

string

Typ nabídky je obraz Azure Virtual Machines Marketplace. Například UbuntuServer nebo WindowsServer.

publisher

string

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

sharedGalleryImageId

string

Jedinečný identifikátor sdíleného obrázku 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

SKU obrazu Azure Virtual Machines Marketplace. Například 18.04-LTS nebo 2019-Datacenter.

version

string

Verze obrazu Azure Virtual Machines Marketplace. Pro výběr nejnovější verze obrazu lze zadat hodnotu 'nejnejčasnější'. Pokud tento parametr vynecháte, výchozí hodnota je nejnovější.

virtualMachineImageId

string (arm-id)

Identifikátor ARM zdroje pro obraz Azure Compute Gallery. Výpočetní uzly v poolu budou vytvořeny pomocí tohoto Image ID. Jedná se o formu /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft. Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} nebo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft. Compute/galleries/{galleryName}/images/{imageDefinitionName} pro vždy výchozí nastavení na nejnovější verzi obrázku. Tato vlastnost je vzájemně vylučující se s ostatními vlastnostmi ImageReference. Obraz Azure Compute Gallery musí mít repliky ve stejné oblasti a musí být ve stejném předplatném jako účet Azure Batch. Pokud verze obrázku není v imageID uvedena, použije se nejnovější verze. Pro informace o nastavení firewallu pro komunikaci agenta Batch Compute Node s Batch službou viz https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

CachingType

CachingType enums

Hodnota Description
none

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

readonly

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

readwrite

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

CifsMountConfiguration

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

Name Typ Description
mountOptions

string

Další možnostipříkazového Jsou to možnosti "síťového využití" ve Windows a "připojit" v Linuxu.

password

string (password)

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 bude souborový systém připojen. 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.

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.

Hodnota Description
Shared

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

Startup

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

VfsMounts

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

Task

Cesta k úkolu.

JobPrep

Cesta úkolu přípravy úlohy.

Applications

Cesta k aplikacím.

ContainerRegistryReference

Privátní registr kontejneru.

Name Typ Description
identityReference

BatchNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem pro přístup k Azure Container Registry místo uživatelského jména a hesla.

password

string (password)

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

registryServer

string (uri)

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

ContainerType enums

Hodnota Description
dockerCompatible

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

criCompatible

Ke spuštění kontejnerů se použije technologie založená na CRI.

ContainerWorkingDirectory

ContainerWorkingDirectory enums

Hodnota Description
taskWorkingDirectory

Použijte standardní pracovní adresář Batch service Task Work, který bude obsahovat soubory Task Resource Files vyplněné Batchem.

containerImageDefault

Použijte pracovní adresář definovaný v kontejnerovém obrazu. Pozor, tento adresář nebude obsahovat soubory zdrojů stažené Batchem.

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 (int32)

Počáteční velikost disku v gigabajtech.

lun

integer (int32)

Číslo logické jednotky. Logický argumentUnitNumber slouží k jedinečné identifikaci jednotlivých datových disků. Při připojování více disků by měly mít každý z nich jedinečnou logickou hodnotuUnitNumber. Hodnota musí být v rozmezí od 0 do 63 včetně.

managedDisk

ManagedDisk

Parametry spravovaného disku.

DiffDiskPlacement

Specifikuje dočasné umístění disku operačního systému pro všechny výpočetní uzly (VM) v poolu. Tuto vlastnost může uživatel v požadavku použít k výběru umístění, ve kterém má být operační systém. Například místo na disku mezipaměti pro dočasné zřizování disku s operačním systémem. Pro více informací o požadavcích na velikost disku Ephemeral OS prosím viz požadavky na velikost disku Ephemeral OS pro Windows VM na https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a Linux VM na https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

Hodnota Description
cachedisk

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

DiskCustomerManagedKey

Odkaz na klíč spravovaný zákazníkem pro šifrování disku.

Name Typ Description
identityReference

BatchPoolIdentityReference

Odkaz na jednu z identit fondu pro šifrování disku. Tato identita bude použita pro přístup k trezoru klíčů.

keyUrl

string

Plně funkční adresa URL klíče odkazující na klíč ve službě KeyVault Segment verze adresy URL se vyžaduje bez ohledu na hodnotu rotationToLatestKeyVersionEnabled.

rotationToLatestKeyVersionEnabled

boolean

Nastavením tohoto příznaku na hodnotu true povolíte automatickou aktualizaci šifrování disku na nejnovější verzi klíče. Výchozí hodnota je False.

DiskEncryptionConfiguration

Konfigurace šifrování disku použitá na výpočetní uzly ve fondu. Konfigurace šifrování disku není podporována v Linux poolu vytvořeném pomocí Azure Compute Gallery Image.

Name Typ Description
customerManagedKey

DiskCustomerManagedKey

Referenční informace ke klíči spravovaného zákazníkem pro šifrování disku s operačním systémem. Klíč spravovaný zákazníkem zašifruje disk s operačním systémem pomocí EncryptionAtRest a ve výchozím nastavení zašifrujeme také datový disk. Lze ji použít pouze v případě, že je pool nakonfigurován s identitou a OsDisk je nastaven jako jeden z cílů DiskEncryption.

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.

DiskEncryptionSetParameters

ID prostředku ARM sady šifrování disku.

Name Typ Description
id

string (arm-id)

ID prostředku ARM sady šifrování disku. Prostředek musí být ve stejném předplatném jako účet Batch.

DiskEncryptionTarget

Enums DiskEncryptionTarget

Hodnota Description
osdisk

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

temporarydisk

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

DynamicVNetAssignmentScope enums

Hodnota Description
none

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

job

Dynamické přiřazení virtuální sítě se provádí pro každou úlohu.

ElevationLevel

Enumy ElevationLevel

Hodnota Description
nonadmin

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

admin

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

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

HostEndpointSettings

Určuje konkrétní nastavení koncového bodu hostitele.

Name Typ Description
inVMAccessControlProfileReferenceId

string

Specifikuje odkaz na resource id InVMAccessControlProfileVersion ve formě /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft. Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}.

mode

HostEndpointSettingsModeTypes

Určuje režim provádění zásad řízení přístupu.

HostEndpointSettingsModeTypes

Enumy HostEndpointSettingsModeTypes

Hodnota Description
Audit

V režimu auditování systém funguje, jako by vynucovala zásady řízení přístupu, včetně generování položek odepření přístupu v protokolech, ale ve skutečnosti neodmítá žádné požadavky na koncové body hostitele.

Enforce

Režim vynucování je doporučený režim provozu a systém bude vynucovat politiku řízení přístupu. Tuto vlastnost nelze použít společně s 'inVMAccessControlProfileReferenceId'.

InboundEndpointProtocol

Enums InboundEndpointProtocol

Hodnota Description
tcp

Pro koncový bod použijte protokol TCP.

udp

Pro koncový bod použijte UDP.

IpAddressProvisioningType

IPAddressProvisioningType enums

Hodnota Description
batchmanaged

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.

usermanaged

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

nopublicipaddresses

Nebude vytvořena žádná veřejná IP adresa.

IPFamily

Rodiny IP adres používané k určení verzí IP dostupných pro fond.

Hodnota Description
IPv4

IPv4 je dostupné pro pool.

IPv6

IPv6 je dostupný pro tento pool.

IPTag

Obsahuje značku IP přidruženou k veřejné IP adrese.

Name Typ Description
ipTagType

string

Typ značky IP. Příklad: FirstPartyUsage.

tag

string

Hodnota značky IP přidružené k veřejné IP adrese. Příklad: SQL.

LinuxUserConfiguration

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

Name Typ Description
gid

integer (int32)

Skupinové ID 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 gid.

sshPrivateKey

string (password)

SSH soukromý klíč pro uživatelský účet. Privátní klíč nesmí být chráněný heslem. Soukromý klíč se používá k automatické konfiguraci autentizace založené na asymetrických klíčích pro SSH mezi Compute Node Node Node v Linuxovém poolu, pokud je vlastnost enableInterNodeCommunication v poolu pravdivá (je ignorována, pokud je enableInterNodeCommunication nepravdivá). To provede umístěním páru klíčů do adresáře .ssh uživatele. Pokud není specifikováno, není mezi Compute Nodes konfigurován SSH bez hesla (uživatelův .ssh adresář se nemění tak).

uid

integer (int32)

Uživatelské ID 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

LoginMode enums

Hodnota Description
batch

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

Režim přihlášení LOGON32_LOGON_INTERACTIVE Win32. UAC je povoleno ve Windows VirtualMachineConfiguration Pools. Pokud je tato možnost použita s nadřazenou uživatelskou identitou ve Windows VirtualMachineConfiguration Poolu, uživatelská relace nebude zvýšená, pokud aplikace spuštěná příkazovým řádkem Úkolu není nakonfigurována tak, aby vždy vyžadovala administrátorská oprávnění nebo maximální oprávnění.

ManagedDisk

Parametry spravovaného disku.

Name Typ Description
diskEncryptionSet

DiskEncryptionSetParameters

Určuje ID prostředku spravovaného disku spravovaného zákazníkem pro spravovaný disk. Lze jej nastavit pouze v režimu UserSubscription.

securityProfile

BatchVmDiskSecurityProfile

Určuje nastavení profilu zabezpečení pro spravovaný disk.

storageAccountType

StorageAccountType

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

MountConfiguration

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

Name Typ Description
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

Azure Storage Container pro připojení pomocí blob FUSE na každém uzlu. Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi.

azureFileShareConfiguration

AzureFileShareConfiguration

Azure File Share pro připojení na každý uzel. 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.

NameValuePair

Představuje dvojici název-hodnota.

Name Typ Description
name

string

Jméno v páru jméno-hodnota.

value

string

Hodnota v páru jméno-hodnota.

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

BatchPoolEndpointConfiguration

Konfigurace pro koncové body na výpočetních uzlech v dávkovém poolu.

publicIPAddressConfiguration

BatchPublicIpAddressConfiguration

Konfigurace Public IPAddress pro výpočetní uzly ve fondu Batch.

subnetId

string

Identifikátor ARM zdroje virtuální síťové podsítě, ke kterému se připojí výpočetní uzly poolu. 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á jako účet Azure Batch. Specifikovaná podsíť by měla mít dostatek volných IP adres, aby pojala počet výpočetních uzlů v poolu. Pokud podsíť nemá dostatek volných IP adres, Pool částečně alokuje uzly a dojde k chybě při změně velikosti. Principal služby 'MicrosoftAzureBatch' musí mít roli 'Classic Virtual Machine Contributor' Role-Based Access Control (RBAC) pro specifikovaný VNet. Specifikovaná podsíť musí umožnit komunikaci ze služby Azure Batch, aby bylo možné 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é. Pouze virtuální sítě ARM ('Microsoft. Network/virtualNetworks') jsou podporovány. Pokud má specifikovaný VNet nějaké přidružené skupiny síťové bezpečnosti (NSG), musí být pro příchozí komunikaci povoleno několik rezervovaných systémových portů, včetně portů 29876 a 29877. Také povolte odchozí spojení do Azure Storage na portu 443. Další podrobnosti najdete v tématu: https://learn.microsoft.com/azure/batch/nodes-and-pools#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 (int32)

Priorita tohoto pravidla. Priority v rámci Poolu musí být jedinečné a hodnoceny podle priorit. Čí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 rozmezí od 0 do 65535. Každý záznam v této kolekci nesmí překrývat žádný jiný záznam (ani rozsah, ani jednotlivý port). Pokud jsou zadány jiné hodnoty, požadavek selže s HTTP stavovým kódem 400. Výchozí hodnota je ''.

NetworkSecurityGroupRuleAccess

Enums NetworkSecurityGroupRuleAccess

Hodnota Description
allow

Povolit přístup.

deny

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 Jsou to možnosti "síťového využití" ve Windows a "připojit" v Linuxu.

relativeMountPath

string

Relativní cesta na výpočetním uzlu, kde bude souborový systém připojen. 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.

OutputFile

Při každém nahrání souboru služba Batch zapíše do výpočetního uzlu dva soubory protokolu,fileuploadout.txtafileuploaderr.txt. Tyto soubory protokolu slouží k získání dalších informací o konkrétním selhání.

Name Typ Description
destination

OutputFileDestination

Cíl výstupních souborů.

filePattern

string

Vzor určující, které soubory nahrát. Podporují se jak relativní, tak absolutní cesty. Relativní cesty jsou relativní k pracovnímu adresáři Task. Podporovány jsou následující žolíky: * odpovídá 0 nebo více znakům (například vzor abc* by odpovídal abc nebo abcdef), ** odpovídá libovolnému adresáři, ? Shoduje se s libovolným znakem, [ABC] s jedním znakem v závorce a [A-C] s jedním znakem v rozsahu. Závorky mohou obsahovat negaci, která odpovídá jakémukoli znaku, který není specifikován (například [!abc] odpovídá jakémukoli znaku kromě a, b nebo c). Pokud název souboru začíná na "." je ve výchozím nastavení ignorován, ale může být přiřazen explicitním zadáním (například .gif nebude odpovídat .a.gif, ale ..gif ano). Jednoduchý příklad: ***.txt odpovídá jakémukoli souboru, který nezačíná na '.' a končí na .txt v pracovním adresáři Task nebo v jakémkoli podadresáři. Pokud název souboru obsahuje zástupný znak, lze jej uniknout pomocí závorek (například abc[] by odpovídalo souboru s názvem abc). Všimněte si, že \ a / jsou na Windows považovány za oddělovače adresářů, ale na Linuxu je to pouze / (). Proměnné prostředí (%var% na Windows nebo $var na Linuxu) jsou rozšířeny před aplikací vzoru.

uploadOptions

OutputFileUploadConfig

Další možnosti pro nahrávací operaci, včetně podmínek nahrávání.

OutputFileBlobContainerDestination

Specifikuje cíl pro nahrání souboru v rámci Azure blob storage kontejneru.

Name Typ Description
containerUrl

string (uri)

URL kontejneru v rámci Azure Blob Storage, do kterého se soubor nahrá. Pokud nepoužívá spravovanou identitu, musí URL obsahovat Shared Access Signature (SAS), který umožňuje zápis do kontejneru.

identityReference

BatchNodeIdentityReference

Odkaz na uživatelem přiřazenou identitu pro přístup k Azure Blob Storage specifikovaný containerUrl. Identita musí mít zápisový přístup do kontejneru Azure Blob Storage.

path

string

Cílový blob nebo virtuální adresář uvnitř kontejneru Azure Storage. Pokud filePattern odkazuje na konkrétní soubor (tj. neobsahuje žádné divoké znaky), pak path je název blobu, do kterého se soubor nahrává. Pokud filePattern obsahuje jednu nebo více divokých znaků (a proto může odpovídat více souborům), pak path je název virtuálního adresáře blobů (který je předem přiřazen ke každému názvu blobu), do kterého se soubor (soubory) nahrávají. Pokud je vynecháno, soubor(y) jsou nahrany do kořene kontejneru s názvem blob, který odpovídá jejich názvu souboru.

uploadHeaders

OutputFileUploadHeader[]

Seznam dvojic název-hodnota pro hlavičky určené k nahrávání výstupních souborů. Tyto hlavičky budou specifikovány při nahrávání souborů do Azure Storage. Oficiální dokument o povolených hlavičkách při nahrávání blobů: https://learn.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

Místo v Azure blob storage, do kterého se nahrávají soubory.

OutputFileUploadCondition

OutputFileUploadCondition enums

Hodnota Description
tasksuccess

Soubor (soubory) nahrajte až po ukončení procesu úkolu s výstupním kódem 0.

taskfailure

Soubor nahrávejte až po ukončení procesu úkolu s nenulovým výstupním kódem.

taskcompletion

Nahrajte soubor(y) po ukončení procesu Task, bez ohledu na výstupní kód.

OutputFileUploadConfig

Možnosti operace nahrá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 by měl být výstupní soubor nebo sada souborů úkolu nahrána. Výchozí je plnění úkolů.

OutputFileUploadHeader

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

Name Typ Description
name

string

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

value

string

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

ProxyAgentSettings

Určuje nastavení proxyagentu při vytváření virtuálního počítače.

Name Typ Description
enabled

boolean

Určuje, jestli má být na virtuálním počítači nebo ve škálovací sadě virtuálních počítačů povolená funkce Protokol zabezpečení metadat. Výchozí hodnota je False.

imds

HostEndpointSettings

Nastavení koncového bodu IMDS.

wireServer

HostEndpointSettings

Nastavení koncového bodu WireServer.

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 skladovacího kontejneru 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

Prefix blobů pro použití při stahování blobů z Azure Storage kontejneru. 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 stahované do Linux Compute Nodes. Bude ignorován, pokud je specifikován pro resource file, který bude stažen na Windows Compute Node. Pokud tato vlastnost není specifikována pro Linux Compute Node, je na soubor aplikována výchozí hodnota 0770.

filePath

string

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

httpUrl

string (uri)

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 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 URL pro blob v Azure Storage: zahrnout Shared Access Signature (SAS) udělující oprávnění ke čtení na blobu, použít spravovanou identitu s oprávněním ke čtení, nebo nastavit ACL pro blob či jeho kontejner tak, aby umožnil veřejný přístup.

identityReference

BatchNodeIdentityReference

Odkaz na uživatelem přiřazenou identitu pro přístup k Azure Blob Storage specifikovaný pomocí storageContainerUrl nebo httpUrl.

storageContainerUrl

string (uri)

URL kontejneru blob v rámci 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 URL pro kontejner v Azure úložišti: zahrnout Shared Access Signature (SAS), která uděluje oprávnění ke čtení a seznamu kontejneru, použít spravovanou identitu s oprávněním číst a uvádět, nebo nastavit ACL pro kontejner pro 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 (int32)

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 (int32)

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 (int32)

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 (duration)

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í je specifiková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

Enumy SecurityEncryptionTypes

Hodnota Description
DiskWithVMGuestState

Typ šifrování spravovaného disku je nastavený na DiskWithVMGuestState pro šifrování spravovaného disku spolu s objektem blob VMGuestState. Není podporován na datových discích.

NonPersistedTPM

Typ šifrování spravovaného disku je nastavený na hodnotu NonPersistedTPM, aby se stav firmwaru neuchovával v objektu blob VMGuestState.

VMGuestStateOnly

Typ šifrování spravovaného disku je nastavený na VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState.

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.

proxyAgentSettings

ProxyAgentSettings

Určuje nastavení proxyagentu při vytváření virtuálního počítače.

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

BatchUefiSettings

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.

Hodnota Description
trustedLaunch

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

confidentialvm

Azure Confidential Computing nabízí důvěrné VM pro nájemce s vysokými požadavky na bezpečnost 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.

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

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

StorageAccountType

Výčty StorageAccountType

Hodnota Description
standard_lrs

Datový disk by měl používat standardní místně redundantní úložiště.

premium_lrs

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

standardssd_lrs

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

UpgradeMode

UpgradeMode enumy

Hodnota Description
automatic

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

manual

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

rolling

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.

UserAccount

Vlastnosti používané k vytvoření uživatele používaného k provádění úloh na Azure Batch Compute Node.

Name Typ Description
elevationLevel

ElevationLevel

Úroveň nadmořské výšky uživatelského účtu. Výchozí hodnota neníadmin.

linuxUserConfiguration

LinuxUserConfiguration

Linuxově specifická uživatelská konfigurace uživatelského účtu. Tato vlastnost se ignoruje, pokud je specifikována ve Windows Poolu. Pokud není zadaný, uživatel se vytvoří s výchozími možnostmi.

name

string

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

password

string (password)

Heslo k uživatelskému účtu.

windowsUserConfiguration

WindowsUserConfiguration

Specifická konfigurace uživatele pro uživatelský účet pro Windows. Tuto vlastnost lze specifikovat pouze pokud je uživatel v Windows Poolu. Pokud není specifikováno a je v Windows Poolu, uživatel je vytvořen s výchozími možnostmi.

UserIdentity

Definice identity uživatele, pod kterou je úloha spuštěna. Zadejte vlastnost userName nebo autoUser, ale ne obojí.

Name Typ Description
autoUser

AutoUserSpecification

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

username

string

Název uživatelské identity, pod kterou je úkol spuštěn. Vlastnosti userName a autoUser se vzájemně vylučují; musíte zadat jednu, ale ne obě.

VirtualMachineConfiguration

Konfigurace pro Compute Nodes v poolu založeném na infrastruktuře Azure Virtual Machines.

Name Typ Description
containerConfiguration

BatchContainerConfiguration

Konfigurace kontejnerů pro Pool. Pokud je specifikováno, na každém Compute Node v poolu se provádí příprava tak, aby úlohy mohly běžet v kontejnerech. Všechny běžné úkoly a úlohy správce úloh běžící v tomto poolu musí specifikovat vlastnost containerSettings, a všechny ostatní úlohy ji mohou specifikovat.

dataDisks

DataDisk[]

Konfigurace datových disků připojených k výpočetním uzlům ve skupině. Tato vlastnost musí být specifikována, pokud musí být k výpočetním uzlům v poolu připojeny prázdné datové disky. Tuto aktualizaci nelze aktualizovat. Každý Compute Node má svůj vlastní disk (disk není souborová sdílená část). Existující disky nelze připojit, každá připojená disketa je prázdná. Když je Compute Node odstraněn z poolu, disk a všechna data s ním spojená jsou také smazána. Disk není po připojení formátován, musí být před použitím formátován – pro více informací viz https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux a https://learn.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

BatchVmImageReference

Odkaz na Azure Virtual Machines Marketplace Image nebo na vlastní Virtual Machine Image k použití.

licenseType

string

Toto platí pouze pro obrazy obsahující operační systém Windows a mělo by být používáno pouze tehdy, když máte platné on-premises licence pro Compute Nodes, které budou nasazeny. Pokud tento parametr vynecháte, nepoužije se žádná sleva za místní licencování. Hodnoty jsou:

Windows_Server - Licence na místě je určena pro Windows Server. Windows_Client - On-premises licence je určena pro Windows klienta.

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

BatchNodePlacementConfiguration

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

osDisk

BatchOsDisk

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čů.

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. Referenční ID artefaktu služby je ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft. Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

windowsConfiguration

WindowsConfiguration

Nastavení operačního systému Windows na virtuálním stroji. Tato vlastnost nesmí být specifikována, pokud vlastnost imageReference specifikuje obraz Linux OS.

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 prodloužení.

typeHandlerVersion

string

Verze obslužné rutiny skriptu.

WindowsConfiguration

Nastavení operačního systému Windows, které se aplikují na virtuální stroj.

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 Windows Compute Node.

Name Typ Description
loginMode

LoginMode

Přihlašovací režim pro uživatele. Výchozí je 'batch'.