Job Schedule - Add

Přidá do zadaného účtu plán úlohy.

POST {batchUrl}/jobschedules?api-version=2020-09-01.12.0
POST {batchUrl}/jobschedules?timeout={timeout}&api-version=2020-09-01.12.0

Parametry identifikátoru URI

Name In Required Type Description
batchUrl
path True
  • string

Základní adresa URL všech žádostí Azure Batch služby

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í žádosti (v sekundách). Výchozí hodnota je 30 sekund.

Hlavička požadavku

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

Name Required Type Description
client-request-id
  • string
uuid

Identita žádosti vygenerovaná volajícím, ve formě identifikátoru GUID bez dekorace, jako jsou například složené závorky, např. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id
  • boolean

Určuje, zda má server vrátit požadavek Client-Request-ID v odpovědi.

ocp-date
  • string
date-time-rfc1123

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

Text požadavku

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

Name Required Type Description
id True
  • string

Řetězec, který jedinečně identifikuje plán v rámci účtu.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně spojovníků a podtržítka a nesmí obsahovat více než 64 znaků. ID rozlišuje velká a malá písmena (to znamená, že v rámci účtu nemusíte mít dvě ID, která se liší pouze případem).

jobSpecification True

Podrobnosti o úlohách, které mají být vytvořeny v tomto plánu.

schedule True

Plán, podle kterého budou vytvořeny úlohy.

displayName
  • string

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

metadata

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

Odpovědi

Name Type Description
201 Created

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

Headers

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

Chyba služby Batch.

Zabezpečení

azure_auth

Azure Active Directory tok OAuth2

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

Scopes

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

Authorization

Type: apiKey
In: header

Příklady

Add a basic JobSchedule
Add a complex JobScheduleAdd

Add a basic JobSchedule

Sample Request

POST account.region.batch.azure.com/jobschedules?api-version=2020-09-01.12.0
client-request-id: 00000000-0000-0000-0000-000000000000
ocp-date: Fri, 17 Feb 2017 00:00:00 GMT
{
  "id": "jobScheduleId",
  "schedule": {
    "recurrenceInterval": "PT5M"
  },
  "jobSpecification": {
    "poolInfo": {
      "poolId": "poolId"
    }
  }
}

Sample Response

Add a complex JobScheduleAdd

Sample Request

POST account.region.batch.azure.com/jobschedules?api-version=2020-09-01.12.0
client-request-id: 00000000-0000-0000-0000-000000000000
ocp-date: Fri, 17 Feb 2017 00:00:00 GMT
{
  "id": "jobScheduleId",
  "schedule": {
    "doNotRunUntil": "2014-09-10T02:30:00.000Z",
    "doNotRunAfter": "2014-09-10T06:30:00.000Z",
    "startWindow": "PT1M",
    "recurrenceInterval": "PT5M"
  },
  "jobSpecification": {
    "priority": 100,
    "constraints": {
      "maxWallClockTime": "PT1H",
      "maxTaskRetryCount": -1
    },
    "jobManagerTask": {
      "id": "mytask1",
      "commandLine": "myprogram.exe",
      "resourceFiles": [
        {
          "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
          "filePath": "myprogram.exe"
        },
        {
          "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/test.txt?sas",
          "filePath": "test.txt"
        }
      ],
      "environmentSettings": [
        {
          "name": "myvariable",
          "value": "myvalue"
        }
      ],
      "constraints": {
        "maxWallClockTime": "PT1H",
        "maxTaskRetryCount": 0,
        "retentionTime": "PT1H"
      },
      "requiredSlots": 2,
      "killJobOnCompletion": true,
      "userIdentity": {
        "autoUser": {
          "scope": "task",
          "elevationLevel": "nonadmin"
        }
      },
      "runExclusive": true
    },
    "poolInfo": {
      "autoPoolSpecification": {
        "autoPoolIdPrefix": "mypool",
        "poolLifetimeOption": "jobschedule",
        "pool": {
          "vmSize": "small",
          "cloudServiceConfiguration": {
            "osFamily": "4",
            "osVersion": "*"
          },
          "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"
            }
          ]
        }
      }
    }
  },
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Definice

ApplicationPackageReference

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

AuthenticationTokenSettings

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

AutoPoolSpecification

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

AutoUserScope

Rozsah pro automatického uživatele

AutoUserSpecification

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

AzureBlobFileSystemConfiguration

Informace, které slouží k připojení k Azure Storage kontejneru pomocí Blobfuse.

AzureFileShareConfiguration

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

BatchError

Od služby Azure Batch přijata chybová odpověď.

BatchErrorDetail

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

CachingType

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

CertificateReference

Odkaz na certifikát, který má být nainstalován na výpočetních uzlech ve fondu.

CertificateStoreLocation

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

CIFSMountConfiguration

Informace, které slouží k připojení k systému souborů CIFS.

CloudServiceConfiguration

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

ComputeNodeFillType

Způsob, jakým jsou úlohy distribuovány mezi výpočetní uzly ve fondu.

ContainerConfiguration

Konfigurace pro fondy s povoleným kontejnerem.

ContainerRegistry

Privátní registr kontejnerů.

ContainerType

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

ContainerWorkingDirectory

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

DataDisk

Nastavení, která budou používána datovými disky přidruženými k výpočetním uzlům ve fondu. Pokud používáte připojené datové disky, musíte je připojit a naformátovat na virtuálním počítači, aby je bylo možné použít.

DiskEncryptionConfiguration

Konfigurace šifrování disku použitá na výpočetních uzlech ve fondu. Ve fondu Linux vytvořeném s imagí Galerie sdílených imagí není podporována konfigurace šifrování disku.

DynamicVNetAssignmentScope

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

ElevationLevel

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

EnvironmentSetting

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

ErrorMessage

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

ImageReference

Odkaz na obrázek Azure Virtual Machines Marketplace nebo obrázek Galerie sdílených imagí. Pokud chcete získat seznam všech odkazů na Image Azure Marketplace ověřených pomocí Azure Batch, přečtěte si o operaci "výpis podporovaných imagí".

InboundEndpointProtocol

Protokol koncového bodu.

InboundNATPool

Fond příchozího překladu adres (NAT), který se dá použít k externímu adresování specifických portů na výpočetních uzlech ve fondu služby Batch.

IPAddressProvisioningType

Typ zřizování pro Veřejné IP adresy fondu.

JobConstraints

Omezení spouštění úlohy.

JobManagerTask

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

JobNetworkConfiguration

Konfigurace sítě pro úlohu.

JobPreparationTask

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

JobReleaseTask

Úkol uvolnění úlohy, který se má spustit při dokončení úlohy na jakémkoli výpočetním uzlu, ve kterém se úloha spustila

JobScheduleAddParameter

Plán úlohy, který umožňuje opakované úlohy zadáním, kdy se mají spouštět úlohy a specifikace, která se používá k vytvoření jednotlivých úloh.

JobSpecification

Určuje podrobnosti úloh, které se mají vytvořit podle plánu.

LinuxUserConfiguration

Vlastnosti používané k vytvoření uživatelského účtu na výpočetním uzlu se systémem Linux.

LoginMode

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

MetadataItem

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

MountConfiguration

Systém souborů, který se má připojit na každý uzel.

NetworkConfiguration

Konfigurace sítě pro fond.

NetworkSecurityGroupRule

Pravidlo skupiny zabezpečení sítě, které se má použít u příchozího koncového bodu.

NetworkSecurityGroupRuleAccess

Akce, která má být provedena pro zadanou IP adresu, rozsah podsítě nebo značku.

NFSMountConfiguration

Informace, které slouží k připojení k systému souborů NFS.

OnAllTasksComplete

Akce, kterou by měla služba Batch provést, když jsou všechny úlohy v rámci úlohy v dokončeném stavu.

OnTaskFailure

Akce, kterou by měla služba Batch provést, když dojde k chybě jakékoli úlohy v úloze.

OutputFile

Specifikace pro nahrávání souborů z Azure Batch výpočetního uzlu do jiného umístění poté, co služba Batch dokončila provádění procesu úlohy.

OutputFileBlobContainerDestination

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

OutputFileDestination

Cíl, do kterého má být soubor nahrán.

OutputFileUploadCondition

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

OutputFileUploadOptions

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

PoolEndpointConfiguration

Konfigurace koncového bodu pro fond.

PoolInformation

Určuje, jak má být úloha přiřazena k fondu.

PoolLifetimeOption

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

PoolSpecification

Specifikace pro vytvoření nového fondu.

PublicIPAddressConfiguration

Konfigurace veřejné IP adresy pro síťovou konfiguraci fondu.

ResourceFile

Jeden soubor nebo více souborů, které se mají stáhnout do výpočetního uzlu.

Schedule

Plán, podle kterého budou vytvořeny úlohy

StartTask

Úkol, který se spustí, když se uzel připojí k fondu ve službě Azure Batch, nebo když se výpočetní uzel restartuje nebo obnoví z image.

StorageAccountType

Typ účtu úložiště, který se má použít při vytváření datových disků.

TaskConstraints

Omezení spouštění pro použití pro úlohu.

TaskContainerSettings

Nastavení kontejneru pro úlohu.

TaskSchedulingPolicy

Určuje, jak se mají úlohy distribuovat mezi výpočetními uzly.

UserAccount

Vlastnosti používané k vytvoření uživatele, který se používá ke spouštění úloh na Azure Batch výpočetním uzlu.

UserIdentity

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

VirtualMachineConfiguration

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

WindowsConfiguration

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

WindowsUserConfiguration

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

ApplicationPackageReference

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

Name Type Description
applicationId
  • string

ID aplikace, která se má nasadit

version
  • string

Verze aplikace, která se má nasadit Je-li tento parametr vynechán, je nasazena výchozí verze.
Pokud je tento parametr vynechán v rámci fondu a pro tuto aplikaci není zadána žádná výchozí verze, požadavek se nezdařil s kódem chyby InvalidApplicationPackageReferences a stavovým kódem HTTP 409. Pokud je tato operace vynechána u úlohy a pro tuto aplikaci není zadána žádná výchozí verze, úloha se nezdařila s chybou předběžného zpracování.

AuthenticationTokenSettings

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

Name Type Description
access
  • string[]

Prostředky Batch, ke kterým token uděluje přístup.
Ověřovací token uděluje přístup k omezené sadě operací služby Batch. Aktuálně jediná podporovaná hodnota pro vlastnost Access je "Job", která uděluje přístup ke všem operacím souvisejícím s úlohou, která úlohu obsahuje.

AutoPoolSpecification

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

Name Type Description
autoPoolIdPrefix
  • string

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

keepAlive
  • boolean

Určuje, jestli se má po vypršení platnosti zůstat aktivní fond.
Pokud je hodnota false, služba Batch odstraní fond po jeho vypršení platnosti (podle určení nastavení poolLifetimeOption). To znamená, že když se úloha nebo plán úlohy dokončí. Pokud je hodnota true, služba Batch fond neodstraní automaticky. Je až uživatel, aby se odstranily automatické fondy vytvořené pomocí této možnosti.

pool

Specifikace fondu pro automatický fond.

poolLifetimeOption

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

AutoUserScope

Rozsah pro automatického uživatele

Name Type Description
pool
  • string

Určuje, že se úloha spouští jako společný automatický uživatelský účet, který se vytvoří na všech výpočetních uzlech ve fondu.

task
  • string

Určuje, že by služba 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 Type Description
elevationLevel

Úroveň zvýšení úrovně automatického uživatele.
Výchozí hodnota je nesprávce.

scope

Rozsah pro automatického uživatele
Výchozí hodnota je fond. Pokud fond používá systém Windows, musí být zadána hodnota úlohy, pokud je vyžadována přísnější izolace mezi úkoly. Například pokud úloha prochází registr způsobem, který by mohl ovlivnit jiné úkoly, nebo pokud byly ve fondu zadány certifikáty, které by neměly být přístupné pro běžné úlohy, ale měly by být přístupné pro StartTasks.

AzureBlobFileSystemConfiguration

Informace, které slouží k připojení k Azure Storage kontejneru pomocí Blobfuse.

Name Type Description
accountKey
  • string

Azure Storage klíč účtu.
Tato vlastnost se vzájemně vylučuje s sasKey a jedna musí být zadaná.

accountName
  • string

Název Azure Storage účtu

blobfuseOptions
  • string

Další možnosti příkazového řádku, které se mají předat příkazu Mount
Jedná se o možnosti "net use" v systému Windows a možnosti připojení v systému Linux.

containerName
  • string

Název kontejneru Azure Blob Storage.

relativeMountPath
  • string

Relativní cesta k výpočetnímu uzlu, do kterého bude připojen systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch Mounts, který je přístupný prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.

sasKey
  • string

Token SAS Azure Storage.
Tato vlastnost se vzájemně vylučuje s accountKey a jedna musí být zadaná.

AzureFileShareConfiguration

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

Name Type Description
accountKey
  • string

Azure Storage klíč účtu.

accountName
  • string

Název Azure Storage účtu

azureFileUrl
  • string

Adresa URL souborů Azure.
Toto je ve formátu "https://{účet}. soubor. Core. Windows. NET/".

mountOptions
  • string

Další možnosti příkazového řádku, které se mají předat příkazu Mount
Jedná se o možnosti "net use" v systému Windows a možnosti připojení v systému Linux.

relativeMountPath
  • string

Relativní cesta k výpočetnímu uzlu, do kterého bude připojen systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch Mounts, který je přístupný prostřednictvím proměnné prostředí AZ_BATCH_NODE_MOUNTS_DIR.

BatchError

Od služby Azure Batch přijata chybová odpověď.

Name Type Description
code
  • string

Identifikátor chyby Kódy jsou invariantní a mají být zpracovány 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, které obsahují další podrobnosti o chybě.

BatchErrorDetail

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

Name Type Description
key
  • string

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

value
  • string

Další informace, které jsou součástí chybové odpovědi.

CachingType

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

Name Type Description
none
  • string

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

readonly
  • string

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

readwrite
  • string

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

CertificateReference

Odkaz na certifikát, který má být nainstalován na výpočetních uzlech ve fondu.

Name Type Description
storeLocation

Umístění úložiště certifikátů na výpočetním uzlu, do kterého chcete certifikát nainstalovat.
Výchozí hodnota je CurrentUser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s výpočetními uzly Windows (tj. vytvořené pomocí cloudServiceConfiguration nebo s virtualMachineConfiguration pomocí referenční dokumentace k bitové kopii systému Windows). V případě výpočetních uzlů se systémem Linux jsou certifikáty uloženy v adresáři uvnitř pracovního adresáře úlohy a proměnná prostředí AZ_BATCH_CERTIFICATES_DIR je dodána úloze pro dotaz na toto umístění. V případě certifikátů s viditelností ' remoteUser ' se vytvoří adresář ' certifikáty ' v domovském adresáři uživatele (např./Home/{User-Name}/certs) a certifikáty se umístí do tohoto adresáře.

storeName
  • string

Název úložiště certifikátů na výpočetním uzlu, do kterého chcete certifikát nainstalovat.
Tato vlastnost se vztahuje pouze na fondy nakonfigurované s výpočetními uzly Windows (tj. vytvořené pomocí cloudServiceConfiguration nebo s virtualMachineConfiguration pomocí referenční dokumentace k bitové kopii systému Windows). Mezi běžné názvy obchodů patří: My, root, CA, Trust, unallowd, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale můžete použít i libovolný vlastní název úložiště. Výchozí hodnota je my.

thumbprint
  • string

Kryptografický otisk certifikátu

thumbprintAlgorithm
  • string

Algoritmus, ke kterému je přidružen kryptografický otisk. Musí to být SHA1.

visibility
  • string[]

Které uživatelské účty ve výpočetním uzlu by měly mít přístup k soukromým datům certifikátu.
V této kolekci lze zadat více než jednu viditelnost. Výchozí hodnota je všechny účty.

CertificateStoreLocation

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

Name Type Description
currentuser
  • string

Certifikáty by měly být nainstalované do úložiště certifikátů CurrentUser.

localmachine
  • string

Certifikáty by měly být nainstalované do úložiště certifikátů LocalMachine.

CIFSMountConfiguration

Informace, které slouží k připojení k systému souborů CIFS.

Name Type Description
mountOptions
  • string

Další možnosti příkazového řádku, které se mají předat příkazu Mount
Jedná se o možnosti "net use" v systému Windows a možnosti připojení v systému Linux.

password
  • string

Heslo, které se má použít pro ověřování proti systému souborů CIFS.

relativeMountPath
  • string

Relativní cesta k výpočetnímu uzlu, do kterého bude připojen systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch Mounts, který je 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 pro ověřování proti systému souborů CIFS.

CloudServiceConfiguration

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

Name Type Description
osFamily
  • string

Řada hostovaných operačních systémů Azure, která se má nainstalovat na virtuální počítače ve fondu.
Možné hodnoty jsou: 2 – řada OS 2, ekvivalent Windows serveru 2008 R2 SP1. 3 – řada OS 3, ekvivalent Windows Serveru 2012. 4 – řada operačních systémů 4, ekvivalent Windows Serveru 2012 R2. 5 – řada OS 5, ekvivalent Windows serveru 2016. 6 – řada operačních systémů 6, ekvivalent Windows serveru 2019. Další informace najdete v tématu vydání hostovaného operačního systému Azure ( https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases) .

osVersion
  • string

Verze operačního systému hosta Azure, která se má nainstalovat na virtuální počítače ve fondu.
Výchozí hodnota je *, která určuje nejnovější verzi operačního systému pro zadanou řadu operačních systémů.

ComputeNodeFillType

Způsob, jakým jsou úlohy distribuovány mezi výpočetní uzly ve fondu.

Name Type Description
pack
  • string

Tolik úloh, kolik je možné (taskSlotsPerNode), by se mělo přiřadit ke 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

Úlohy by se měly přiřazovat rovnoměrně napříč všemi výpočetními uzly ve fondu.

ContainerConfiguration

Konfigurace pro fondy s povoleným kontejnerem.

Name Type Description
containerImageNames
  • string[]

Kolekce názvů imagí kontejneru.
Toto je úplný odkaz na obrázek, který by byl uveden jako "docker pull". Obrázek bude vytvořen z výchozího registru Docker, pokud obrázek nebude plně kvalifikován pomocí alternativního registru.

containerRegistries

Další privátní Registry, ze kterých lze načíst kontejnery.
Pokud se některé image musí stáhnout z privátního registru, který vyžaduje přihlašovací údaje, musí se tady zadat tyto přihlašovací údaje.

type

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

ContainerRegistry

Privátní registr kontejnerů.

Name Type Description
password
  • string

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

registryServer
  • string

Adresa URL registru.
Je-li tento parametr vynechán, bude použita výchozí hodnota "docker.io".

username
  • string

Uživatelské jméno pro přihlášení k serveru registru.

ContainerType

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

Name Type Description
dockerCompatible
  • string

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

ContainerWorkingDirectory

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

Name Type Description
containerImageDefault
  • string

Použijte pracovní adresář definovaný v imagi kontejneru. Upozorňujeme, ž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 prostředků úkolu vyplněné dávkou.

DataDisk

Nastavení, která budou používána datovými disky přidruženými k výpočetním uzlům ve fondu. Pokud používáte připojené datové disky, musíte je připojit a naformátovat na virtuálním počítači, aby je bylo možné použít.

Name Type Description
caching

Typ ukládání do mezipaměti, který má být povolen pro datové disky.
Výchozí hodnota pro ukládání do mezipaměti je jen pro čtení. Informace o možnostech ukládání do mezipaměti najdete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/ .

diskSizeGB
  • integer

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

lun
  • integer

Číslo logické jednotky
Logická jednotka (LUN) slouží k jednoznačné identifikaci každého datového disku. Pokud připojíte více disků, každá z nich by měla mít jedinečnou logickou jednotku (LUN). Hodnota musí být mezi 0 a 63 (včetně).

storageAccountType

Typ účtu úložiště, který se má použít pro datový disk.
Je-li tento parametr vynechán, bude použita výchozí hodnota "standard_lrs".

DiskEncryptionConfiguration

Konfigurace šifrování disku použitá na výpočetních uzlech ve fondu. Ve fondu Linux vytvořeném s imagí Galerie sdílených imagí není podporována konfigurace šifrování disku.

Name Type Description
targets
  • string[]

Seznam cílových disků služba Batch se zašifruje na výpočetním uzlu.
Pokud tento parametr vynecháte, nebudou zašifrované žádné disky na výpočetních uzlech ve fondu. V případě fondu Linux je podporována pouze možnost "TemporaryDisk"; ve fondu Windows je třeba zadat "OsDisk" a "TemporaryDisk".

DynamicVNetAssignmentScope

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

Name Type Description
job
  • string

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

none
  • string

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

ElevationLevel

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

Name Type Description
admin
  • string

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

nonadmin
  • string

Uživatel je standardním uživatelem bez přístupu se zvýšeným oprávněním.

EnvironmentSetting

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

Name Type Description
name
  • string

Název proměnné prostředí

value
  • string

Hodnota proměnné prostředí.

ErrorMessage

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

Name Type Description
lang
  • string

Kód jazyka chybové zprávy

value
  • string

Text zprávy

ImageReference

Odkaz na obrázek Azure Virtual Machines Marketplace nebo obrázek Galerie sdílených imagí. Pokud chcete získat seznam všech odkazů na Image Azure Marketplace ověřených pomocí Azure Batch, přečtěte si o operaci "výpis podporovaných imagí".

Name Type Description
offer
  • string

Typ nabídky pro Image Azure Virtual Machines Marketplace.
Například UbuntuServer nebo WindowsServer.

publisher
  • string

Vydavatel image Azure Virtual Machines Marketplace.
Například kanonické nebo MicrosoftWindowsServer.

sku
  • string

SKU image Azure Virtual Machines Marketplace.
Například 18,04 – LTS nebo 2019-Datacenter.

version
  • string

Verze image Azure Virtual Machines Marketplace
Chcete-li vybrat nejnovější verzi obrázku, lze zadat hodnotu ' nejnovější '. Je-li tento parametr vynechán, je výchozí hodnota "poslední".

virtualMachineImageId
  • string

Identifikátor prostředku ARM obrázku Galerie sdílených imagí Výpočetní uzly ve fondu se vytvoří pomocí tohoto ID image. Jedná se o formulář/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}, ve kterém je vždycky výchozí verze nejnovější image.
Tato vlastnost se vzájemně vylučuje s jinými element imagereference vlastnostmi. Image Galerie sdílených imagí musí mít repliky ve stejné oblasti a musí být ve stejném předplatném jako účet Azure Batch. Pokud verze image není určená v imageId, použije se nejnovější verze. Informace o nastavení brány firewall pro agenta výpočetního uzlu služby Batch ke komunikaci se službou Batch najdete v tématu https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration .

InboundEndpointProtocol

Protokol koncového bodu.

Name Type Description
tcp
  • string

Pro koncový bod použijte protokol TCP.

udp
  • string

Pro koncový bod použijte UDP.

InboundNATPool

Fond příchozího překladu adres (NAT), který se dá použít k externímu adresování specifických portů na výpočetních uzlech ve fondu služby Batch.

Name Type Description
backendPort
  • integer

Číslo portu na výpočetním uzlu.
Toto musí být jedinečné v rámci fondu služby Batch. Přijatelné hodnoty jsou v rozmezí od 1 do 65535, s výjimkou 22, 3389, 29876 a 29877, protože jsou rezervované. Pokud jsou k dispozici rezervované hodnoty, požadavek se nezdařil s kódem stavu HTTP 400.

frontendPortRangeEnd
  • integer

Poslední číslo portu v rozsahu externích portů, které budou použity k poskytnutí příchozího přístupu k backendPort na jednotlivých výpočetních uzlech.
Rozsah přípustných hodnot mezi 1 a 65534 s výjimkou portů z 50000 na 55000, které jsou vyhrazeny službou Batch. Všechny rozsahy v rámci fondu musí být jedinečné a nesmí se překrývat. Každý rozsah musí obsahovat aspoň 40 portů. Pokud jsou k dispozici jakékoli rezervované nebo překrývající se hodnoty, požadavek se nezdařil s kódem stavu HTTP 400.

frontendPortRangeStart
  • integer

První číslo portu v rozsahu externích portů, které se použije k poskytnutí příchozího přístupu k backendPort na jednotlivých výpočetních uzlech.
Rozsah přípustných hodnot mezi 1 a 65534 s výjimkou portů z 50000 na 55000, které jsou vyhrazeny. Všechny rozsahy v rámci fondu musí být jedinečné a nesmí se překrývat. Každý rozsah musí obsahovat aspoň 40 portů. Pokud jsou k dispozici jakékoli rezervované nebo překrývající se hodnoty, požadavek se nezdařil s kódem stavu HTTP 400.

name
  • string

Název koncového bodu.
Název musí být v rámci fondu služby Batch jedinečný, může obsahovat písmena, čísla, podtržítka, tečky a spojovníky. Názvy musí začínat písmenem nebo číslicí, musí končit písmenem, číslicí nebo podtržítkem a nesmí překročit 77 znaků. Pokud jsou k dispozici nějaké neplatné hodnoty, požadavek se nezdařil s kódem stavu HTTP 400.

networkSecurityGroupRules

Seznam pravidel skupin zabezpečení sítě, která se použijí na koncový bod.
Maximální počet pravidel, která lze zadat napříč všemi koncovými body fondu Batch, je 25. Pokud nejsou zadaná žádná pravidla skupiny zabezpečení sítě, vytvoří se výchozí pravidlo, které povolí příchozí přístup k určenému backendPort. Pokud je překročen maximální počet pravidel skupiny zabezpečení sítě, požadavek se nezdařil s kódem stavu HTTP 400.

protocol

Protokol koncového bodu.

IPAddressProvisioningType

Typ zřizování pro Veřejné IP adresy fondu.

Name Type Description
batchmanaged
  • string

Veřejná IP adresa se vytvoří a bude spravovaná službou Batch. V závislosti na velikosti fondu může existovat více veřejných IP adres.

nopublicipaddresses
  • string

Nevytvoří se žádná veřejná IP adresa.

usermanaged
  • string

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

JobConstraints

Omezení spouštění úlohy.

Name Type Description
maxTaskRetryCount
  • integer

Maximální počet pokusů, kolikrát se každý úkol může opakovat. Služba Batch opakuje úlohu, pokud je její ukončovací kód nenulový.
Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch každou úlohu zkusí jednou a potom ji může opakovat až do tohoto limitu. Například pokud je maximální počet opakování 3, Batch se pokusí úlohu provést až čtyřikrát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohy. Pokud je maximální počet opakování-1, služba Batch zopakuje úlohy bez omezení. Výchozí hodnota je 0 (žádné opakování).

maxWallClockTime
  • string

Maximální uplynulý čas, po který může být úloha spuštěna, měřená od okamžiku vytvoření úlohy.
Pokud se úloha v rámci časového limitu nedokončí, služba Batch je ukončí a všechny úlohy, které pořád běží. V takovém případě bude důvod ukončení MaxWallClockTimeExpiry. Pokud tato vlastnost není zadaná, nemusíte mít žádný časový limit pro to, jak dlouho může úloha běžet.

JobManagerTask

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

Name Type Description
allowLowPriorityNode
  • boolean

Určuje, zda může být úkol správce úloh spuštěn na výpočetním uzlu s nízkou prioritou.
Výchozí hodnotou je hodnota true.

applicationPackageReferences

Seznam balíčků aplikací, které bude služba Batch nasazovat do výpočetního uzlu před spuštěním příkazového řádku.
Balíčky aplikací se stáhnou a nasazují do sdíleného adresáře, nikoli do pracovního adresáře úkolů. Proto pokud je odkazovaný balíček aplikace již na výpočetním uzlu a je aktuální, pak nebude znovu stažen; použije se existující kopie na výpočetním uzlu. Pokud se odkazovaný balíček aplikace nedá nainstalovat, například proto, že balíček je odstraněný nebo protože stažení selhalo, úloha se nezdařila.

authenticationTokenSettings

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

commandLine
  • string

Příkazový řádek úkolu správce úloh.
Příkazový řádek neběží pod prostředím, takže nemůže využít funkce prostředí, jako je například rozšíření proměnné prostředí. Chcete-li využít výhod těchto funkcí, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd/c MyCommand" ve Windows nebo "/bin/sh-c MyCommand" v systému Linux. Pokud příkazový řádek odkazuje na cesty k souboru, měl by použít relativní cestu (relativní vzhledem k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí dávkovou dávkou ( https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) .

constraints

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

containerSettings

Nastavení kontejneru, pod kterým je spuštěn úkol správce úloh.
Pokud fond, který spustí tuto úlohu, má containerConfiguration sadu, je nutné ji nastavit také. Pokud fond, který úlohu spustí, nemá containerConfiguration sadu, nesmí být nastavena. Je-li tento parametr zadán, budou všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) mapovány do kontejneru, všechny proměnné prostředí úlohy jsou namapovány do kontejneru a příkazový řádek úkolu je spuštěn v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí odrazit na hostitelském disku, což znamená, že rozhraní API dávkového souboru nebudou mít přístup k těmto souborům.

displayName
  • string

Zobrazovaný název úkolu správce úloh.
Nemusí být jedinečný a může obsahovat libovolné znaky Unicode 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ý jedinečně identifikuje úkol správce úloh v rámci úlohy.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně spojovníků a podtržítka a nesmí obsahovat více než 64 znaků.

killJobOnCompletion
  • boolean

Bez ohledu na to, zda dokončení úkolu správce úloh znamená dokončení celé úlohy.
Pokud je hodnota true, po dokončení úkolu správce úloh služba Batch označí úlohu jako dokončenou. Pokud v tuto chvíli stále běží nějaké úlohy (kromě vydání úlohy), tyto úlohy se ukončí. Pokud je hodnota false, dokončení úkolu správce úloh nemá vliv na stav úlohy. V takovém případě byste měli úlohu ukončit buď pomocí atributu onAllTasksComplete, nebo nechat úlohu klienta nebo uživatele explicitně ukončit. Příkladem je, že správce úloh vytvoří sadu úloh, ale pak neprovede žádnou další roli při jejich provádění. Výchozí hodnotou je hodnota true. Pokud k řízení životnosti úloh používáte atributy onAllTasksComplete a onTaskFailure a chcete-li pomocí úlohy Správce úloh vytvořit úkoly úlohy (Nesledovat průběh), je důležité nastavit killJobOnCompletion na hodnotu false.

outputFiles

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

requiredSlots
  • integer

Počet slotů plánování, které úloha vyžaduje ke spuštění.
Výchozí hodnota je 1. Úloha může být naplánována pouze na výpočetní uzel, pokud má uzel dostatek volných slotů k dispozici. U úkolů s více instancemi musí být 1.

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é pod tímto prvkem se nacházejí v pracovním adresáři úkolu. Existuje maximální velikost seznamu souborů prostředků. Při překročení maximální velikosti se požadavek nezdaří a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikosti. Toho lze dosáhnout pomocí souborů. zip, balíčků aplikací nebo kontejnerů Docker.

runExclusive
  • boolean

Zda úkol správce úloh vyžaduje výhradní použití výpočetního uzlu, ve kterém je spuštěný.
Pokud je nastaveno na true, žádné další úlohy se na stejném uzlu nespustí, dokud je Správce úloh spuštěný. Pokud má hodnotu false, můžou se současně spouštět další úlohy se správcem úloh na výpočetním uzlu. Úkol správce úloh se počítá normálně s limitem souběžných úloh výpočetního uzlu, takže to platí jenom v případě, že výpočetní uzel umožňuje více souběžných úloh. Výchozí hodnotou je hodnota true.

userIdentity

Identita uživatele, pod kterou běží úkol správce úloh.
Je-li tento parametr vynechán, je úloha spuštěna jako uživatel bez oprávnění správce, který je pro úkol jedinečný.

JobNetworkConfiguration

Konfigurace sítě pro úlohu.

Name Type Description
subnetId
  • string

Identifikátor prostředku ARM podsítě virtuální sítě, které výpočetní uzly spouštějí úlohy z úlohy, se připojí po dobu trvání úlohy. Bude fungovat jenom s VirtualMachineConfiguration fondem.
Virtuální síť musí být ve stejné oblasti a předplatném jako účet Azure Batch. Zadaná podsíť by měla mít dostatek volných IP adres, aby vyhovovala počtu výpočetních uzlů, které spustí úlohy z úlohy. Může se jednat o počet výpočetních uzlů ve fondu. Instanční objekt MicrosoftAzureBatch musí mít pro zadanou virtuální síť roli "klasický virtuální počítač Přispěvatel Access Control", aby služba Azure Batch mohla plánovat úlohy na uzlech. Můžete to ověřit tak, že zkontrolujete, jestli má zadaná virtuální síť nějaké přidružené skupiny zabezpečení sítě (NSG). Pokud NSG zakázala komunikaci s uzly v zadané podsíti, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Má formu/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.. Pokud má zadaná virtuální síť nějaké přidružené skupiny zabezpečení sítě (NSG), musí být pro příchozí komunikaci od služby Azure Batch povolený pár rezervovaných systémových portů. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 i port 22 pro Linux a port 3389 pro Windows. Pro odchozí připojení pro komunikaci s Azure Storage musí být také otevřený port 443. Další podrobnosti najdete v těchto tématech: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

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

Name Type Description
commandLine
  • string

Příkazový řádek úkolu přípravy úlohy.
Příkazový řádek neběží pod prostředím, takže nemůže využít funkce prostředí, jako je například rozšíření proměnné prostředí. Chcete-li využít výhod těchto funkcí, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd/c MyCommand" ve Windows nebo "/bin/sh-c MyCommand" v systému Linux. Pokud příkazový řádek odkazuje na cesty k souboru, měl by použít relativní cestu (relativní vzhledem k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí dávkovou dávkou ( https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) .

constraints

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

containerSettings

Nastavení kontejneru, ve kterém se spouští úloha přípravy úlohy.
Je-li tento parametr zadán, budou všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) mapovány do kontejneru, všechny proměnné prostředí úlohy jsou namapovány do kontejneru a příkazový řádek úkolu je spuštěn v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí odrazit na hostitelském disku, což znamená, že rozhraní API dávkového souboru nebudou mít přístup k těmto souborům.

environmentSettings

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

id
  • string

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

rerunOnNodeRebootAfterSuccess
  • boolean

Určuje, zda má služba Batch po restartování výpočetního uzlu znovu spustit úkol přípravy úlohy.
Úkol přípravy úlohy se vždycky znovu spustí, když se na výpočetním uzlu obnoví image, nebo pokud se úloha přípravy úlohy nedokončila (např. kvůli tomu, že při spuštění úlohy došlo k restartování). Proto byste měli vždy napsat úkol přípravy úlohy, který se má idempotentní a správně fungovat, pokud se spustí několikrát. Výchozí hodnotou je hodnota 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é pod tímto prvkem se nacházejí v pracovním adresáři úkolu. Existuje maximální velikost seznamu souborů prostředků. Při překročení maximální velikosti se požadavek nezdaří a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikosti. Toho lze dosáhnout pomocí souborů. zip, balíčků aplikací nebo kontejnerů Docker.

userIdentity

Identita uživatele, pod kterou se spouští úkol přípravy úlohy
Je-li tento parametr vynechán, bude úloha spuštěna jako uživatel bez oprávnění správce, který je jedinečný pro úlohu na výpočetních uzlech systému Windows, nebo neadministrativní uživatel, který je pro fond na výpočetních uzlech se systémem Linux jedinečný.

waitForSuccess
  • boolean

Určuje, zda má služba Batch počkat na úspěšné dokončení úlohy přípravy úlohy před naplánováním dalších úloh úlohy na výpočetním uzlu. Úkol přípravy úlohy byl úspěšně dokončen, pokud se ukončil s ukončovacím kódem 0.
Pokud je hodnota true a úloha přípravy úlohy se v uzlu nezdařila, služba Batch opakuje úkol přípravy úlohy až do maximálního počtu opakování (jak je uvedeno v elementu omezení). Pokud se úloha po všech opakovaných pokusech ještě nedokončila, služba Batch nebude plánovat úlohy úlohy na uzel. Uzel zůstane aktivní a má nárok na spouštění úloh jiných úloh. Pokud je hodnota false, služba Batch nebude čekat na dokončení úlohy přípravy úlohy. V takovém případě mohou další úlohy úlohy začít provádět na výpočetním uzlu, zatímco je stále spuštěn úkol přípravy úlohy; a i v případě, že úloha přípravy úlohy selže, budou nové úlohy nadále naplánovány na výpočetním uzlu. Výchozí hodnotou je hodnota true.

JobReleaseTask

Úkol uvolnění úlohy, který se má spustit při dokončení úlohy na jakémkoli výpočetním uzlu, ve kterém se úloha spustila

Name Type Description
commandLine
  • string

Příkazový řádek úkolu uvolnění úlohy
Příkazový řádek neběží pod prostředím, takže nemůže využít funkce prostředí, jako je například rozšíření proměnné prostředí. Chcete-li využít výhod těchto funkcí, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd/c MyCommand" ve Windows nebo "/bin/sh-c MyCommand" v systému Linux. Pokud příkazový řádek odkazuje na cesty k souboru, měl by použít relativní cestu (relativní vzhledem k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí dávkovou dávkou ( https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) .

containerSettings

Nastavení kontejneru, pod kterým je spouštěn úkol uvolnění úlohy.
Je-li tento parametr zadán, budou všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) mapovány do kontejneru, všechny proměnné prostředí úlohy jsou namapovány do kontejneru a příkazový řádek úkolu je spuštěn v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí odrazit na hostitelském disku, což znamená, že rozhraní API dávkového souboru nebudou mít přístup k těmto souborům.

environmentSettings

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

id
  • string

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

maxWallClockTime
  • string

Maximální uplynulý čas, po který se může úkol uvolnění úlohy spustit na daném výpočetním uzlu, měřeno od okamžiku, kdy se úkol spustí. Pokud se úloha v rámci časového limitu nedokončí, služba Batch je ukončí. Výchozí hodnota je 15 minut. Časový limit nemůžete zadat déle než 15 minut. Pokud tak učiníte, služba Batch ji odmítne s chybou. Pokud voláte REST API přímo, 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. Existuje maximální velikost seznamu souborů prostředků. Při překročení maximální velikosti se požadavek nezdaří a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikosti. Toho lze dosáhnout pomocí souborů. zip, balíčků aplikací nebo kontejnerů Docker.
Soubory uvedené pod tímto prvkem se nacházejí v pracovním adresáři úkolu.

retentionTime
  • string

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

userIdentity

Identita uživatele, pod kterou je spouštěn úkol uvolnění úlohy
Je-li tento parametr vynechán, je úloha spuštěna jako uživatel bez oprávnění správce, který je pro úkol jedinečný.

JobScheduleAddParameter

Plán úlohy, který umožňuje opakované úlohy zadáním, kdy se mají spouštět úlohy a specifikace, která se používá k vytvoření jednotlivých úloh.

Name Type Description
displayName
  • string

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

id
  • string

Řetězec, který jedinečně identifikuje plán v rámci účtu.
ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně spojovníků a podtržítka a nesmí obsahovat více než 64 znaků. ID rozlišuje velká a malá písmena (to znamená, že v rámci účtu nemusíte mít dvě ID, která se liší pouze případem).

jobSpecification

Podrobnosti o úlohách, které mají být vytvořeny v tomto plánu.

metadata

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

schedule

Plán, podle kterého budou vytvořeny úlohy.

JobSpecification

Určuje podrobnosti úloh, které se mají vytvořit podle plánu.

Name Type Description
commonEnvironmentSettings

Seznam běžných nastavení proměnných prostředí Tyto proměnné prostředí se nastavují pro všechny úlohy v úlohách vytvořených v rámci tohoto plánu (včetně úloh Správce úloh, přípravy úloh a úkolů uvolnění úloh).
Jednotlivé úlohy můžou přepsat nastavení prostředí, které je zadané, zadáním stejného názvu nastavení s jinou hodnotou.

constraints

Omezení spouštění pro úlohy vytvořené v rámci tohoto plánu.

displayName
  • string

Zobrazované názvy pro úlohy vytvořené v rámci tohoto plánu
Název nemusí být jedinečný a může obsahovat libovolné znaky Unicode až do maximální délky 1024.

jobManagerTask

Podrobnosti úlohy Správce úloh, které se mají spustit při spuštění úlohy podle tohoto plánu.
Pokud úloha neurčí úkol správce úloh, uživatel musí explicitně přidat úlohy do úlohy pomocí rozhraní API pro úlohy. Pokud úloha určí úkol správce úloh, vytvoří služba Batch úkol správce úloh při vytvoření úlohy a pokusí se naplánovat úkol správce úloh předtím, než naplánuje jiné úkoly v úloze.

jobPreparationTask

Úkol přípravy úlohy pro úlohy vytvořené v rámci tohoto plánu
Pokud úloha obsahuje úkol přípravy úlohy, služba Batch spustí úkol přípravy úlohy na uzlu před spuštěním jakékoli úlohy této úlohy v tomto výpočetním uzlu.

jobReleaseTask

Úkol uvolnění úlohy pro úlohy vytvořené v rámci tohoto plánu
Hlavním účelem úlohy uvolnění úlohy je zrušení změn v uzlech, které provedl úkol přípravy úlohy. Příklady aktivit zahrnují odstraňování místních souborů nebo vypínání služeb, které byly spuštěny v rámci přípravy úlohy. Úkol uvolnění úlohy nejde zadat, aniž by se taky zadal úkol přípravy úlohy pro úlohu. Služba Batch spustí úlohu vydání úlohy na výpočetních uzlech, na kterých je spuštěná úloha přípravy úlohy.

metadata

Seznam párů název-hodnota přidružené k jednotlivým úlohám vytvořeným v rámci tohoto plánu jako metadata
Služba Batch nepřiřazuje metadata žádný význam; používá se výhradně pro použití uživatelského kódu.

networkConfiguration

Konfigurace sítě pro úlohu.

onAllTasksComplete

Akce, kterou by měla služba Batch provést, když jsou všechny úlohy v úloze vytvořené v rámci tohoto plánu v dokončeném stavu.
Všimněte si, že pokud úloha neobsahuje žádné úlohy, jsou všechny úlohy považovány za dokončené. Tato možnost se proto nejčastěji používá s úkolem správce úloh. Pokud chcete použít automatické ukončení úlohy bez Správce úloh, měli byste nejdřív nastavit onAllTasksComplete na hodnotu Ne a aktualizovat vlastnosti úlohy tak, aby se onAllTasksComplete na terminatejob po dokončení přidávání úkolů. Výchozí hodnota je neakce.

onTaskFailure

Akce, kterou by měla služba Batch provést, pokud dojde k chybě jakékoli úlohy v úloze vytvořené v rámci tohoto plánu. Úkol se považuje za neúspěšný, pokud se nezdařil, pokud má hodnotu failureInfo. FailureInfo je nastavena, pokud se úloha dokončí s nenulovým ukončovacím kódem po vyčerpání počtu opakování, nebo pokud při spuštění úlohy došlo k chybě, například kvůli chybě při stahování souboru prostředku.
Výchozí hodnota je neakce.

poolInfo

Fond, na kterém služba Batch spouští úlohy úloh vytvořených v rámci tohoto plánu.

priority
  • integer

Priorita úloh vytvořených v rámci tohoto plánu.
Hodnoty priority můžou být v rozsahu od-1000 do 1000, přičemž-1000 má nejnižší prioritu a hodnota 1000 je nejvyšší prioritou. Výchozí hodnota je 0. Tato priorita se používá jako výchozí pro všechny úlohy v rámci plánu úlohy. Prioritu úlohy můžete aktualizovat poté, co byla vytvořena pomocí rozhraní API úlohy aktualizace.

usesTaskDependencies
  • boolean

Zda úlohy v úloze můžou vzájemně definovat závislosti. Výchozí hodnotou je hodnota false.

LinuxUserConfiguration

Vlastnosti používané k vytvoření uživatelského účtu na výpočetním uzlu se systémem Linux.

Name Type Description
gid
  • integer

ID skupiny pro uživatelský účet.
Vlastnosti UID a GID je třeba zadat společně nebo vůbec ne. Pokud není zadaný, použije základní operační systém GID.

sshPrivateKey
  • string

Privátní klíč SSH pro uživatelský účet.
Privátní klíč nesmí být chráněn heslem. Privátní klíč se používá k automatické konfiguraci ověřování pomocí asymetrického klíče pro SSH mezi výpočetními uzly ve fondu Linux, pokud je vlastnost enableInterNodeCommunication fondu pravdivá (je ignorována, pokud enableInterNodeCommunication je false). To dělá tak, že umístíte dvojici klíčů do adresáře uživatele. ssh. Není-li tento parametr zadán, není mezi výpočetními uzly nakonfigurováno SSH bez hesla (není provedena žádná úprava adresáře SSH uživatele).

uid
  • integer

ID uživatele uživatelského účtu.
Vlastnosti UID a GID je třeba zadat společně nebo vůbec ne. Pokud není zadaný, použije základní operační systém UID.

LoginMode

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

Name Type Description
batch
  • string

LOGON32_LOGON_BATCH režim přihlášení k systému Win32. Režim přihlášení k dávce je doporučený pro dlouhé běžící paralelní procesy.

interactive
  • string

LOGON32_LOGON_INTERACTIVE režim přihlášení k systému Win32. Nástroj Řízení uživatelských účtů je povolený v VirtualMachineConfiguration fondech Windows. Pokud je tato možnost použita s identitou uživatele se zvýšenou úrovní oprávnění v VirtualMachineConfiguration fondu Windows, relace uživatele nebude zvýšena, pokud aplikace spuštěná v příkazovém řádku úlohy není nakonfigurována tak, aby vždy vyžadovala oprávnění správce nebo aby vždy vyžadovala maximální oprávnění.

MetadataItem

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

Name Type Description
name
  • string

Název položky metadat

value
  • string

Hodnota položky metadat

MountConfiguration

Systém souborů, který se má připojit na každý uzel.

Name Type Description
azureBlobFileSystemConfiguration

Kontejner Azure Storage, který se má připojit pomocí objektu BLOB pojistky na jednotlivých uzlech.
Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.

azureFileShareConfiguration

Sdílená složka Azure, která se má připojit k jednotlivým uzlům.
Tato vlastnost se vzájemně vylučuje 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čuje se všemi ostatními vlastnostmi.

nfsMountConfiguration

Systém souborů NFS, který se má připojit k jednotlivým uzlům.
Tato vlastnost se vzájemně vylučuje se všemi ostatními vlastnostmi.

NetworkConfiguration

Konfigurace sítě pro fond.

Name Type Description
dynamicVNetAssignmentScope

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

endpointConfiguration

Konfigurace koncových bodů na výpočetních uzlech ve fondu služby Batch.
Konfigurace koncového bodu fondu je podporovaná jenom ve fondech s vlastností virtualMachineConfiguration.

publicIPAddressConfiguration

Konfigurace veřejné IP adresy pro výpočetní uzly ve fondu služby Batch.
Vlastnost konfigurace veřejné IP adresy je podporovaná jenom u fondů s vlastností virtualMachineConfiguration.

subnetId
  • string

Identifikátor prostředku ARM podsítě virtuální sítě, ke které se budou připojovat výpočetní uzly fondu. Má formu/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}..
Virtuální síť musí být ve stejné oblasti a předplatném jako účet Azure Batch. Zadaná podsíť by měla mít dostatek volných IP adres, aby vyhovovala počtu výpočetních uzlů ve fondu. Pokud podsíť nemá dostatek volných IP adres, fond se částečně přidělí a dojde k chybě změny velikosti. Instanční objekt MicrosoftAzureBatch musí mít pro zadanou virtuální síť roli "klasický virtuální počítač Přispěvatel" na základě role Access Control (RBAC). Zadaná podsíť musí umožňovat komunikaci ze služby Azure Batch, aby mohla plánovat úlohy na uzlech. Můžete to ověřit tak, že zkontrolujete, jestli má zadaná virtuální síť nějaké přidružené skupiny zabezpečení sítě (NSG). Pokud NSG zakázala komunikaci s uzly v zadané podsíti, služba Batch nastaví stav výpočetních uzlů na nepoužitelné. Pro fondy vytvořené s virtualMachineConfiguration se podporují jenom virtuální sítě ARM (Microsoft. Network/virtualNetworks), ale u fondů vytvořených pomocí cloudServiceConfiguration se podporují i klasické virtuální sítě. Pokud zadaná virtuální síť nemá žádné přidružené skupiny zabezpečení sítě (NSG), musí být pro několik vyhrazených systémových portů povolena příchozí komunikace. Pro fondy vytvořené s konfigurací virtuálního počítače povolte porty 29876 a 29877 i port 22 pro Linux a port 3389 pro Windows. Pro fondy vytvořené s konfigurací cloudové služby povolte porty 10100, 20100 a 30100. Povolte také odchozí připojení k Azure Storage na portu 443. Další podrobnosti najdete v těchto tématech: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Pravidlo skupiny zabezpečení sítě, které se má použít u příchozího koncového bodu.

Name Type Description
access

Akce, která má být provedena pro zadanou IP adresu, rozsah podsítě nebo značku.

priority
  • integer

Priorita pro toto pravidlo.
Priority v rámci fondu musí být jedinečné a jsou vyhodnocovány v pořadí podle priority. Čím nižší bude číslo vyšší Priorita. Můžete například zadat pravidla s čísly pořadí 150, 250 a 350. Pravidlo s pořadovým číslem 150 má přednost před pravidlem, které má pořadí 250. Povolené priority jsou 150 až 4096. Pokud jsou k dispozici nějaké rezervované nebo duplicitní hodnoty, požadavek se nezdařil s kódem stavu HTTP 400.

sourceAddressPrefix
  • string

Předpona zdrojové adresy nebo značka, které budou pro pravidlo odpovídat.
Platné hodnoty jsou jedna IP adresa (tj. 10.10.10.10), podsíť protokolu IP (tj. 192.168.1.0/24), výchozí značka nebo * (pro všechny adresy). Pokud jsou k dispozici jiné hodnoty, požadavek se nezdařil s kódem stavu HTTP 400.

sourcePortRanges
  • string[]

Rozsahy zdrojových portů, které mají být pro pravidlo stejné.
Platné hodnoty jsou (pro všechny porty 0-65535), konkrétního portu (tj. 22) nebo rozsahu portů (tj. 100-200). Porty musí být v rozsahu od 0 do 65535. Každá položka v této kolekci nesmí překrývat žádnou jinou položku (buď rozsah, nebo samostatný port). Pokud jsou k dispozici jiné hodnoty, požadavek se nezdařil s kódem stavu HTTP 400. Výchozí hodnota je' '.

NetworkSecurityGroupRuleAccess

Akce, která má být provedena pro zadanou IP adresu, rozsah podsítě nebo značku.

Name Type Description
allow
  • string

Povolte přístup.

deny
  • string

Odepřít přístup.

NFSMountConfiguration

Informace, které slouží k připojení k systému souborů NFS.

Name Type Description
mountOptions
  • string

Další možnosti příkazového řádku, které se mají předat příkazu Mount
Jedná se o možnosti "net use" v systému Windows a možnosti připojení v systému Linux.

relativeMountPath
  • string

Relativní cesta k výpočetnímu uzlu, do kterého bude připojen systém souborů
Všechny systémy souborů jsou připojené vzhledem k adresáři Batch Mounts, který je 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

OnAllTasksComplete

Akce, kterou by měla služba Batch provést, když jsou všechny úlohy v rámci úlohy v dokončeném stavu.

Name Type Description
noaction
  • string

Není potřeba dělat nic. Úloha zůstane aktivní, dokud ji neukončíte nebo nezakážete jiným způsobem.

terminatejob
  • string

Ukončete úlohu. TerminateReason úlohy je nastavená na hodnotu "AllTasksComplete".

OnTaskFailure

Akce, kterou by měla služba Batch provést, když dojde k chybě jakékoli úlohy v úloze.

Name Type Description
noaction
  • string

Není potřeba dělat nic. Úloha zůstane aktivní, dokud ji neukončíte nebo nezakážete jiným způsobem.

performexitoptionsjobaction
  • string

Proveďte akci přidruženou ke stavu ukončení úlohy v kolekci exitConditions úlohy. (To může stále vést k tomu, že se neprovádí žádná akce, pokud to je to, co úloha určí.)

OutputFile

Specifikace pro nahrávání souborů z Azure Batch výpočetního uzlu do jiného umístění poté, co služba Batch dokončila provádění procesu úlohy.

Name Type Description
destination

Cíl pro výstupní soubor (y).

filePattern
  • string

Vzor, který označuje, které soubory se mají nahrát
Jsou podporovány relativní i absolutní cesty. Relativní cesty jsou relativní vzhledem k pracovnímu adresáři úkolu. Jsou podporovány následující zástupné znaky: * odpovídá 0 nebo více znakům (například vzor ABC * by odpovídal ABC nebo abcdef), * * odpovídá jakémukoli adresáři? odpovídá jakémukoli jednomu znaku, [abc] odpovídá jednomu znaku v závorkách a [a-c] odpovídá jednomu znaku v rozsahu. Hranaté závorky můžou zahrnovat negaci, která odpovídá jakémukoli nespecifikovanému znaku (například [! abc] odpovídá jakémukoli znaku, ale a, b nebo c). Pokud název souboru začíná na "." se ve výchozím nastavení ignoruje, ale může se shodovat zadáním explicitně (například . gif se neshoduje s .a.gif, ale.. GIF). Jednoduchý příklad: ** * . txt odpovídá jakémukoli souboru, který nezačíná na '. ' a končí na. txt v pracovním adresáři úlohy nebo v jakémkoli podadresáři. Pokud název souboru obsahuje zástupný znak, může být uvozený pomocí závorek (například ABC [*] odpovídá souboru s názvem ABC *). Všimněte si, že oba \ a/jsou považovány za oddělovače adresářů ve Windows, ale pouze/se nacházejí v systému Linux. Proměnné prostředí (% var% ve Windows nebo $var v systému Linux) jsou rozbaleny před použitím vzoru.

uploadOptions

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

OutputFileBlobContainerDestination

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

Name Type Description
containerUrl
  • string

Adresa URL kontejneru v rámci Azure Blob Storage, do kterého se mají nahrát tyto soubory:
Adresa URL musí obsahovat sdílený přístupový podpis (SAS) udělující oprávnění k zápisu do kontejneru.

path
  • string

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

OutputFileDestination

Cíl, do kterého má být soubor nahrán.

Name Type Description
container

Umístění v úložišti objektů BLOB v Azure, do kterého se mají soubory nahrávat

OutputFileUploadCondition

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

Name Type Description
taskcompletion
  • string

Nahrajte soubory po ukončení procesu úlohy bez ohledu na to, jaký byl ukončovací kód.

taskfailure
  • string

Soubory se nahrávají až po ukončení procesu úlohy pomocí nenulového ukončovacího kódu.

tasksuccess
  • string

Soubory se nahrávají až po ukončení procesu úlohy s ukončovacím kódem 0.

OutputFileUploadOptions

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

Name Type Description
uploadCondition

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

PoolEndpointConfiguration

Konfigurace koncového bodu pro fond.

Name Type Description
inboundNATPools

Seznam příchozích fondů NAT, které se dají použít k externímu adresování konkrétních portů na jednotlivých výpočetních uzlech.
Maximální počet příchozích fondů NAT na fond dávek je 5. Pokud je překročen maximální počet příchozích fondů NAT, požadavek se nezdařil s kódem stavu HTTP 400. Tuto hodnotu nelze zadat, pokud je IPAddressProvisioningType NoPublicIPAddresses.

PoolInformation

Určuje, jak má být úloha přiřazena k fondu.

Name Type Description
autoPoolSpecification

Charakteristiky pro dočasný ' Automatický fond '. Služba Batch vytvoří tento automatický fond při odeslání úlohy.
Pokud se vytvoření automatického fondu nepovede, služba Batch úlohu přesune do stavu dokončeno a chyba při vytváření fondu se nastaví ve vlastnosti chyba plánování úlohy. Služba Batch spravuje dobu života (při vytváření i v případě, že se nezadává, odstraní) automatického fondu. Všechny akce uživatele, které mají vliv na životnost automatického fondu, zatímco je aktivní úloha, budou mít za následek neočekávané chování. Musíte zadat buď ID fondu, nebo specifikaci automatického fondu, ale ne obojí.

poolId
  • string

ID existujícího fondu. Všechny úlohy úlohy se spustí v zadaném fondu.
Je nutné zajistit, aby fond, na který tato vlastnost odkazuje, existoval. Pokud fond v době, kdy se služba Batch pokusí naplánovat úlohu, neexistuje, nespustí se žádné úlohy pro úlohu, dokud nevytvoříte fond s tímto ID. Všimněte si, že služba Batch neodmítla žádost o úlohu. nebude jenom spouštět úlohy, dokud fond neexistuje. Musíte zadat buď ID fondu, nebo specifikaci automatického fondu, ale ne obojí.

PoolLifetimeOption

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

Name Type Description
job
  • string

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

jobschedule
  • string

Fond existuje po dobu života plánu úlohy. Služba Batch vytvoří fond při vytváření první úlohy podle plánu. Tuto možnost můžete použít pouze pro plány úloh, nikoli pro úlohy.

PoolSpecification

Specifikace pro vytvoření nového fondu.

Name Type Description
applicationLicenses
  • string[]

Seznam licencí aplikací, které služba Batch zpřístupní na všech výpočetních uzlech ve fondu.
Seznam licencí aplikace musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud se požaduje licence, která není podporovaná, vytvoření fondu se nezdaří. Povolené licence dostupné ve fondu jsou "Maya", "Vray", "3dsmax", "Arnold". Za každou licenci aplikace přidanou do fondu platí dodatečné poplatky.

applicationPackageReferences

Seznam balíčků, které mají být nainstalovány na každém výpočetním uzlu ve fondu.
Změny odkazů na balíčky ovlivňují všechny nové uzly, které se připojují k fondu, ale neovlivňují výpočetní uzly, které jsou již ve fondu, dokud nebudou restartovány nebo znovu imagí. V daném fondu je maximálně 10 odkazů na balíčky.

autoScaleEvaluationInterval
  • string

Časový interval, ve kterém se má automaticky upravit velikost fondu 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 v uvedeném pořadí. Pokud zadáte hodnotu menší než 5 minut nebo větší než 168 hodin, služba Batch požadavek odmítne s chybou neplatné hodnoty vlastnosti. Pokud voláte REST API přímo, stavový kód HTTP je 400 (chybný požadavek).

autoScaleFormula
  • string

Vzorec pro požadovaný počet výpočetních uzlů ve fondu.
Tato vlastnost nesmí být zadána, je-li vlastnost enableAutoScale nastavena na hodnotu false. Je vyžadováno, pokud je enableAutoScale nastaveno na hodnotu true. Před vytvořením fondu je kontrolována platnost vzorce. Pokud vzorec není platný, služba Batch požadavek odmítne s podrobnými informacemi o chybě.

certificateReferences

Seznam certifikátů, které mají být nainstalovány na každém výpočetním uzlu ve fondu.
V případě uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště certifikátů a umístění. V případě výpočetních uzlů se systémem Linux jsou certifikáty uloženy v adresáři uvnitř pracovního adresáře úlohy a proměnná prostředí AZ_BATCH_CERTIFICATES_DIR je dodána úloze pro dotaz na toto umístění. V případě certifikátů s viditelností ' remoteUser ' se vytvoří adresář ' certifikáty ' v domovském adresáři uživatele (např./Home/{User-Name}/certs) a certifikáty se umístí do tohoto adresáře.

cloudServiceConfiguration

Konfigurace cloudové služby pro fond.
Pokud je potřeba vytvořit fond s virtuálními počítači Azure PaaS, musí být zadaná Tato vlastnost. Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a musí se zadat jedna z vlastností. Pokud není zadána ani jedna z těchto možností, služba Batch vrátí chybu. Pokud voláte REST API přímo, stavový kód HTTP je 400 (chybný požadavek). Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na hodnotu "UserSubscription".

displayName
  • string

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

enableAutoScale
  • boolean

Určuje, zda má být velikost fondu automaticky upravována v průběhu času.
Je-li nastavena hodnota false, musí být zadána alespoň jedna z hodnot targetDedicateNodes a targetLowPriorityNodes. Je-li nastavena hodnota true, je vyžadován element autoScaleFormula. Automaticky se mění velikost fondu podle vzorce. Výchozí hodnota je False.

enableInterNodeCommunication
  • boolean

Zda fond umožňuje přímou komunikaci mezi výpočetními uzly.
Povolení komunikace mezi uzly omezuje maximální velikost fondu z důvodu omezení nasazení na výpočetních uzlech fondu. Výsledkem může být, že fond nedosáhne požadované velikosti. Výchozí hodnota je False.

metadata

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

mountConfiguration

Seznam systémů souborů, které se mají připojit na každý uzel ve fondu.
To podporuje soubory Azure, NFS, CIFS/SMB a Blobfuse.

networkConfiguration

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

resizeTimeout
  • string

Časový limit pro přidělení výpočetních uzlů do fondu.
Tento časový limit se vztahuje jenom na ruční škálování. nemá žádný vliv, pokud je enableAutoScale nastavené na true. Výchozí hodnota je 15 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu menší než 5 minut, služba Batch požadavek odmítne s chybou. Pokud voláte REST API přímo, stavový kód HTTP je 400 (chybný požadavek).

startTask

Úkol, který se spustí na každém výpočetním uzlu, když se připojí k fondu. Úloha se spustí, když se výpočetní uzel přidá do fondu nebo když se výpočetní uzel restartuje.
Dávka bude opakovat úlohy při aktivaci operace obnovení na uzlu. Příklady operací obnovení zahrnují (ale nejsou omezené), když se restartuje uzel, který není v pořádku, nebo se výpočetní uzel nezobrazuje kvůli selhání hostitele. Opakování z důvodu nezávisle na operacích obnovení se nezapočítávají do maxTaskRetryCount. I v případě, že je maxTaskRetryCount 0, může dojít k internímu opakovanému pokusu z důvodu operace obnovení. Z tohoto důvodu by se měly idempotentní všechny úlohy. To znamená, že úlohy musí tolerovat přerušení a restartování, aniž by to způsobilo poškození nebo duplikování dat. Osvědčeným postupem při dlouhotrvajících úlohách je použití některé formy kontrolního bodu. V některých případech může být StartTask znovu spuštěn i v případě, že výpočetní uzel nebyl restartován. Zvláštní pozornost byste měli vzít v potaz, abyste se vyhnuli StartTasks, které vytvářejí Breakaway proces nebo instalovat/spouštět služby z pracovního adresáře StartTask, protože tato služba bude moci dávku znovu spustit StartTask.

targetDedicatedNodes
  • integer

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

targetLowPriorityNodes
  • integer

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

taskSchedulingPolicy

Způsob, jakým jsou úlohy distribuovány mezi výpočetní uzly ve fondu.
Pokud není zadán, výchozí hodnota je rozprostře.

taskSlotsPerNode
  • integer

Počet slotů úloh, které lze použít ke spuš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ší než 4 násobek počtu jader vmSize fondu nebo 256.

userAccounts

Seznam uživatelských účtů, které se mají vytvořit na všech výpočetních uzlech ve fondu.

virtualMachineConfiguration

Konfigurace virtuálního počítače pro fond.
Pokud je potřeba vytvořit fond s virtuálními počítači Azure IaaS, musí být zadaná Tato vlastnost. Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a musí se zadat jedna z vlastností. Pokud není zadána ani jedna z těchto možností, služba Batch vrátí chybu. Pokud voláte REST API přímo, stavový kód HTTP je 400 (chybný požadavek).

vmSize
  • string

Velikost virtuálních počítačů ve fondu. Všechny virtuální počítače ve fondu mají stejnou velikost.
Informace o dostupných velikostech virtuálních počítačů ve fondech najdete v tématu Volba velikosti virtuálního počítače pro výpočetní uzly ve fondu Azure Batch ( https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes) .

PublicIPAddressConfiguration

Konfigurace veřejné IP adresy pro síťovou konfiguraci fondu.

Name Type Description
ipAddressIds
  • string[]

Seznam veřejných IP adres, které služba Batch použije při zřizování výpočetních uzlů.
Počet IP adres, které tady určíte, omezuje maximální velikost vyhrazených uzlů 100 nebo 100 uzlů s nízkou prioritou se dají přidělit pro každou veřejnou IP adresu. Například fond, který potřebuje 250 vyhrazených virtuálních počítačů, musí mít zadaná aspoň 3 veřejné IP adresy. Každý prvek této kolekce má formát:/subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

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

ResourceFile

Jeden soubor nebo více souborů, které se mají stáhnout do výpočetního uzlu.

Name Type Description
autoStorageContainerName
  • string

Název kontejneru úložiště v účtu automatického úložiště.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadaná.

blobPrefix
  • string

Předpona objektu blob, která se má použít při stahování objektů BLOB z kontejneru Azure Storage. Budou staženy pouze objekty blob, jejichž názvy začínají zadanou předponou.
Vlastnost je platná pouze v případě, že je použit autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečný název souboru nebo podadresář. Není-li zadána předpona, budou staženy všechny soubory v kontejneru.

fileMode
  • string

Atribut režimu oprávnění souboru v osmičkovém formátu.
Tato vlastnost se vztahuje pouze na soubory, které jsou stahovány do výpočetních uzlů se systémem Linux. Bude ignorována, pokud je zadána pro resourceFile, který bude stažen do výpočetního uzlu Windows. Pokud není tato vlastnost pro výpočetní uzel se systémem Linux určena, bude pro soubor použita výchozí hodnota 0770.

filePath
  • string

Umístění na výpočetním uzlu, do kterého se mají stáhnout soubory relativní vzhledem k pracovnímu adresáři úkolu.
Pokud je zadána vlastnost httpUrl, vyžaduje se filePath a popisuje cestu, do které bude soubor stažen, včetně názvu souboru. V opačném případě, pokud je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je volitelné a je adresář, do kterého se mají soubory stáhnout. V případě, že se filePath používá jako adresář, všechna adresářová struktura, která je už přidružená ke vstupním datům, se zachová v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže oddělit pracovní adresář úlohy (například pomocí '.. ').

httpUrl
  • string

Adresa URL souboru, který se má stáhnout.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadaná. Pokud adresa URL odkazuje na službu Azure Blob Storage, musí být čitelná pomocí anonymního přístupu; To znamená, že služba Batch při stahování objektu BLOB nezobrazuje žádné přihlašovací údaje. Existují dva způsoby, jak tuto adresu URL pro objekt BLOB ve službě Azure Storage získat: zahrňte do objektu BLOB oprávnění ke čtení (SAS), nebo nastavte seznam ACL pro objekt BLOB nebo jeho kontejner, aby byl veřejný přístup povolen.

storageContainerUrl
  • string

Adresa URL kontejneru objektů BLOB v rámci služby Azure Blob Storage.
Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadaná. Tato adresa URL musí být čitelná a musí být vypsána pomocí anonymního přístupu. To znamená, že služba Batch při stahování objektů BLOB z kontejneru nezobrazuje žádné přihlašovací údaje. Existují dva způsoby, jak získat takovou adresu URL pro kontejner ve službě Azure Storage: zahrňte sdílený přístupový podpis (SAS), který uděluje oprávnění ke čtení a výpisům kontejneru, nebo nastavte seznam řízení přístupu pro kontejner tak, aby umožňoval veřejný přístup.

Schedule

Plán, podle kterého budou vytvořeny úlohy

Name Type Description
doNotRunAfter
  • string

Čas, po kterém se v rámci tohoto plánu úlohy nevytvoří žádná úloha. Plán se přesune do stavu dokončeno, jakmile bude tento termín v minulosti a v rámci tohoto plánu úlohy není žádná aktivní úloha.
Pokud nezadáte čas doNotRunAfter a vytváříte opakující se plán úloh, plán úlohy zůstane aktivní, dokud ho explicitně neukončíte.

doNotRunUntil
  • string

Čas, kdy je možné v rámci tohoto plánu úlohy vytvořit každou úlohu.
Pokud nezadáte čas doNotRunUntil, plán se hned pokusí vytvořit úlohy.

recurrenceInterval
  • string

Časový interval mezi dvěma úspěšnými úlohami v rámci plánu úlohy. Plán úlohy může mít v daném okamžiku nejvýše jednu aktivní úlohu.
Vzhledem k tomu, že plán úlohy může mít v určitou dobu nejvýše jednu aktivní úlohu, pokud je čas vytvořit novou úlohu v rámci plánu úlohy, ale předchozí úloha stále běží, služba Batch novou úlohu nevytvoří až do dokončení předchozí úlohy. Pokud předchozí úloha není dokončena v rámci startWindow období nové recurrenceInterval, nebude pro tento interval naplánována žádná nová úloha. V případě opakovaných úloh byste v jobSpecification měli obvykle zadat jobManagerTask. Pokud nepoužíváte jobManagerTask, budete potřebovat externí proces monitorování při vytváření úloh, přidávání úkolů do úloh a ukončení úloh připravených k dalšímu opakování. Výchozí hodnota je, že se plán neopakuje: jedna úloha se vytvoří v rámci startWindow po doNotRunUntil čase a plán se dokončí, jakmile se úloha dokončí. Minimální hodnota je 1 minuta. Zadáte-li nižší hodnotu, služba Batch tento plán odmítne s chybou. Pokud voláte REST API přímo, stavový kód HTTP je 400 (chybný požadavek).

startWindow
  • string

Časový interval, který začíná od času, kdy plán indikuje úlohu, v rámci které je potřeba vytvořit úlohu.
Pokud se úloha v rámci intervalu startWindow nevytvoří, pak se ztratí "příležitost"; žádná úloha nebude vytvořena až do příštího opakování plánu. Pokud se plán opakuje a startWindow je delší než interval opakování, pak se jedná o ekvivalent nekonečné startWindow, protože úloha, která je splatná v jednom recurrenceInterval, se nepřenese do dalšího intervalu opakování. Výchozí hodnota je Infinite. Minimální hodnota je 1 minuta. Zadáte-li nižší hodnotu, služba Batch tento plán odmítne s chybou. Pokud voláte REST API přímo, stavový kód HTTP je 400 (chybný požadavek).

StartTask

Úkol, který se spustí, když se uzel připojí k fondu ve službě Azure Batch, nebo když se výpočetní uzel restartuje nebo obnoví z image.

Name Type Description
commandLine
  • string

Příkazový řádek StartTask
Příkazový řádek neběží pod prostředím, takže nemůže využít funkce prostředí, jako je například rozšíření proměnné prostředí. Chcete-li využít výhod těchto funkcí, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd/c MyCommand" ve Windows nebo "/bin/sh-c MyCommand" v systému Linux. Pokud příkazový řádek odkazuje na cesty k souboru, měl by použít relativní cestu (relativní vzhledem k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí dávkovou dávkou ( https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) .

containerSettings

Nastavení pro kontejner, ve kterém se StartTask spouští.
Je-li tento parametr zadán, budou všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) mapovány do kontejneru, všechny proměnné prostředí úlohy jsou namapovány do kontejneru a příkazový řádek úkolu je spuštěn v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí odrazit na hostitelském disku, což znamená, že rozhraní API dávkového souboru nebudou mít přístup k těmto souborům.

environmentSettings

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

maxTaskRetryCount
  • integer

Maximální počet pokusů, kolikrát může být úloha opakována.
Služba Batch opakuje úlohu, pokud je její ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch úlohu zopakuje a potom ji můžete opakovat až do tohoto limitu. Například pokud je maximální počet opakování 3, Batch se pokusí úlohu provést až čtyřikrát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch úlohu neopakuje. Pokud je maximální počet opakování-1, služba Batch úlohu zopakuje bez omezení.

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. Existuje maximální velikost seznamu souborů prostředků. Při překročení maximální velikosti se požadavek nezdaří a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikosti. Toho lze dosáhnout pomocí souborů. zip, balíčků aplikací nebo kontejnerů Docker.
Soubory uvedené pod tímto prvkem se nacházejí v pracovním adresáři úkolu.

userIdentity

Identita uživatele, pod kterou běží StartTask
Je-li tento parametr vynechán, je úloha spuštěna jako uživatel bez oprávnění správce, který je pro úkol jedinečný.

waitForSuccess
  • boolean

Určuje, zda má služba Batch počkat na úspěšné dokončení StartTask (tedy pro ukončení s ukončovacím kódem 0) Před naplánováním úkolů na výpočetním uzlu.
Pokud je hodnota true a StartTask v uzlu, služba Batch zopakuje StartTask až do maximálního počtu opakování (maxTaskRetryCount). Pokud úloha ještě nebyla úspěšně dokončena po všech opakovaných pokusech, služba Batch označí uzel jako nepoužitelný a neplánuje k němu úlohy. Tuto podmínku lze zjistit prostřednictvím stavu výpočetního uzlu a podrobností o chybě. Pokud je hodnota false, služba Batch nebude čekat na dokončení StartTask. V takovém případě můžou další úlohy začít provádět na výpočetním uzlu, zatímco je stále spuštěný StartTask; a i v případě, že StartTask selže, budou nové úlohy nadále naplánované na výpočetním uzlu. Výchozí hodnota je true.

StorageAccountType

Typ účtu úložiště, který se má použít při vytváření datových disků.

Name Type Description
premium_lrs
  • string

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

standard_lrs
  • string

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

TaskConstraints

Omezení spouštění pro použití pro úlohu.

Name Type Description
maxTaskRetryCount
  • integer

Maximální počet pokusů, kolikrát může být úloha opakována. Služba Batch opakuje úlohu, pokud je její ukončovací kód nenulový.
Všimněte si, že tato hodnota konkrétně řídí počet opakování pro spustitelný soubor úlohy z důvodu nenulového ukončovacího kódu. Služba Batch úlohu zopakuje a potom ji můžete opakovat až do tohoto limitu. Například pokud je maximální počet opakování 3, Batch se pokusí úlohu provést až čtyřikrát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch úlohu po prvním pokusu neopakuje. Pokud je maximální počet opakování-1, služba Batch úlohu zopakuje bez omezení.

maxWallClockTime
  • string

Maximální uplynulý čas, kdy se úloha může spustit, měřená od doby, kdy je úloha spuštěna. Pokud se úloha v rámci časového limitu nedokončí, služba Batch je ukončí.
Pokud tento parametr nezadáte, nebudete mít žádný časový limit na to, jak dlouho může být úloha spuštěna.

retentionTime
  • string

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

TaskContainerSettings

Nastavení kontejneru pro úlohu.

Name Type Description
containerRunOptions
  • string

Další možnosti příkazu pro vytvoření kontejneru
Tyto další možnosti se dodávají jako argumenty příkazu Docker Create, a to kromě těch, které spravuje služba Batch.

imageName
  • string

Obrázek, který se má použít k vytvoření kontejneru, ve kterém se úloha spustí.
Toto je úplný odkaz na obrázek, který by byl uveden jako "docker pull". Pokud není k dispozici žádná značka jako součást názvu bitové kopie, použije se jako výchozí značka ": nejnovější".

registry

Privátní registr, který obsahuje image kontejneru.
Toto nastavení může být vynecháno, pokud bylo již zadáno při vytváření fondu.

workingDirectory

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

TaskSchedulingPolicy

Určuje, jak se mají úlohy distribuovat mezi výpočetními uzly.

Name Type Description
nodeFillType

Způsob, jakým jsou úlohy distribuovány mezi výpočetní uzly ve fondu.
Pokud není zadán, výchozí hodnota je rozprostře.

UserAccount

Vlastnosti používané k vytvoření uživatele, který se používá ke spouštění úloh na Azure Batch výpočetním uzlu.

Name Type Description
elevationLevel

Úroveň zvýšení oprávnění uživatelského účtu.
Výchozí hodnota je nesprávce.

linuxUserConfiguration

Konfigurace uživatele specifická pro Linux pro uživatelský účet.
Tato vlastnost se ignoruje, pokud je zadaná ve fondu Windows. Pokud není zadaný, vytvoří se uživatel s výchozími možnostmi.

name
  • string

Název uživatelského účtu.

password
  • string

Heslo pro uživatelský účet.

windowsUserConfiguration

Uživatelská konfigurace specifická pro systém Windows pro uživatelský účet.
Tuto vlastnost lze zadat pouze v případě, že je uživatel ve fondu systému Windows. Pokud není zadaný a ve fondu Windows, vytvoří se uživatel s výchozími možnostmi.

UserIdentity

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

Name Type Description
autoUser

Automatický uživatel, pod kterým je úloha spuštěna.
Vlastnosti uživatelského jména a autouser se vzájemně vylučují; je nutné zadat jeden, ale ne obojí.

username
  • string

Název identity uživatele, pod kterou je úloha spuštěna.
Vlastnosti uživatelského jména a autouser se vzájemně vylučují; je nutné zadat jeden, ale ne obojí.

VirtualMachineConfiguration

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

Name Type Description
containerConfiguration

Konfigurace kontejneru pro fond.
Je-li tento parametr zadán, provede se instalace na každém výpočetním uzlu ve fondu, aby bylo možné úlohy spouštět v kontejnerech. Všechny běžné úlohy a úlohy Správce úloh spuštěné v tomto fondu musí určovat vlastnost containerSettings a všechny ostatní úlohy je mohou určit.

dataDisks

Konfigurace datových disků připojených ke výpočetním uzlům ve fondu.
Tato vlastnost musí být zadána, pokud mají výpočetní uzly ve fondu k nim připojeny prázdné datové disky. Toto nelze aktualizovat. Každý výpočetní uzel získá svůj vlastní disk (disk není sdílenou složkou). Existující disky nelze připojit, každý připojený disk je prázdný. Po odebrání výpočetního uzlu z fondu se odstraní také disk a všechna data, která jsou k němu přidružená. Po připojení se disk neformátoval, musí být před použitím zformátován. Další informace najdete v tématech https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux a https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine .

diskEncryptionConfiguration

Konfigurace šifrování disku pro fond.
Když se tato možnost zadá, při zřizování uzlů se na každém uzlu ve fondu provede šifrování.

imageReference

Odkaz na Image Azure Virtual Machines Marketplace nebo na vlastní image virtuálního počítače, která se má použít

licenseType
  • string

Typ místní licence, která se má použít při nasazování operačního systému.
To platí jenom pro image, které obsahují operační systém Windows, a měly by se používat jenom v případě, že u výpočetních uzlů, které se nasadí, podržíte platné místní licence. Pokud tento parametr vynecháte, nepoužije se žádná místní licenční sleva. Hodnoty jsou:

Windows_Server – místní licence pro Windows Server. Windows_Client – místní licence je určena pro klienta systému Windows.

nodeAgentSKUId
  • string

SKU 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 Batch je program, který běží na všech výpočetních uzlech ve fondu, a poskytuje rozhraní příkazového a řídicího uzlu mezi výpočetním uzlem a službou Batch. Existují různé implementace agenta výpočetního uzlu, označované jako SKU, pro různé operační systémy. Je nutné zadat SKU agenta výpočetního uzlu, který odpovídá vybranému odkazu na obrázek. Pokud chcete získat seznam podporovaných SKU agentů výpočetních uzlů spolu se svým seznamem ověřených odkazů na image, přečtěte si téma operace seznam podporovaných výpočetních SKU agenta uzlu Compute.

windowsConfiguration

Nastavení operačního systému Windows na virtuálním počítači.
Tato vlastnost nesmí být zadána, pokud vlastnost element imagereference Určuje bitovou kopii operačního systému Linux.

WindowsConfiguration

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

Name Type Description
enableAutomaticUpdates
  • boolean

Zda jsou na virtuálním počítači povoleny automatické aktualizace.
Je-li tento parametr vynechán, je použita výchozí hodnota true.

WindowsUserConfiguration

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

Name Type Description
loginMode

Režim přihlášení pro uživatele
Výchozí hodnota pro VirtualMachineConfiguration fondy je "Batch" a pro fondy CloudServiceConfiguration je "Interactive".