Job - Add
Přidá úlohu do zadaného účtu.
Služba Batch podporuje dva způsoby řízení práce provedené jako součást úlohy. V prvním přístupu uživatel určuje úlohu správce úloh. Služba Batch spustí tuto úlohu, jakmile je připravena spustit úlohu. Úloha Správce úloh řídí všechny ostatní úkoly spuštěné v této úloze pomocí rozhraní API úloh. Ve druhém přístupu uživatel přímo řídí provádění úkolů v rámci aktivní úlohy pomocí rozhraní API úloh. Poznámka: Při pojmenování úloh nepoužívejte citlivé informace, jako jsou uživatelská jména nebo názvy tajných projektů. Tyto informace se můžou objevit v protokolech telemetrie, které jsou přístupné technikům podpory Microsoftu.
POST {batchUrl}/jobs?api-version=2024-07-01.20.0
POST {batchUrl}/jobs?timeout={timeout}&api-version=2024-07-01.20.0
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Základní adresa URL pro všechny požadavky služby Azure Batch. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
timeout
|
query |
integer int32 |
Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota. |
Hlavička požadavku
Media Types: "application/json; odata=minimalmetadata"
Name | Vyžadováno | Typ | Description |
---|---|---|---|
client-request-id |
string uuid |
Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Určuje, jestli má server v odpovědi vrátit ID požadavku klienta. |
|
ocp-date |
string date-time-rfc1123 |
Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API. |
Text požadavku
Media Types: "application/json; odata=minimalmetadata"
Name | Vyžadováno | Typ | Description |
---|---|---|---|
id | True |
string |
Řetězec, který jednoznačně identifikuje úlohu v rámci účtu. |
poolInfo | True |
Fond, na kterém služba Batch spouští úlohy. |
|
allowTaskPreemption |
boolean |
Zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou |
|
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). |
||
constraints |
Omezení provádění pro úlohu. |
||
displayName |
string |
Zobrazovaný název úlohy. |
|
jobManagerTask |
Podrobnosti o úloze správce úloh, která se má spustit při spuštění úlohy |
||
jobPreparationTask |
Úkol přípravy úlohy. |
||
jobReleaseTask |
Úloha uvolnění úlohy. |
||
maxParallelTasks |
integer |
Maximální počet úkolů, které lze pro úlohu spustit paralelně. |
|
metadata |
Seznam párů název-hodnota přidružených k úloze jako metadata |
||
networkConfiguration |
Konfigurace sítě pro úlohu. |
||
onAllTasksComplete |
Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. |
||
onTaskFailure |
Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze. |
||
priority |
integer |
Priorita úlohy. |
|
usesTaskDependencies |
boolean |
Určuje, zda úkoly v úloze mohou definovat závislosti na sobě navzájem. Výchozí hodnota je false. |
Odpovědi
Name | Typ | Description |
---|---|---|
201 Created |
Požadavek na službu Batch byl úspěšný. Hlavičky
|
|
Other Status Codes |
Chyba ze služby Batch. |
Zabezpečení
azure_auth
Tok ověřovacího kódu Microsoft Entra OAuth 2.0
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | Zosobnění uživatelského účtu |
Authorization
Typ:
apiKey
V:
header
Příklady
Add a basic job |
Add a complex job |
Add a basic job
Ukázkový požadavek
POST account.region.batch.azure.com/jobs?api-version=2024-07-01.20.0
{
"id": "jobId",
"priority": 0,
"poolInfo": {
"poolId": "poolId"
}
}
Ukázková odpověď
Add a complex job
Ukázkový požadavek
POST account.region.batch.azure.com/jobs?api-version=2024-07-01.20.0
{
"id": "jobId",
"priority": 100,
"constraints": {
"maxWallClockTime": "PT1H",
"maxTaskRetryCount": -1
},
"jobManagerTask": {
"id": "taskId",
"commandLine": "myprogram.exe",
"resourceFiles": [
{
"httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
"filePath": "myprogram.exe"
},
{
"storageContainerUrl": "http://mystorage1.blob.core.windows.net/data?sas",
"filePath": "datafolder"
}
],
"environmentSettings": [
{
"name": "myvariable",
"value": "myvalue"
}
],
"constraints": {
"maxWallClockTime": "PT1H",
"maxTaskRetryCount": 0,
"retentionTime": "PT1H"
},
"requiredSlots": 2,
"killJobOnCompletion": false,
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "admin"
}
},
"runExclusive": true
},
"poolInfo": {
"autoPoolSpecification": {
"autoPoolIdPrefix": "mypool",
"poolLifetimeOption": "job",
"pool": {
"vmSize": "STANDARD_D2S_V3",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.windows amd64",
"windowsConfiguration": {
"enableAutomaticUpdates": false
},
"nodePlacementConfiguration": {
"policy": "zonal"
}
},
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 3,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 2,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"enableAutoScale": false,
"enableInterNodeCommunication": true,
"startTask": {
"commandLine": "myprogram2.exe",
"resourceFiles": [
{
"httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram2.exe?sas",
"filePath": "myprogram2.exe"
}
],
"environmentSettings": [
{
"name": "myvariable",
"value": "myvalue"
}
],
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "admin"
}
},
"maxTaskRetryCount": 2,
"waitForSuccess": true
},
"certificateReferences": [
{
"thumbprint": "0123456789abcdef0123456789abcdef01234567",
"thumbprintAlgorithm": "sha1",
"storeLocation": "localmachine",
"storeName": "Root",
"visibility": [
"task"
]
}
],
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
],
"targetNodeCommunicationMode": "default"
}
}
},
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
]
}
Ukázková odpověď
Definice
Name | Description |
---|---|
Access |
Prostředky služby Batch, ke kterým token uděluje přístup. |
Application |
Odkaz na balíček, který se má nasadit do výpočetních uzlů. |
Authentication |
Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch. |
Automatic |
Parametry konfigurace používané k automatickému upgradu operačního systému. |
Auto |
Určuje charakteristiky dočasného automatického fondu. Služba Batch vytvoří tento automatický fond při odeslání úlohy. |
Auto |
Obor automatického uživatele |
Auto |
Určuje parametry pro automatického uživatele, který spouští úlohu ve službě Batch. |
Azure |
Informace používané k připojení ke kontejneru služby Azure Storage pomocí blobfuse |
Azure |
Informace používané pro připojení ke sdílené složce Azure |
Batch |
Odpověď na chybu přijatá ze služby Azure Batch |
Batch |
Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch |
Caching |
Typ ukládání do mezipaměti pro disk. |
Certificate |
Odkaz na certifikát, který se má nainstalovat na výpočetní uzly ve fondu. |
Certificate |
Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat. |
Certificate |
Které uživatelské účty ve výpočetním uzlu by měly mít přístup k privátním datům certifikátu. |
CIFSMount |
Informace používané pro připojení k systému souborů CIFS. |
Compute |
Jak se úkoly distribuují mezi výpočetní uzly ve fondu. |
Compute |
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. |
Container |
Konfigurace pro fondy s podporou kontejneru. |
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 |
Technologie kontejneru, která se má použít. |
Container |
Umístění pracovního adresáře úlohy kontejneru. |
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 |
Určuje dočasné umístění disku pro disk operačního systému pro všechny výpočetní uzly (virtuální počítače) ve fondu. |
Diff |
Určuje dočasné nastavení disku pro disk operačního systému používaný výpočetním uzlem (VM). |
Disk |
Konfigurace šifrování disku použitá na výpočetní uzly ve fondu. Konfigurace šifrování disků není podporována ve fondu Linuxu vytvořeném s imagí Galerie výpočetních prostředků Azure. |
Disk |
Seznam cílů disku služby Batch bude na výpočetním uzlu šifrovat. |
Dynamic |
Rozsah dynamického přiřazení virtuální sítě. |
Elevation |
Úroveň zvýšení úrovně uživatele |
Environment |
Proměnná prostředí, která se má nastavit v procesu úkolu. |
Error |
V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva. |
Http |
Pár název-hodnota hlavičky HTTP |
Image |
Odkaz na image Azure Virtual Machines Marketplace nebo image galerie výpočetních prostředků Azure Pokud chcete získat seznam všech odkazů na image z Azure Marketplace ověřených službou Azure Batch, podívejte se na operaci Výpis podporovaných imagí. |
Inbound |
Protokol koncového bodu. |
Inbound |
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. |
IPAddress |
Typ zřizování pro veřejné IP adresy pro fond. |
Job |
Přidání úlohy Azure Batch |
Job |
Omezení provádění pro úlohu. |
Job |
Určuje podrobnosti úlohy správce úloh. |
Job |
Konfigurace sítě pro úlohu. |
Job |
Úkol přípravy úlohy, který se má spustit před všemi úkoly úlohy v libovolném výpočetním uzlu. |
Job |
Ú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á. |
Linux |
Vlastnosti používané k vytvoření uživatelského účtu na výpočetním uzlu s Linuxem |
Login |
Režim přihlášení pro uživatele |
Managed |
|
Metadata |
Pár název-hodnota přidružený k prostředku služby Batch. |
Mount |
Systém souborů, který se má připojit k jednotlivým uzlům. |
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 |
Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku |
NFSMount |
Informace používané pro připojení k systému souborů NFS. |
Node |
Určuje, jak fond komunikuje se službou Batch. |
Node |
Konfigurace umístění uzlu pro fond |
Node |
Zásady umístění pro přidělování uzlů ve fondu. |
On |
Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. |
On |
Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze. |
OSDisk |
Nastavení pro disk operačního systému výpočetního uzlu (VM). |
Output |
Specifikace pro nahrání souborů z výpočetního uzlu Služby Azure Batch do jiného umístění po dokončení provádění procesu úlohy |
Output |
Určuje cíl nahrání souboru v kontejneru úložiště objektů blob v Azure. |
Output |
Cíl, do kterého se má soubor nahrát. |
Output |
Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů. |
Output |
Podrobnosti o operaci nahrávání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést. |
Pool |
Konfigurace koncového bodu pro fond. |
Pool |
Určuje, jak se má úloha přiřadit k fondu. |
Pool |
Minimální životnost vytvořených automatických fondů a způsob přiřazení více úloh podle plánu fondům. |
Pool |
Specifikace pro vytvoření nového fondu |
Public |
Konfigurace veřejné IP adresy síťové konfigurace fondu. |
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 |
Určuje Typ šifrování spravovaného disku. Je nastavená na VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: Je možné ji nastavit jenom pro důvěrné virtuální počítače a je vyžadována při použití důvěrných virtuálních počítačů. |
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. |
Start |
Úloha, která se spustí při připojení uzlu k fondu ve službě Azure Batch nebo při restartování nebo obnovení výpočetního uzlu. |
Storage |
Typ účtu úložiště pro použití při vytváření datových disků nebo disku s operačním systémem. |
Task |
Omezení provádění, která se mají použít pro úlohu. |
Task |
Nastavení kontejneru pro úlohu. |
Task |
Určuje, jak se mají úkoly distribuovat napříč výpočetními uzly. |
Uefi |
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. |
Upgrade |
Určuje režim upgradu na virtuální počítače ve škálovací sadě. |
Upgrade |
Popisuje zásady upgradu – automatické, ruční nebo postupné. |
User |
Vlastnosti používané k vytvoření uživatele, který se používá ke spouštění úkolů na výpočetním uzlu služby Azure Batch. |
User |
Definice identity uživatele, pod kterou je úloha spuštěna. |
Virtual |
Konfigurace výpočetních uzlů ve fondu založená na infrastruktuře virtuálních počítačů Azure. |
VMDisk |
Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Je možné ji nastavit pouze pro důvěrné virtuální počítače a vyžadovat ji při použití důvěrných virtuálních počítačů. |
VMExtension |
Konfigurace rozšíření virtuálních počítačů. |
Windows |
Nastavení operačního systému Windows, které se má použít na virtuální počítač. |
Windows |
Vlastnosti používané k vytvoření uživatelského účtu na výpočetním uzlu Windows |
AccessScope
Prostředky služby Batch, ke kterým token uděluje přístup.
Name | Typ | Description |
---|---|---|
job |
string |
Uděluje přístup k provádění všech operací v úloze obsahující úkol. |
ApplicationPackageReference
Odkaz na balíček, který se má nasadit do výpočetních uzlů.
Name | Typ | Description |
---|---|---|
applicationId |
string |
ID aplikace, která se má nasadit. |
version |
string |
Verze aplikace, která se má nasadit. Pokud tuto hodnotu vynecháte, nasadí se výchozí verze. |
AuthenticationTokenSettings
Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch.
Name | Typ | Description |
---|---|---|
access |
Prostředky služby Batch, ke kterým token uděluje přístup. |
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. |
AutoPoolSpecification
Určuje charakteristiky dočasného automatického fondu. Služba Batch vytvoří tento automatický fond při odeslání úlohy.
Name | Typ | Description |
---|---|---|
autoPoolIdPrefix |
string |
Předpona, která se má přidat k jedinečnému identifikátoru při automatickém vytvoření fondu. |
keepAlive |
boolean |
Určuje, jestli se má automatický fond udržovat naživu po vypršení jeho životnosti. |
pool |
Specifikace fondu pro automatický fond. |
|
poolLifetimeOption |
Minimální životnost vytvořených automatických fondů a způsob přiřazení více úloh podle plánu fondům. |
AutoUserScope
Obor automatického uživatele
Name | Typ | Description |
---|---|---|
pool |
string |
Určuje, že úloha se spustí jako běžný účet automatického uživatele, který se vytvoří na každém výpočetním uzlu ve fondu. |
task |
string |
Určuje, že služba by měla pro úlohu vytvořit nového uživatele. |
AutoUserSpecification
Určuje parametry pro automatického uživatele, který spouští úlohu ve službě Batch.
Name | Typ | Description |
---|---|---|
elevationLevel |
Úroveň zvýšení oprávnění automatického uživatele |
|
scope |
Obor automatického uživatele |
AzureBlobFileSystemConfiguration
Informace používané k připojení ke kontejneru služby Azure Storage pomocí blobfuse
Name | Typ | Description |
---|---|---|
accountKey |
string |
Klíč účtu úložiště Azure. |
accountName |
string |
Název účtu úložiště Azure. |
blobfuseOptions |
string |
Další možnostipříkazového |
containerName |
string |
Název kontejneru služby Azure Blob Storage. |
identityReference |
Odkaz na identitu přiřazenou uživatelem pro přístup k názvu kontejneru |
|
relativeMountPath |
string |
Relativní cesta na výpočetním uzlu, kde se připojí systém souborů |
sasKey |
string |
Token SAS služby Azure Storage. |
AzureFileShareConfiguration
Informace používané pro připojení ke sdílené složce Azure
Name | Typ | Description |
---|---|---|
accountKey |
string |
Klíč účtu služby Azure Storage. |
accountName |
string |
Název účtu služby Azure Storage. |
azureFileUrl |
string |
Adresa URL služby Soubory Azure. |
mountOptions |
string |
Další možnostipříkazového |
relativeMountPath |
string |
Relativní cesta na výpočetním uzlu, kde se připojí systém souborů |
BatchError
Odpověď na chybu přijatá ze služby Azure Batch
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby. Kódy jsou invariantní a mají být využity programově. |
message |
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
Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
Name | Typ | Description |
---|---|---|
key |
string |
Identifikátor určující význam vlastnosti Value. |
value |
string |
Další informace zahrnuté v odpovědi na chybu. |
CachingType
Typ ukládání do mezipaměti pro disk.
Name | Typ | Description |
---|---|---|
none |
string |
Režim ukládání do mezipaměti disku není povolený. |
readonly |
string |
Režim ukládání do mezipaměti disku je jen pro čtení. |
readwrite |
string |
Režim ukládání do mezipaměti disku je čtení a zápis. |
CertificateReference
Odkaz na certifikát, který se má nainstalovat na výpočetní uzly ve fondu.
Name | Typ | Description |
---|---|---|
storeLocation |
Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat. |
|
storeName |
string |
Název úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat. |
thumbprint |
string |
Kryptografický otisk certifikátu. |
thumbprintAlgorithm |
string |
Algoritmus, ke kterému je kryptografický otisk přidružený. To musí být sha1. |
visibility |
Které uživatelské účty ve výpočetním uzlu by měly mít přístup k privátním datům certifikátu. |
CertificateStoreLocation
Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.
Name | Typ | Description |
---|---|---|
currentuser |
string |
Certifikáty by se měly nainstalovat do úložiště certifikátů CurrentUser. |
localmachine |
string |
Certifikáty by se měly nainstalovat do úložiště certifikátů LocalMachine. |
CertificateVisibility
Které uživatelské účty ve výpočetním uzlu by měly mít přístup k privátním datům certifikátu.
Name | Typ | Description |
---|---|---|
remoteuser |
string |
Certifikát by měl být viditelný pro uživatelské účty, ve kterých uživatelé vzdáleně přistupuje k výpočetnímu uzlu. |
starttask |
string |
Certifikát by měl být viditelný pro uživatelský účet, pod kterým se spouští StartTask. Všimněte si, že pokud je obor automatického uživatele fondem pro starttask i úlohu, bude tento certifikát viditelný i pro úlohu. |
task |
string |
Certifikát by měl být viditelný pro uživatelské účty, ve kterých se spouští úlohy. |
CIFSMountConfiguration
Informace používané pro připojení k systému souborů CIFS.
Name | Typ | Description |
---|---|---|
mountOptions |
string |
Další možnostipříkazového |
password |
string |
Heslo, které se má použít k ověřování v systému souborů CIFS. |
relativeMountPath |
string |
Relativní cesta na výpočetním uzlu, kde se připojí systém souborů |
source |
string |
Identifikátor URI systému souborů, který se má připojit. |
username |
string |
Uživatel, který se má použít k ověřování v systému souborů CIFS. |
ComputeNodeFillType
Jak se úkoly distribuují mezi výpočetní uzly ve fondu.
Name | Typ | Description |
---|---|---|
pack |
string |
Co nejvíce úkolů (taskSlotsPerNode) by mělo být přiřazeno každému výpočetnímu uzlu ve fondu předtím, než se všechny úkoly přiřadí k dalšímu výpočetnímu uzlu ve fondu. |
spread |
string |
Úkoly by měly být přiřazeny rovnoměrně napříč všemi výpočetními uzly ve fondu. |
ComputeNodeIdentityReference
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel.
Name | Typ | Description |
---|---|---|
resourceId |
string |
ID prostředku ARM identity přiřazené uživatelem. |
ContainerConfiguration
Konfigurace pro fondy s podporou kontejneru.
Name | Typ | Description |
---|---|---|
containerImageNames |
string[] |
Kolekce názvů imagí kontejneru. |
containerRegistries |
Další privátní registry, ze kterých je možné načíst kontejnery. |
|
type |
Technologie kontejneru, která se má použít. |
ContainerHostBatchBindMountEntry
Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh.
Name | Typ | Description |
---|---|---|
isReadOnly |
boolean |
Připojte tuto zdrojovou cestu jako režim jen pro čtení nebo ne. Výchozí hodnota je false (režim čtení a zápisu). |
source |
Cestu, která se připojí k zákazníkovi kontejneru, může vybrat. |
ContainerHostDataPath
Cesty, které budou připojeny ke kontejneru úlohy kontejneru.
Name | Typ | Description |
---|---|---|
Applications |
string |
Cesta k aplikacím. |
JobPrep |
string |
Cesta úkolu přípravy úlohy. |
Shared |
string |
Cesta pro úlohu s více instancemi ke sdílení souborů. |
Startup |
string |
Cesta ke spouštěcímu úkolu. |
Task |
string |
Cesta k úkolu. |
VfsMounts |
string |
Cesta obsahuje všechny virtuální systémy souborů, které jsou připojené k tomuto uzlu. |
ContainerRegistry
Privátní registr kontejneru.
Name | Typ | Description |
---|---|---|
identityReference |
Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup ke službě Azure Container Registry místo uživatelského jména a hesla. |
|
password |
string |
Heslo pro přihlášení k serveru registru. |
registryServer |
string |
Adresa URL registru. |
username |
string |
Uživatelské jméno pro přihlášení k serveru registru. |
ContainerType
Technologie kontejneru, která se má použít.
Name | Typ | Description |
---|---|---|
criCompatible |
string |
Ke spuštění kontejnerů se použije technologie založená na CRI. |
dockerCompatible |
string |
Ke spuštění kontejnerů se použije technologie kompatibilní s Dockerem. |
ContainerWorkingDirectory
Umístění pracovního adresáře úlohy kontejneru.
Name | Typ | Description |
---|---|---|
containerImageDefault |
string |
Použijte pracovní adresář definovaný v imagi kontejneru. Mějte na pozor, že tento adresář nebude obsahovat soubory prostředků stažené službou Batch. |
taskWorkingDirectory |
string |
Použijte standardní pracovní adresář úlohy služby Batch, který bude obsahovat soubory zdrojů úkolů naplněné službou Batch. |
DataDisk
Nastavení, která budou používat datové disky přidružené k výpočetním uzlům ve fondu. Při použití připojených datových disků je potřeba disky připojit a naformátovat z virtuálního počítače, aby je bylo možné použít.
Name | Typ | Description |
---|---|---|
caching |
Typ ukládání do mezipaměti, který se má povolit pro datové disky. |
|
diskSizeGB |
integer |
Počáteční velikost disku v gigabajtech. |
lun |
integer |
Číslo logické jednotky. |
storageAccountType |
Typ účtu úložiště, který se má použít pro datový disk. |
DiffDiskPlacement
Určuje dočasné umístění disku pro disk operačního systému pro všechny výpočetní uzly (virtuální počítače) ve fondu.
Name | Typ | Description |
---|---|---|
CacheDisk |
string |
Dočasný disk s operačním systémem je uložený v mezipaměti virtuálního počítače. |
DiffDiskSettings
Určuje dočasné nastavení disku pro disk operačního systému používaný výpočetním uzlem (VM).
Name | Typ | Description |
---|---|---|
placement |
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. |
DiskEncryptionConfiguration
Konfigurace šifrování disku použitá na výpočetní uzly ve fondu. Konfigurace šifrování disků není podporována ve fondu Linuxu vytvořeném s imagí Galerie výpočetních prostředků Azure.
Name | Typ | Description |
---|---|---|
targets |
Seznam cílů disku služby Batch bude na výpočetním uzlu šifrovat. |
DiskEncryptionTarget
Seznam cílů disku služby Batch bude na výpočetním uzlu šifrovat.
Name | Typ | Description |
---|---|---|
osdisk |
string |
Disk s operačním systémem na výpočetním uzlu je šifrovaný. |
temporarydisk |
string |
Dočasný disk na výpočetním uzlu je šifrovaný. V Linuxu se toto šifrování vztahuje na jiné oddíly (například oddíly na připojených datových discích), když dojde k šifrování při spuštění. |
DynamicVNetAssignmentScope
Rozsah dynamického přiřazení virtuální sítě.
Name | Typ | Description |
---|---|---|
job |
string |
Dynamické přiřazení virtuální sítě se provádí pro každou úlohu. |
none |
string |
Není povolené žádné dynamické přiřazení virtuální sítě. |
ElevationLevel
Úroveň zvýšení úrovně uživatele
Name | Typ | Description |
---|---|---|
admin |
string |
Uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce. |
nonadmin |
string |
Uživatel je standardní uživatel bez zvýšeného přístupu. |
EnvironmentSetting
Proměnná prostředí, která se má nastavit v procesu úkolu.
Name | Typ | Description |
---|---|---|
name |
string |
Název proměnné prostředí. |
value |
string |
Hodnota proměnné prostředí. |
ErrorMessage
V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
Name | Typ | Description |
---|---|---|
lang |
string |
Kód jazyka chybové zprávy |
value |
string |
Text zprávy. |
HttpHeader
Pár název-hodnota hlavičky HTTP
Name | Typ | Description |
---|---|---|
name |
string |
Název hlavičky bez rozlišování malých a velkých písmen, který se má použít při nahrávání výstupních souborů |
value |
string |
Hodnota hlavičky, která se má použít při nahrávání výstupních souborů |
ImageReference
Odkaz na image Azure Virtual Machines Marketplace nebo image galerie výpočetních prostředků Azure Pokud chcete získat seznam všech odkazů na image z Azure Marketplace ověřených službou Azure Batch, podívejte se na operaci Výpis podporovaných imagí.
Name | Typ | Description |
---|---|---|
communityGalleryImageId |
string |
Jedinečný identifikátor obrázku galerie komunity |
exactVersion |
string |
Konkrétní verze image platformy nebo image marketplace použité k vytvoření uzlu. Toto pole jen pro čtení se liší od verze pouze v případě, že hodnota zadaná pro verzi při vytvoření fondu byla "latest". |
offer |
string |
Typ nabídky image Azure Virtual Machines Marketplace. |
publisher |
string |
Vydavatel image Azure Virtual Machines Marketplace. |
sharedGalleryImageId |
string |
Jedinečný identifikátor obrázku sdílené galerie |
sku |
string |
Skladová položka image Azure Virtual Machines Marketplace. |
version |
string |
Verze image Azure Virtual Machines Marketplace. |
virtualMachineImageId |
string |
Identifikátor prostředku ARM image galerie výpočetních prostředků Azure. Výpočetní uzly ve fondu se vytvoří pomocí tohoto ID image. Toto je formulář /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} nebo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} pro vždy výchozí nastavení nejnovější verze image. |
InboundEndpointProtocol
Protokol koncového bodu.
Name | Typ | Description |
---|---|---|
tcp |
string |
Pro koncový bod použijte protokol TCP. |
udp |
string |
Pro koncový bod použijte UDP. |
InboundNATPool
Příchozí fond překladu adres (NAT), který lze použít k externímu řešení konkrétních portů na výpočetních uzlech ve fondu Batch.
Name | Typ | Description |
---|---|---|
backendPort |
integer |
Číslo portu ve výpočetním uzlu. |
frontendPortRangeEnd |
integer |
Poslední číslo portu v rozsahu externích portů, které se použijí k poskytování příchozího přístupu k back-endPortu na jednotlivých výpočetních uzlech. |
frontendPortRangeStart |
integer |
První číslo portu v rozsahu externích portů, které se použije k poskytování příchozího přístupu k back-endPortu na jednotlivých výpočetních uzlech. |
name |
string |
Název koncového bodu |
networkSecurityGroupRules |
Seznam pravidel skupiny zabezpečení sítě, která se použijí na koncový bod. |
|
protocol |
Protokol koncového bodu. |
IPAddressProvisioningType
Typ zřizování pro veřejné IP adresy pro fond.
Name | Typ | Description |
---|---|---|
batchmanaged |
string |
Služba Batch vytvoří a spravuje veřejnou IP adresu. V závislosti na velikosti fondu může existovat několik veřejných IP adres. |
nopublicipaddresses |
string |
Nebude vytvořena žádná veřejná IP adresa. |
usermanaged |
string |
Veřejné IP adresy poskytuje uživatel a použije se ke zřízení výpočetních uzlů. |
JobAddParameter
Přidání úlohy Azure Batch
Name | Typ | Default value | Description |
---|---|---|---|
allowTaskPreemption |
boolean |
Zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou |
|
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). |
||
constraints |
Omezení provádění pro úlohu. |
||
displayName |
string |
Zobrazovaný název úlohy. |
|
id |
string |
Řetězec, který jednoznačně identifikuje úlohu v rámci účtu. |
|
jobManagerTask |
Podrobnosti o úloze správce úloh, která se má spustit při spuštění úlohy |
||
jobPreparationTask |
Úkol přípravy úlohy. |
||
jobReleaseTask |
Úloha uvolnění úlohy. |
||
maxParallelTasks |
integer |
-1 |
Maximální počet úkolů, které lze pro úlohu spustit paralelně. |
metadata |
Seznam párů název-hodnota přidružených k úloze jako metadata |
||
networkConfiguration |
Konfigurace sítě pro úlohu. |
||
onAllTasksComplete |
Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. |
||
onTaskFailure |
Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze. |
||
poolInfo |
Fond, na kterém služba Batch spouští úlohy. |
||
priority |
integer |
Priorita úlohy. |
|
usesTaskDependencies |
boolean |
Určuje, zda úkoly v úloze mohou definovat závislosti na sobě navzájem. Výchozí hodnota je false. |
JobConstraints
Omezení provádění pro úlohu.
Name | Typ | Description |
---|---|---|
maxTaskRetryCount |
integer |
Maximální počet opakování každého úkolu Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. |
maxWallClockTime |
string |
Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku vytvoření úlohy. |
JobManagerTask
Určuje podrobnosti úlohy správce úloh.
Name | Typ | Description |
---|---|---|
allowLowPriorityNode |
boolean |
Určuje, jestli se úloha Správce úloh může spouštět na výpočetním uzlu s nízkou prioritou. |
applicationPackageReferences |
Seznam balíčků aplikací, které služba Batch nasadí do výpočetního uzlu před spuštěním příkazového řádku. |
|
authenticationTokenSettings |
Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch. |
|
commandLine |
string |
Příkazový řádek úlohy Správce úloh. |
constraints |
Omezení, která platí pro úlohu Správce úloh. |
|
containerSettings |
Nastavení kontejneru, pod kterým běží úloha Správce úloh. |
|
displayName |
string |
Zobrazovaný název úlohy Správce úloh. |
environmentSettings |
Seznam nastavení proměnných prostředí pro úlohu Správce úloh. |
|
id |
string |
Řetězec, který jednoznačně identifikuje úlohu Správce úloh v rámci úlohy. |
killJobOnCompletion |
boolean |
Určuje, zda dokončení úlohy správce úloh označuje dokončení celé úlohy. |
outputFiles |
Seznam souborů, které služba Batch nahraje z výpočetního uzlu po spuštění příkazového řádku |
|
requiredSlots |
integer |
Počet slotů plánování, které úloha vyžaduje ke spuště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. |
|
runExclusive |
boolean |
Určuje, jestli úloha Správce úloh vyžaduje výhradní použití výpočetního uzlu, na kterém běží. |
userIdentity |
Identita uživatele, pod kterou se spouští úloha Správce úloh. |
JobNetworkConfiguration
Konfigurace sítě pro úlohu.
Name | Typ | Description |
---|---|---|
skipWithdrawFromVNet |
boolean |
Určuje, jestli se mají výpočetní uzly z virtuální sítě stahovat do DNC při ukončení nebo odstranění úlohy. |
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. |
JobPreparationTask
Úkol přípravy úlohy, který se má spustit před všemi úkoly úlohy v libovolném výpočetním uzlu.
Name | Typ | Description |
---|---|---|
commandLine |
string |
Příkazový řádek úkolu přípravy úlohy. |
constraints |
Omezení, která platí pro úkol přípravy úlohy. |
|
containerSettings |
Nastavení kontejneru, pod kterým se spouští úloha přípravy úlohy. |
|
environmentSettings |
Seznam nastavení proměnných prostředí pro úkol přípravy úlohy. |
|
id |
string |
Řetězec, který jednoznačně identifikuje úkol přípravy úlohy v rámci úlohy. |
rerunOnNodeRebootAfterSuccess |
boolean |
Jestli má služba Batch po restartování výpočetního uzlu znovu spustit úlohu přípravy úlohy. |
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. |
|
userIdentity |
Identita uživatele, pod kterou se spouští úloha přípravy úlohy. |
|
waitForSuccess |
boolean |
Jestli má služba Batch čekat na úspěšné dokončení úlohy přípravy úlohy před naplánování všech ostatních úkolů úlohy na výpočetním uzlu. Úloha přípravy úlohy se úspěšně dokončila, pokud se ukončí s ukončovacím kódem 0. |
JobReleaseTask
Úloha uvolnění úlohy, která se má spustit při dokončení úlohy na libovolném výpočetním uzlu, na kterém je úloha spuštěná.
Name | Typ | Description |
---|---|---|
commandLine |
string |
Příkazový řádek úlohy uvolnění úlohy. |
containerSettings |
Nastavení kontejneru, pod kterým běží úloha uvolnění úlohy. |
|
environmentSettings |
Seznam nastavení proměnných prostředí pro úlohu uvolnění úlohy. |
|
id |
string |
Řetězec, který jednoznačně identifikuje úlohu uvolnění úlohy v rámci úlohy. |
maxWallClockTime |
string |
Maximální uplynulý čas, po který může úloha uvolnění úlohy běžet na daném výpočetním uzlu měřená od okamžiku spuštění úlohy. Pokud se úkol nedokončí v časovém limitu, služba Batch ji ukončí. Výchozí hodnota je 15 minut. Časový limit nesmí být delší než 15 minut. Pokud to uděláte, služba Batch ji odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek). |
resourceFiles |
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. |
|
retentionTime |
string |
Minimální doba uchování adresáře úloh pro úlohu uvolnění úlohy na výpočetním uzlu. Po této době může služba Batch odstranit adresář úloh a veškerý jeho obsah. |
userIdentity |
Identita uživatele, pod kterou se spouští úloha uvolnění úlohy. |
LinuxUserConfiguration
Vlastnosti používané k vytvoření uživatelského účtu na výpočetním uzlu s Linuxem
Name | Typ | Description |
---|---|---|
gid |
integer |
ID skupiny pro uživatelský účet. |
sshPrivateKey |
string |
Privátní klíč SSH pro uživatelský účet. |
uid |
integer |
ID uživatele uživatelského účtu. |
LoginMode
Režim přihlášení pro uživatele
Name | Typ | Description |
---|---|---|
batch |
string |
Režim přihlášení LOGON32_LOGON_BATCH Win32. Režim dávkového přihlášení se doporučuje pro dlouhotrvající paralelní procesy. |
interactive |
string |
Režim přihlášení LOGON32_LOGON_INTERACTIVE Win32. Řízení uživatelských účtů je povolené ve fondech Windows. Pokud se tato možnost používá se zvýšenou identitou uživatele ve fondu Windows, relace uživatele nebude zvýšena, pokud není aplikace spuštěná příkazovým řádkem úlohy nakonfigurovaná tak, aby vždy vyžadovala oprávnění správce nebo aby vždy vyžadovala maximální oprávnění. |
ManagedDisk
Name | Typ | Description |
---|---|---|
securityProfile |
Určuje nastavení profilu zabezpečení pro spravovaný disk. |
|
storageAccountType |
Typ účtu úložiště pro spravovaný disk. |
MetadataItem
Pár název-hodnota přidružený k prostředku služby Batch.
Name | Typ | Description |
---|---|---|
name |
string |
Název položky metadat. |
value |
string |
Hodnota položky metadat. |
MountConfiguration
Systém souborů, který se má připojit k jednotlivým uzlům.
Name | Typ | Description |
---|---|---|
azureBlobFileSystemConfiguration |
Kontejner azure Storage, který se má připojit pomocí FUSE objektů blob na každém uzlu. |
|
azureFileShareConfiguration |
Sdílená složka Azure, která se má připojit k jednotlivým uzlům. |
|
cifsMountConfiguration |
Systém souborů CIFS/SMB, který se má připojit k jednotlivým uzlům. |
|
nfsMountConfiguration |
Systém souborů NFS, který se má připojit ke každému uzlu. |
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. |
endpointConfiguration |
Konfigurace koncových bodů na výpočetních uzlech ve fondu Batch |
|
publicIPAddressConfiguration |
Konfigurace Public IPAddress pro výpočetní uzly ve fondu Batch. |
|
subnetId |
string |
Identifikátor prostředku ARM podsítě virtuální sítě, ke které se připojí výpočetní uzly fondu. Toto je formulář /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. |
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 |
Priorita tohoto pravidla. |
sourceAddressPrefix |
string |
Předpona zdrojové adresy nebo značka odpovídající pravidlu. |
sourcePortRanges |
string[] |
Rozsahy zdrojových portů, které se mají shodovat s pravidlem. |
NetworkSecurityGroupRuleAccess
Akce, která by se měla provést pro zadanou IP adresu, rozsah podsítě nebo značku
Name | Typ | Description |
---|---|---|
allow |
string |
Povolit přístup. |
deny |
string |
Odepřít přístup. |
NFSMountConfiguration
Informace používané pro připojení k systému souborů NFS.
Name | Typ | Description |
---|---|---|
mountOptions |
string |
Další možnostipříkazového |
relativeMountPath |
string |
Relativní cesta na výpočetním uzlu, kde se připojí systém souborů |
source |
string |
Identifikátor URI systému souborů, který se má připojit. |
NodeCommunicationMode
Určuje, jak fond komunikuje se službou Batch.
Name | Typ | Description |
---|---|---|
classic |
string |
Uzly používající klasický komunikační režim vyžadují příchozí komunikaci TCP na portech 29876 a 29877 z modulu BatchNodeManagement. Značka služby {region} a odchozí komunikace TCP na portu 443 s "Storage.region" a BatchNodeManagement. Značky služeb {region}. |
default |
string |
Režim komunikace uzlu je automaticky nastaven službou Batch. |
simplified |
string |
Uzly používající zjednodušený režim komunikace vyžadují odchozí komunikaci TCP na portu 443 s BatchNodeManagement. Značka služby {region}. Nejsou vyžadovány žádné otevřené příchozí porty. |
NodePlacementConfiguration
Konfigurace umístění uzlu pro fond
Name | Typ | Description |
---|---|---|
policy |
Typ zásad umístění uzlu ve fondech batch |
NodePlacementPolicyType
Zásady umístění pro přidělování uzlů ve fondu.
Name | Typ | Description |
---|---|---|
regional |
string |
Všechny uzly ve fondu budou přiděleny ve stejné oblasti. |
zonal |
string |
Uzly ve fondu budou rozloženy mezi různé zóny dostupnosti s vyrovnáváním maximálního úsilí. |
OnAllTasksComplete
Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu.
Name | Typ | Description |
---|---|---|
noaction |
string |
Nic nedělejte. Úloha zůstane aktivní, pokud není ukončena nebo zakázána jinými prostředky. |
terminatejob |
string |
Ukončete úlohu. Funkce terminateReason je nastavená na AllTasksComplete. |
OnTaskFailure
Akce, kterou má služba Batch provést, když selže jakýkoli úkol v úloze.
Name | Typ | Description |
---|---|---|
noaction |
string |
Nic nedělejte. Úloha zůstane aktivní, pokud není ukončena nebo zakázána jinými prostředky. |
performexitoptionsjobaction |
string |
Proveďte akci přidruženou k podmínce ukončení úlohy v kolekci ExitConditions úlohy. (To může vést k tomu, že se neprovedou žádné akce, pokud to určuje úkol.) |
OSDisk
Nastavení pro disk operačního systému výpočetního uzlu (VM).
Name | Typ | Description |
---|---|---|
caching |
Určuje požadavky na ukládání do mezipaměti. Možné hodnoty jsou: None, ReadOnly, ReadWrite. Výchozí hodnoty jsou: Žádné pro úložiště úrovně Standard. Jen pro čtení pro Premium Storage. |
|
diskSizeGB |
integer |
Počáteční velikost disku v GB při vytváření nového disku s operačním systémem |
ephemeralOSDiskSettings |
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. |
OutputFile
Specifikace pro nahrání souborů z výpočetního uzlu Služby Azure Batch do jiného umístění po dokončení provádění procesu úlohy
Name | Typ | Description |
---|---|---|
destination |
Cíl výstupních souborů |
|
filePattern |
string |
Vzor označující, které soubory se mají nahrát. |
uploadOptions |
Další možnosti operace nahrávání, včetně toho, za jakých podmínek se má nahrávání provést. |
OutputFileBlobContainerDestination
Určuje cíl nahrání souboru v kontejneru úložiště objektů blob v Azure.
Name | Typ | Description |
---|---|---|
containerUrl |
string |
Adresa URL kontejneru ve službě Azure Blob Storage, do které se mají nahrát soubory. |
identityReference |
Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup ke službě Azure Blob Storage určenou pomocí containerUrl |
|
path |
string |
Cílový objekt blob nebo virtuální adresář v rámci kontejneru Azure Storage. |
uploadHeaders |
Seznam párů název-hodnota pro hlavičky, které se mají použít při nahrávání výstupních souborů |
OutputFileDestination
Cíl, do kterého se má soubor nahrát.
Name | Typ | Description |
---|---|---|
container |
Umístění v úložišti objektů blob v Azure, do kterého se soubory nahrají. |
OutputFileUploadCondition
Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů.
Name | Typ | Description |
---|---|---|
taskcompletion |
string |
Po ukončení procesu úkolu nahrajte soubory bez ohledu na to, co byl ukončovací kód. |
taskfailure |
string |
Nahrajte soubory až po ukončení procesu úkolu s nenulovým ukončovacím kódem. |
tasksuccess |
string |
Nahrajte soubory až po ukončení procesu úkolu s ukončovacím kódem 0. |
OutputFileUploadOptions
Podrobnosti o operaci nahrávání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést.
Name | Typ | Description |
---|---|---|
uploadCondition |
Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů. |
PoolEndpointConfiguration
Konfigurace koncového bodu pro fond.
Name | Typ | Description |
---|---|---|
inboundNATPools |
Seznam příchozích fondů překladu adres (NAT), které je možné použít k adresování konkrétních portů na jednotlivých výpočetních uzlech externě. |
PoolInformation
Určuje, jak se má úloha přiřadit k fondu.
Name | Typ | Description |
---|---|---|
autoPoolSpecification |
Charakteristiky dočasného "automatického fondu". Služba Batch vytvoří tento automatický fond při odeslání úlohy. |
|
poolId |
string |
ID existujícího fondu. Všechny úkoly úlohy budou spuštěny v zadaném fondu. |
PoolLifetimeOption
Minimální životnost vytvořených automatických fondů a způsob přiřazení více úloh podle plánu fondům.
Name | Typ | Description |
---|---|---|
job |
string |
Fond existuje po celou dobu životnosti úlohy, pro kterou je vyhrazená. Služba Batch vytvoří fond při vytváření úlohy. Pokud se u plánu úlohy použije možnost Úloha, služba Batch vytvoří nový automatický fond pro každou úlohu vytvořenou v plánu. |
jobschedule |
string |
Fond existuje po celou dobu životnosti plánu úlohy. Služba Batch vytvoří fond, když v plánu vytvoří první úlohu. Tuto možnost můžete použít jenom pro plány úloh, ne pro úlohy. |
PoolSpecification
Specifikace pro vytvoření nového fondu
Name | Typ | Description |
---|---|---|
applicationPackageReferences |
Seznam balíčků, které se mají nainstalovat na každý výpočetní uzel ve fondu. |
|
autoScaleEvaluationInterval |
string |
Časový interval, ve kterém se má velikost fondu automaticky upravit podle vzorce automatického škálování. |
autoScaleFormula |
string |
Vzorec pro požadovaný počet výpočetních uzlů ve fondu. |
certificateReferences |
Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu. Upozornění: Tato vlastnost je zastaralá a bude odebrána po únoru 2024. Místo toho použijte |
|
displayName |
string |
Zobrazovaný název fondu. |
enableAutoScale |
boolean |
Určuje, jestli se velikost fondu má v průběhu času automaticky upravit. |
enableInterNodeCommunication |
boolean |
Určuje, jestli fond povoluje přímou komunikaci mezi výpočetními uzly. |
metadata |
Seznam párů název-hodnota přidružených k fondu jako metadata. |
|
mountConfiguration |
Seznam systémů souborů, které se mají připojit ke každému uzlu ve fondu. |
|
networkConfiguration |
Konfigurace sítě pro fond. |
|
resizeTimeout |
string |
Časový limit přidělení výpočetních uzlů do fondu. |
resourceTags |
object |
Uživatelem zadané značky přidružené k fondu. |
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 |
Požadovaný počet vyhrazených výpočetních uzlů ve fondu. |
targetLowPriorityNodes |
integer |
Požadovaný počet výpočetních uzlů s nízkou prioritou ve fondu |
targetNodeCommunicationMode |
Režim komunikace požadovaného uzlu pro fond. |
|
taskSchedulingPolicy |
Jak se úkoly distribuují mezi výpočetní uzly ve fondu. |
|
taskSlotsPerNode |
integer |
Počet slotů úloh, které lze použít ke spouštění souběžných úloh na jednom výpočetním uzlu ve fondu. |
upgradePolicy |
Zásady upgradu pro fond. |
|
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. |
|
vmSize |
string |
Velikost virtuálních počítačů ve fondu. Všechny virtuální počítače ve fondu mají stejnou velikost. |
PublicIPAddressConfiguration
Konfigurace veřejné IP adresy síťové konfigurace fondu.
Name | Typ | Description |
---|---|---|
ipAddressIds |
string[] |
Seznam veřejných IP adres, které bude služba Batch používat při zřizování výpočetních uzlů. |
provision |
Typ zřizování pro veřejné IP adresy pro fond. |
ResourceFile
Jeden soubor nebo více souborů, které se mají stáhnout do výpočetního uzlu.
Name | Typ | Description |
---|---|---|
autoStorageContainerName |
string |
Název kontejneru úložiště v účtu automatického úložiště. |
blobPrefix |
string |
Předpona objektu blob, která se má použít při stahování objektů blob z kontejneru Azure Storage. Stáhnou se jenom objekty blob, jejichž názvy začínají zadanou předponou. |
fileMode |
string |
Atribut režimu oprávnění souboru v osmičkovém formátu. |
filePath |
string |
Umístění na výpočetním uzlu, ke kterému chcete stáhnout soubory vzhledem k pracovnímu adresáři úlohy. |
httpUrl |
string |
Adresa URL souboru, který chcete stáhnout. |
identityReference |
Odkaz na identitu přiřazenou uživatelem pro přístup ke službě Azure Blob Storage určené službou storageContainerUrl nebo httpUrl |
|
storageContainerUrl |
string |
Adresa URL kontejneru objektů blob v rámci služby Azure Blob Storage. |
RollingUpgradePolicy
Parametry konfigurace použité při postupném upgradu.
Name | Typ | Description |
---|---|---|
enableCrossZoneUpgrade |
boolean |
Povolte VMSS ignorovat hranice AZ při vytváření dávek upgradu. Zvažte aktualizaci domény a maxBatchInstancePercent k určení velikosti dávky. Toto pole je možné nastavit na hodnotu true nebo false pouze při použití NodePlacementConfiguration jako zónového pole. |
maxBatchInstancePercent |
integer |
Maximální procento celkových instancí virtuálních počítačů, které budou upgradovány současně postupným upgradem v jedné dávce. Vzhledem k tomu, že se jedná o maximum, instance, které nejsou v pořádku v předchozích nebo budoucích dávkách, můžou způsobit snížení procenta instancí v dávce, aby se zajistila vyšší spolehlivost. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. |
maxUnhealthyInstancePercent |
integer |
Maximální procento celkových instancí virtuálních počítačů ve škálovací sadě, které může být současně v pořádku, buď v důsledku upgradu, nebo zjištěním stavu, který není v pořádku, kontroluje stav virtuálního počítače před přerušením postupného upgradu. Toto omezení se zkontroluje před spuštěním jakékoli dávky. Hodnota tohoto pole by měla být mezi 5 a 100 včetně. Pokud jsou s hodnotou přiřazeny hodnoty maxBatchInstancePercent i maxUnhealthyInstancePercent, hodnota maxBatchInstancePercent by neměla být vyšší než maxUnhealthyInstancePercent. |
maxUnhealthyUpgradedInstancePercent |
integer |
Maximální procento upgradovanýchinstancích Tato kontrola proběhne po upgradu každé dávky. Pokud se toto procento někdy překročí, průběžná aktualizace se přeruší. Hodnota tohoto pole by měla být v rozmezí od 0 do 100 (včetně). |
pauseTimeBetweenBatches |
string |
Doba čekání mezi dokončením aktualizace pro všechny virtuální počítače v jedné dávce a spuštěním další dávky. Doba trvání by měla být zadána ve formátu ISO 8601. |
prioritizeUnhealthyInstances |
boolean |
Upgradujte všechny instance, které nejsou v pořádku, ve škálovací sadě před všemi instancemi, které jsou v pořádku. |
rollbackFailedInstancesOnPolicyBreach |
boolean |
Vrácení neúspěšných instancí do předchozího modelu v případě porušení zásad postupného upgradu |
SecurityEncryptionTypes
Určuje Typ šifrování spravovaného disku. Je nastavená na VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: Je možné ji nastavit jenom pro důvěrné virtuální počítače a je vyžadována při použití důvěrných virtuálních počítačů.
Name | Typ | Description |
---|---|---|
NonPersistedTPM |
string |
|
VMGuestStateOnly |
string |
SecurityProfile
Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.
Name | Typ | Description |
---|---|---|
encryptionAtHost |
boolean |
Tuto vlastnost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli. Další informace o šifrování v požadavcích na hostitele najdete v tématu https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes. |
securityType |
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. |
SecurityTypes
Určuje typ zabezpečení virtuálního počítače. Aby bylo možné povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu.
Name | Typ | Description |
---|---|---|
confidentialVM |
string |
Důvěrné výpočetní prostředí Azure nabízí důvěrné virtuální počítače pro tenanty s vysokými požadavky na zabezpečení a důvěrnost. Tyto virtuální počítače poskytují silnou hranici vynucenou hardwarem, která pomáhá splnit vaše potřeby zabezpečení. Důvěrné virtuální počítače můžete použít pro migrace, aniž byste museli provádět změny kódu, přičemž platforma chrání stav virtuálního počítače před čtením nebo úpravou. |
trustedLaunch |
string |
Důvěryhodné spuštění chrání před pokročilými a trvalými technikami útoku. |
ServiceArtifactReference
Určuje ID odkazu na artefakt služby použité k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image.
Name | Typ | Description |
---|---|---|
id |
string |
ID odkazu na artefakt služby ServiceArtifactReference |
StartTask
Úloha, která se spustí při připojení uzlu k fondu ve službě Azure Batch nebo při restartování nebo obnovení výpočetního uzlu.
Name | Typ | Description |
---|---|---|
commandLine |
string |
Příkazový řádek StartTask. |
containerSettings |
Nastavení kontejneru, pod kterým běží StartTask. |
|
environmentSettings |
Seznam nastavení proměnných prostředí pro StartTask |
|
maxTaskRetryCount |
integer |
Maximální počet opakování úkolu. |
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. |
|
userIdentity |
Identita uživatele, pod kterou se spouští StartTask. |
|
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. |
StorageAccountType
Typ účtu úložiště pro použití při vytváření datových disků nebo disku s operačním systémem.
Name | Typ | Description |
---|---|---|
premium_lrs |
string |
Datový disk nebo disk s operačním systémem by měl používat místně redundantní úložiště úrovně Premium. |
standard_lrs |
string |
Datový disk nebo disk s operačním systémem by měl používat místně redundantní úložiště úrovně Standard. |
standardssd_lrs |
string |
Datový disk nebo disk s operačním systémem by měl používat místně redundantní úložiště SSD úrovně Standard. |
TaskConstraints
Omezení provádění, která se mají použít pro úlohu.
Name | Typ | Description |
---|---|---|
maxTaskRetryCount |
integer |
Maximální počet opakování úkolu. Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. |
maxWallClockTime |
string |
Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku spuštění úlohy. Pokud se úkol nedokončí v časovém limitu, služba Batch ji ukončí. |
retentionTime |
string |
Minimální doba uchovávání adresáře úloh na výpočetním uzlu, na kterém byl spuštěný, od okamžiku dokončení provádění. Po této době může služba Batch odstranit adresář úloh a veškerý jeho obsah. |
TaskContainerSettings
Nastavení kontejneru pro úlohu.
Name | Typ | Description |
---|---|---|
containerHostBatchBindMounts |
Cesty, které chcete připojit k úloze kontejneru. |
|
containerRunOptions |
string |
Další možnosti příkazu create kontejneru |
imageName |
string |
Image, která se má použít k vytvoření kontejneru, ve kterém se úloha spustí. |
registry |
Privátní registr, který obsahuje image kontejneru. |
|
workingDirectory |
Umístění pracovního adresáře úlohy kontejneru. |
TaskSchedulingPolicy
Určuje, jak se mají úkoly distribuovat napříč výpočetními uzly.
Name | Typ | Description |
---|---|---|
nodeFillType |
Jak se úkoly distribuují mezi výpočetní uzly ve fondu. |
UefiSettings
Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM použité při vytváření virtuálního počítače.
Name | Typ | Description |
---|---|---|
secureBootEnabled |
boolean |
Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění. |
vTpmEnabled |
boolean |
Určuje, jestli má být na virtuálním počítači povolený virtuální počítač vTPM. |
UpgradeMode
Určuje režim upgradu na virtuální počítače ve škálovací sadě.
Možné hodnoty:
Ruční – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade.
Automatické – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně.
rolling – Škálovací sada provádí aktualizace v dávkách s volitelnou dobou pozastavení mezi.
Name | Typ | Description |
---|---|---|
automatic |
string |
Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně. |
manual |
string |
Řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade. |
rolling |
string |
Existující instance ve škálovací sadě se přenesou do dávek, které se mají upgradovat. Po dokončení upgradované dávky začnou instance znovu zabírají provoz a začne další dávka. To pokračuje, dokud se všechny instance nepřenesou up-to-date. |
UpgradePolicy
Popisuje zásady upgradu – automatické, ruční nebo postupné.
Name | Typ | Description |
---|---|---|
automaticOSUpgradePolicy |
Parametry konfigurace používané k provádění automatického 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, který se používá ke spouštění úkolů na výpočetním uzlu služby Azure Batch.
Name | Typ | Description |
---|---|---|
elevationLevel |
Úroveň zvýšení úrovně uživatelského účtu. |
|
linuxUserConfiguration |
Konfigurace uživatele specifická pro Linux pro uživatelský účet. |
|
name |
string |
Jméno uživatelského účtu. Názvy můžou obsahovat libovolné znaky Unicode až do maximální délky 20. |
password |
string |
Heslo pro uživatelský účet. |
windowsUserConfiguration |
Konfigurace uživatele specifická pro Systém Windows pro uživatelský účet. |
UserIdentity
Definice identity uživatele, pod kterou je úloha spuštěna.
Name | Typ | Description |
---|---|---|
autoUser |
Automatický uživatel, pod kterým je úloha spuštěna. |
|
username |
string |
Název identity uživatele, pod kterou je úloha spuštěna. |
VirtualMachineConfiguration
Konfigurace výpočetních uzlů ve fondu založená na infrastruktuře virtuálních počítačů Azure.
Name | Typ | Description |
---|---|---|
containerConfiguration |
Konfigurace kontejneru pro fond. |
|
dataDisks |
Data |
Konfigurace datových disků připojených k výpočetním uzlům ve fondu |
diskEncryptionConfiguration |
Konfigurace šifrování disku pro fond. |
|
extensions |
Rozšíření virtuálního počítače pro fond. |
|
imageReference |
Odkaz na image Azure Virtual Machines Marketplace nebo vlastní image virtuálního počítače, která se má použít. |
|
licenseType |
string |
Typ místní licence, která se má použít při nasazování operačního systému. Windows_Server – místní licence je určená pro Windows Server. Windows_Client – místní licence je určená pro klienta Windows. |
nodeAgentSKUId |
string |
Skladová položka agenta výpočetního uzlu batch, který se má zřídit na výpočetních uzlech ve fondu. |
nodePlacementConfiguration |
Konfigurace umístění uzlu pro fond. |
|
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. |
|
windowsConfiguration |
Nastavení operačního systému Windows na virtuálním počítači. |
VMDiskSecurityProfile
Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Je možné ji nastavit pouze pro důvěrné virtuální počítače a vyžadovat ji při použití důvěrných virtuálních počítačů.
Name | Typ | Description |
---|---|---|
securityEncryptionType |
Určuje Typ šifrování spravovaného disku. Je nastavená na VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: Je možné ji nastavit jenom pro důvěrné virtuální počítače a je vyžadována při použití důvěrných virtuálních počítačů. |
VMExtension
Konfigurace rozšíření virtuálních počítačů.
Name | Typ | Description |
---|---|---|
autoUpgradeMinorVersion |
boolean |
Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true. |
enableAutomaticUpgrade |
boolean |
Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření. |
name |
string |
Název rozšíření virtuálního počítače |
protectedSettings |
object |
Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení. |
provisionAfterExtensions |
string[] |
Kolekce názvů rozšíření. |
publisher |
string |
Název vydavatele obslužné rutiny rozšíření. |
settings |
object |
Veřejná nastavení ve formátu JSON pro rozšíření |
type |
string |
Typ rozšíření. |
typeHandlerVersion |
string |
Verze obslužné rutiny skriptu. |
WindowsConfiguration
Nastavení operačního systému Windows, které se má použít na virtuální počítač.
Name | Typ | Description |
---|---|---|
enableAutomaticUpdates |
boolean |
Určuje, jestli jsou na virtuálním počítači povolené automatické aktualizace. |
WindowsUserConfiguration
Vlastnosti používané k vytvoření uživatelského účtu na výpočetním uzlu Windows
Name | Typ | Description |
---|---|---|
loginMode |
Režim přihlášení pro uživatele |