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). |
|
job
|
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. |
|
time
|
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 |
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 |
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 |
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 |
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
|
|
| Other Status Codes |
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 |
|---|---|
|
Automatic |
Parametry konfigurace používané k automatickému upgradu operačního systému. |
|
Auto |
AutoUserScope enums |
|
Auto |
Specifikuje možnosti pro automatického uživatele, který spouští Azure Batch Task. |
|
Azure |
Informace použité pro připojení k Azure Storage Container pomocí Blobfuse. |
|
Azure |
Informace používané pro připojení k Azure Fileshare. |
|
Batch |
Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. |
|
Batch |
Odkaz na balíček, který se má nasadit do výpočetních uzlů. |
|
Batch |
Určuje charakteristiky dočasného automatického fondu. Služba Batch vytvoří tento automatický fond při odeslání úlohy. |
|
Batch |
Konfigurace pro fondy s podporou kontejneru. |
|
Batch |
Určuje dočasné nastavení disku pro disk operačního systému používaný výpočetním uzlem (VM). |
|
Batch |
Chybová odpověď přijatá ze služby Azure Batch. |
|
Batch |
Další informace zahrnutá v odpovědi na chybu v Azure Batch. |
|
Batch |
Chybová zpráva přijatá v odpovědi na chybu v Azure Batch. |
|
Batch |
BatchErrorSourceCategory enumy |
|
Batch |
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. |
|
Batch |
An Azure Batch Job. |
|
Batch |
Omezení provádění pro úlohu. |
|
Batch |
BatchJobDefaultOrder enumy |
|
Batch |
Obsahuje informace o spuštění úlohy v Azure Batch službě. |
|
Batch |
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ů. |
|
Batch |
(Tato vlastnost není ve výchozím nastavení dostupná. Pro více informací kontaktujte podporu) Síťová konfigurace pro úlohu. |
|
Batch |
Ú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ů. |
|
Batch |
Ú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. |
|
Batch |
Při plánování úlohy došlo u služby Batch k chybě. |
|
Batch |
BatchJobState enums |
|
Batch |
Statistika využití prostředků pro úlohu |
|
Batch |
Služba Batch nepřiřazuje k tomuto metadatu žádný význam; je výhradně pro použití uživatelského kódu. |
|
Batch |
Enumy BatchNodeFillType |
|
Batch |
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. |
|
Batch |
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í. |
|
Batch |
BatchNodePlacementPolicyType enumy |
|
Batch |
Nastavení pro disk operačního systému výpočetního uzlu (VM). |
|
Batch |
Konfigurace koncového bodu pro fond. |
|
Batch |
Odkaz na jednu z identit fondu pro šifrování disku. Tato identita se použije pro přístup k trezoru klíčů. |
|
Batch |
Určuje, jak se má úloha přiřadit k fondu. |
|
Batch |
Enums BatchPoolLifetimeOption |
|
Batch |
Specifikace pro vytvoření nového fondu |
|
Batch |
Konfigurace veřejné IP adresy síťové konfigurace fondu. |
|
Batch |
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. |
|
Batch |
Omezení provádění, která se mají použít pro úlohu. |
|
Batch |
Nastavení kontejneru pro úlohu. |
|
Batch |
Enumy TaskFailure |
|
Batch |
Určuje, jak se mají úkoly distribuovat napříč výpočetními uzly. |
|
Batch |
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. |
|
Batch |
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čů. |
|
Batch |
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'. |
|
Caching |
CachingType enums |
|
Cifs |
Informace používané pro připojení k systému souborů CIFS. |
|
Container |
Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh. |
|
Container |
Cesty, které budou připojeny ke kontejneru úlohy kontejneru. |
|
Container |
Privátní registr kontejneru. |
|
Container |
ContainerType enums |
|
Container |
ContainerWorkingDirectory enums |
|
Data |
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. |
|
Diff |
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 |
|
Disk |
Odkaz na klíč spravovaný zákazníkem pro šifrování disku. |
|
Disk |
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. |
|
Disk |
ID prostředku ARM sady šifrování disku. |
|
Disk |
Enums DiskEncryptionTarget |
|
Dynamic |
DynamicVNetAssignmentScope enums |
|
Elevation |
Enumy ElevationLevel |
|
Environment |
Proměnná prostředí, která se má nastavit v procesu úkolu. |
|
Host |
Určuje konkrétní nastavení koncového bodu hostitele. |
|
Host |
Enumy HostEndpointSettingsModeTypes |
|
Inbound |
Enums InboundEndpointProtocol |
|
Ip |
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. |
|
Linux |
Vlastnosti používané k vytvoření uživatelského účtu na výpočetním uzlu s Linuxem |
|
Login |
LoginMode enums |
|
Managed |
Parametry spravovaného disku. |
|
Mount |
Systém souborů, který se má připojit k jednotlivým uzlům. |
|
Name |
Představuje dvojici název-hodnota. |
|
Network |
Konfigurace sítě pro fond. |
|
Network |
Pravidlo skupiny zabezpečení sítě, které se použije u příchozího koncového bodu. |
|
Network |
Enums NetworkSecurityGroupRuleAccess |
|
Nfs |
Informace používané pro připojení k systému souborů NFS. |
|
Output |
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í. |
|
Output |
Specifikuje cíl pro nahrání souboru v rámci Azure blob storage kontejneru. |
|
Output |
Cíl, do kterého se má soubor nahrát. |
|
Output |
OutputFileUploadCondition enums |
|
Output |
Možnosti operace nahrání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést. |
|
Output |
Pár název-hodnota hlavičky HTTP |
|
Proxy |
Určuje nastavení proxyagentu při vytváření virtuálního počítače. |
|
Resource |
Jeden soubor nebo více souborů, které se mají stáhnout do výpočetního uzlu. |
|
Rolling |
Parametry konfigurace použité při postupném upgradu. |
|
Security |
Enumy SecurityEncryptionTypes |
|
Security |
Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů. |
|
Security |
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. |
|
Service |
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. |
|
Storage |
Výčty StorageAccountType |
|
Upgrade |
UpgradeMode enumy |
|
Upgrade |
Popisuje zásady upgradu – automatické, ruční nebo postupné. |
|
User |
Vlastnosti používané k vytvoření uživatele používaného k provádění úloh na Azure Batch Compute Node. |
|
User |
Definice identity uživatele, pod kterou je úloha spuštěna. Zadejte vlastnost userName nebo autoUser, ale ne obojí. |
|
Virtual |
Konfigurace pro Compute Nodes v poolu založeném na infrastruktuře Azure Virtual Machines. |
| VMExtension |
Konfigurace rozšíření virtuálních počítačů. |
|
Windows |
Nastavení operačního systému Windows, které se aplikují na virtuální stroj. |
|
Windows |
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. |
| 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 |
Úroveň zvýšení oprávnění automatického uživatele Výchozí hodnota neníadmin. |
|
| scope |
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 |
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 |
Specifikace Pool pro automatický Pool. |
|
| poolLifetimeOption |
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 |
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 |
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 |
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 |
Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní. |
|
| values |
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 |
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 |
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 |
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 |
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 |
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 |
Podrobnosti o úloze správce úloh, která se má spustit při spuštění úlohy |
||
| jobPreparationTask |
Ú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 |
Ú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 |
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 |
(Tato vlastnost není ve výchozím nastavení dostupná. Pro více informací kontaktujte podporu) Síťová konfigurace pro úlohu. |
||
| onAllTasksComplete |
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 |
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 |
Nastavení fondu přidružené k úloze. |
||
| previousState |
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 |
Aktuální stav úlohy. |
||
| stateTransitionTime |
string (date-time) |
Čas, kdy úloha vstoupila do aktuálního stavu. |
|
| stats |
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 |
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 |
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 |
Omezení, která se vztahují na úkol správce úloh. |
|
| containerSettings |
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 |
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 |
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 |
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 |
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 |
Omezení, která se vztahují na úkol přípravy na práci. |
|
| containerSettings |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Určuje dočasné nastavení disku pro disk operačního systému používaný výpočetním uzlem (VM). |
|
| 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 |
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 |
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 |
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 |
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 |
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 |
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 |
Ú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 |
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 |
Zásady upgradu pro fond. Popisuje zásady upgradu – automatické, ruční nebo postupné. |
|
| userAccounts |
Seznam uživatelských účtů, které se mají vytvořit na každém výpočetním uzlu ve fondu. |
|
| 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 |
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 |
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 |
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 |
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 |
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 |
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 |
Soukromý registr, který obsahuje obraz kontejneru. Toto nastavení lze vynechat, pokud bylo již při tvorbě Poolu k dispozici. |
|
| workingDirectory |
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 | 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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Určuje nastavení profilu zabezpečení pro spravovaný disk. |
|
| 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 |
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 |
Azure File Share pro připojení na každý uzel. Tato vlastnost se vzájemně vylučují se všemi ostatními vlastnostmi. |
|
| 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 |
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 |
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 |
Konfigurace pro koncové body na výpočetních uzlech v dávkovém poolu. |
|
| publicIPAddressConfiguration |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Nastavení koncového bodu IMDS. |
|
| wireServer |
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 |
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 |
Určuje nastavení proxyagentu při vytváření virtuálního počítače. |
|
| securityType |
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 |
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 |
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 |
Určuje režim upgradu na virtuální počítače ve škálovací sadě. |
|
| 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 |
Úroveň nadmořské výšky uživatelského účtu. Výchozí hodnota neníadmin. |
|
| 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 |
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 |
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 |
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 |
Data |
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 |
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 |
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 |
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 |
Konfigurace umístění uzlu pro fond. Tato konfigurace určuje pravidla, jak budou uzly ve fondu fyzicky přiděleny. |
|
| osDisk |
Nastavení pro disk operačního systému virtuálního počítače. |
|
| securityProfile |
Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů. |
|
| 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 |
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 |
Přihlašovací režim pro uživatele. Výchozí je 'batch'. |