Sdílet prostřednictvím


Nodes - List Nodes

Uvádí výpočetní uzly ve specifikovaném poolu.

GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01
GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&$select={$select}

Parametry identifikátoru URI

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

string (uri)

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

poolId
path True

string

ID poolu, ze kterého chcete uvést Compute Nodes.

api-version
query True

string

minLength: 1

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

$filter
query

string

Klauzule $filter OData. Pro více informací o konstrukci tohoto filtru viz https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool.

$select
query

string[]

Klauzule $select OData.

maxresults
query

integer (int32)

minimum: 1
maximum: 1000

Maximální počet položek, které se mají vrátit v odpovědi. Maximálně 1000 žádostí lze vrátit.

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

Name Vyžadováno Typ Description
client-request-id

string

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

return-client-request-id

boolean

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

ocp-date

string (date-time-rfc7231)

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

Odpovědi

Name Typ Description
200 OK

BatchNodeListResult

Požadavek byl úspěšný.

Hlavičky

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

BatchError

Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

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

Rozsahy

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

Příklady

Node list

Ukázkový požadavek

GET {endpoint}/pools/poolId/nodes?api-version=2025-06-01


Ukázková odpověď

{
  "value": [
    {
      "id": "tvm-1695681911_1-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T22:22:27.2236818Z",
      "lastBootTime": "2025-11-22T22:22:24.4634125Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T22:22:27.2236818Z",
        "endTime": "2025-11-22T22:22:27.567189Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_2-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:37:31.4285526Z",
      "lastBootTime": "2025-11-22T19:37:28.623369Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:37:31.4285526Z",
        "endTime": "2025-11-22T19:37:31.838028Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_3-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:36:51.0013378Z",
      "lastBootTime": "2025-11-22T19:36:48.21721Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:36:51.0013378Z",
        "endTime": "2025-11-22T19:36:51.2363447Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    }
  ]
}

Definice

Name Description
AutoUserScope

AutoUserScope enums

AutoUserSpecification

Určuje možnosti automatického uživatele, který spouští úlohu Služby Azure Batch.

BatchError

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

BatchErrorDetail

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

BatchErrorMessage

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

BatchErrorSourceCategory

BatchErrorSourceCategory enumy

BatchNode

Výpočetní uzel ve službě Batch.

BatchNodeAgentInfo

Agent výpočetního uzlu služby Batch je program, který běží na každém výpočetním uzlu ve fondu a poskytuje na výpočetním uzlu možnost Batch.

BatchNodeEndpointConfiguration

Konfigurace koncového bodu pro výpočetní uzel.

BatchNodeError

Došlo k chybě výpočetního uzlu.

BatchNodeIdentityReference

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

BatchNodeListResult

Výsledek výpisu výpočetních uzlů ve fondu

BatchNodeState

BatchNodeState enumy

BatchStartTask

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

BatchStartTaskInfo

Informace o startTask spuštěném na výpočetním uzlu

BatchStartTaskState

BatchStartTaskState enumy

BatchTaskContainerExecutionInfo

Obsahuje informace o kontejneru, který spouští úloha.

BatchTaskContainerSettings

Nastavení kontejneru pro úlohu.

BatchTaskExecutionInfo

Informace o provádění úlohy.

BatchTaskExecutionResult

Enumy BatchTaskExecutionResult

BatchTaskFailureInfo

Informace o selhání úlohy

BatchTaskInfo

Informace o úloze spuštěné na výpočetním uzlu

BatchTaskState

BatchTaskState enums

BatchVmImageReference

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 Seznam podporovaných imagí.

ContainerHostBatchBindMountEntry

Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh.

ContainerHostDataPath

Cesty, které budou připojeny ke kontejneru úlohy kontejneru.

ContainerRegistryReference

Privátní registr kontejneru.

ContainerWorkingDirectory

ContainerWorkingDirectory enums

ElevationLevel

Enumy ElevationLevel

EnvironmentSetting

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

InboundEndpoint

Příchozí koncový bod ve výpočetním uzlu.

InboundEndpointProtocol

Enums InboundEndpointProtocol

NameValuePair

Představuje dvojici název-hodnota.

ResourceFile

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

SchedulingState

Plánování Státních enumů

UserIdentity

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

VirtualMachineInfo

Informace o aktuálním stavu virtuálního počítače

AutoUserScope

AutoUserScope enums

Hodnota Description
task

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

pool

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

AutoUserSpecification

Určuje možnosti automatického uživatele, který spouští úlohu Služby Azure Batch.

Name Typ Description
elevationLevel

ElevationLevel

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

scope

AutoUserScope

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

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

BatchErrorMessage

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

values

BatchErrorDetail[]

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

BatchErrorDetail

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.

BatchErrorMessage

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

Name Typ Description
lang

string

Jazykový kód chybové zprávy.

value

string

Text zprávy.

BatchErrorSourceCategory

BatchErrorSourceCategory enumy

Hodnota Description
usererror

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

servererror

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

BatchNode

Výpočetní uzel ve službě Batch.

Name Typ Description
affinityId

string

Identifikátor, který se dá předat při přidání úkolu a požádat o naplánování úkolu na tomto výpočetním uzlu. Všimněte si, že se jedná jen o měkké spřažení. Pokud je cílový výpočetní uzel zaneprázdněný nebo nedostupný v době, kdy je úkol naplánován, bude úkol naplánován jinde.

allocationTime

string (date-time)

Čas, kdy byl tento výpočetní uzel přidělen fondu. Jedná se o čas, kdy byl výpočetní uzel původně přidělen a po nastavení se nezmění. Neaktualizuje se, když se výpočetní uzel vyléčí nebo nezpochybní.

endpointConfiguration

BatchNodeEndpointConfiguration

Konfigurace koncového bodu pro výpočetní uzel.

errors

BatchNodeError[]

Seznam chyb, ke kterým aktuálně dochází výpočetním uzlem.

id

string

ID výpočetního uzlu. Každému výpočetnímu uzlu přidanému do fondu se přiřadí jedinečné ID. Při každém odebrání výpočetního uzlu z fondu se odstraní všechny jeho místní soubory a ID se uvolní a může se znovu použít pro nové výpočetní uzly.

ipAddress

string

IP adresa, kterou můžou ostatní uzly použít ke komunikaci s tímto výpočetním uzlem. Každému výpočetnímu uzlu přidanému do fondu se přiřadí jedinečná IP adresa. Při každém odebrání výpočetního uzlu z fondu se odstraní všechny jeho místní soubory a IP adresa se uvolní a dá se znovu použít pro nové výpočetní uzly.

ipv6Address

string

Adresa IPv6, kterou mohou ostatní uzly používat ke komunikaci s tímto výpočetním uzlem. Každému výpočetnímu uzlu přidanému do fondu se přiřadí jedinečná IP adresa. Při každém odebrání výpočetního uzlu z fondu se odstraní všechny jeho místní soubory a IP adresa se uvolní a dá se znovu použít pro nové výpočetní uzly. Tato vlastnost nebude k dispozici, pokud fond není nakonfigurován pro protokol IPv6.

isDedicated

boolean

Určuje, jestli je tento výpočetní uzel vyhrazeným výpočetním uzlem. Pokud je hodnota false, výpočetní uzel je výpočetní uzel s nízkou prioritou.

lastBootTime

string (date-time)

Čas posledního spuštění výpočetního uzlu Tato vlastnost nemusí být k dispozici, pokud je stav výpočetního uzlu nepoužitelný.

nodeAgentInfo

BatchNodeAgentInfo

Informace o verzi agenta výpočetního uzlu a čas upgradu výpočetního uzlu na novou verzi.

recentTasks

BatchTaskInfo[]

Seznam úkolů, jejichž stav se nedávno změnil Tato vlastnost je k dispozici pouze v případě, že na tomto výpočetním uzlu byl spuštěn alespoň jeden úkol od jeho přiřazení k fondu.

runningTaskSlotsCount

integer (int32)

Celkový počet slotů plánování používaných aktuálně spuštěnými úkoly úloh na výpočetním uzlu. To zahrnuje úkoly správce úloh a běžné úkoly, ale ne přípravu úlohy, uvolnění úlohy nebo zahájení úkolů.

runningTasksCount

integer (int32)

Celkový počet aktuálně spuštěných úloh na výpočetním uzlu. To zahrnuje úkoly správce úloh a běžné úkoly, ale ne přípravu úlohy, uvolnění úlohy nebo zahájení úkolů.

schedulingState

SchedulingState

Určuje, jestli je výpočetní uzel k dispozici pro plánování úkolů.

startTask

BatchStartTask

Úloha zadaná ke spuštění na výpočetním uzlu, když se připojí k fondu.

startTaskInfo

BatchStartTaskInfo

Informace o spuštění StartTask na výpočetním uzlu

state

BatchNodeState

Aktuální stav výpočetního uzlu.

stateTransitionTime

string (date-time)

Čas, kdy výpočetní uzel vstoupil do aktuálního stavu.

totalTasksRun

integer (int32)

Celkový počet úkolů úloh dokončených na výpočetním uzlu. To zahrnuje úkoly správce úloh a běžné úkoly, ale ne přípravu úlohy, uvolnění úlohy nebo zahájení úkolů.

totalTasksSucceeded

integer (int32)

Celkový počet úloh, které se úspěšně dokončily (s ukončovacím kódem 0) na výpočetním uzlu. To zahrnuje úkoly správce úloh a běžné úkoly, ale ne přípravu úlohy, uvolnění úlohy nebo zahájení úkolů.

url

string (uri)

Adresa URL výpočetního uzlu.

virtualMachineInfo

VirtualMachineInfo

Informace o aktuálním stavu virtuálního počítače

vmSize

string

Velikost virtuálního počítače, který je hostitelem výpočetního uzlu. 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://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

BatchNodeAgentInfo

Agent výpočetního uzlu služby Batch je program, který běží na každém výpočetním uzlu ve fondu a poskytuje na výpočetním uzlu možnost Batch.

Name Typ Description
lastUpdateTime

string (date-time)

Čas, kdy byl agent Compute Node aktualizován na Compute Node. Toto je naposledy, kdy byl agent Compute Node aktualizován na novou verzi.

version

string

Verze agenta Batch Compute Node běžící na Compute Node. Toto číslo verze lze ověřit v poznámkách k uvolnění agenta Compute Node, které se nacházejí na .https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md

BatchNodeEndpointConfiguration

Konfigurace koncového bodu pro výpočetní uzel.

Name Typ Description
inboundEndpoints

InboundEndpoint[]

Seznam příchozích koncových bodů, které jsou přístupné na Compute Node.

BatchNodeError

Došlo k chybě výpočetního uzlu.

Name Typ Description
code

string

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

errorDetails

NameValuePair[]

Seznam dalších chybových detailů souvisejících s chybou Compute Node.

message

string

Zpráva popisující chybu Compute Node, určená k zobrazení v uživatelském rozhraní.

BatchNodeIdentityReference

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

Name Typ Description
resourceId

string (arm-id)

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

BatchNodeListResult

Výsledek výpisu výpočetních uzlů ve fondu

Name Typ Description
odata.nextLink

string (uri)

Adresa URL pro získání další sady výsledků.

value

BatchNode[]

Seznam výpočetních uzlů.

BatchNodeState

BatchNodeState enumy

Hodnota Description
idle

Compute Node momentálně nevykonává žádnou úlohu.

rebooting

Compute Node se restartuje.

reimaging

Compute Node se přetváří.

running

Compute Node spouští jeden nebo více úkolů (kromě StartTask).

unusable

Compute Node nelze použít pro provádění úloh kvůli chybám.

creating

Batch služba získala základní virtuální stroj z Azure Compute, ale zatím se nezačal připojovat k Poolu.

starting

Batch služba se spouští na podkladovém virtuálním stroji.

waitingforstarttask

StartTask začal běžet na Compute Node, ale waitForSuccess je nastaven a StartTask ještě nebyl dokončen.

starttaskfailed

StartTask na Compute Node selhal (a všechny pokusy byly vyčerpány) a čekat na úspěch je nastaveno. Compute Node není použitelný pro spouštění úloh.

unknown

Batch služba ztratila kontakt s Compute Node a nezná jeho skutečný stav.

leavingpool

Compute Node opouští Pool, buď proto, že jej uživatel explicitně odstranil, nebo protože Pool mění velikost či automaticky škáluje dolů.

offline

Compute Node momentálně neběží žádný Task a plánování nových Tasks do Compute Node je zakázáno.

preempted

Výpočetní uzel s nízkou prioritou byl zrušen. Úkoly, které byly spuštěny na výpočetním uzlu, když byly předem zrušeny, se přeplánují, když bude k dispozici jiný výpočetní uzel.

upgradingos

Compute Node prochází operací upgradu operačního systému.

deallocated

Výpočetní uzel je deallocatedován.

deallocating

Compute Node provádí deallocing.

BatchStartTask

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

Name Typ Description
commandLine

string

Příkazový řádek StartTask. Příkazový řádek se nespustí pod prostředím, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí na příkazovém řádku, například pomocí příkazu cmd /c MyCommand ve Windows nebo /bin/sh -c MyCommand v Linuxu. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

BatchTaskContainerSettings

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

environmentSettings

EnvironmentSetting[]

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

maxTaskRetryCount

integer (int32)

Maximální počet opakování úkolu. Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch nezopakuje úlohu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné opakování).

resourceFiles

ResourceFile[]

Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. Seznam souborů prostředků má maximální velikost. Při překročení maximální velikosti požadavek selže a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru. Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu.

userIdentity

UserIdentity

Identita uživatele, pod kterou StartTask běží. Pokud je vynechán, Úkol běží jako neadministrátorský uživatel unikátní pro daný úkol.

waitForSuccess

boolean

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

BatchStartTaskInfo

Informace o startTask spuštěném na výpočetním uzlu

Name Typ Description
containerInfo

BatchTaskContainerExecutionInfo

Informace o kontejneru, ve kterém se úkol vykonává. Tato vlastnost je nastavena pouze tehdy, pokud Task běží v kontextu kontejneru.

endTime

string (date-time)

Čas, kdy StartTask přestal běžet. Toto je čas konce posledního spuštění StartTasku, pokud bylo toto spuštění dokončeno (i když se nepodařilo a je v procesu opakování). Tento prvek není přítomen, pokud je StartTask aktuálně spuštěný.

exitCode

integer (int32)

Výstupní kód programu byl zadán v příkazovém řádku StartTask. Tato vlastnost je nastavena pouze tehdy, pokud je StartTask ve stavu dokončení. Obecně výstupní kód procesu odráží specifickou konvenci implementovanou vývojářem aplikace pro daný proces. Pokud používáte hodnotu výstupního kódu k rozhodování ve svém kódu, ujistěte se, že znáte konvenci výstupního kódu, kterou aplikační proces používá. Pokud však služba Batch ukončí StartTask (kvůli časovému limitu nebo ukončení uživatele přes API), můžete vidět výstupní kód definovaný operačním systémem.

failureInfo

BatchTaskFailureInfo

Informace popisující selhání úkolu, pokud nějaké jsou. Tato vlastnost se nastaví pouze tehdy, pokud je úkol ve stavu dokončení a došlo k selhání.

lastRetryTime

string (date-time)

Nejnovější případ, kdy se pokus o opakování úkolu začal spustit. Tento prvek je přítomen pouze tehdy, pokud byl úkol znovu vyzkoušen (tj. retryCount je nenulový). Pokud je přítomen, obvykle je to stejné jako startTime, ale může se lišit, pokud byl úkol restartován z jiných důvodů než z retry pokusu; například pokud byl Compute Node restartován během opakovaného pokusu, pak se aktualizuje startTime, ale LastRetryTime nikoliv.

result

BatchTaskExecutionResult

Výsledek provedení úkolu. Pokud je hodnota 'failed', podrobnosti o selhání lze najít ve vlastnosti failureInfo.

retryCount

integer (int32)

Počet opakovaných pokusů Batch služby Task. Selhání aplikace úkolů (nenulový výstupní kód) se zkouší znovu, chyby při předzpracování (úkol nemohl být spuštěn) a chyby při nahrávání souborů se nezkoušejí znovu. Batch služba znovu zkusí úkol až do limitu stanoveného omezeními.

startTime

string (date-time)

Čas, kdy začal StartTask běžet. Tato hodnota se resetuje pokaždé, když je Task restartován nebo znovu zkušen (tedy naposledy při spuštění StartTask).

state

BatchStartTaskState

Stav StartTasku na Compute Node.

BatchStartTaskState

BatchStartTaskState enumy

Hodnota Description
running

StartTask právě běží.

completed

StartTask ukončil s výstupním kódem 0, nebo StartTask selhal a limit opakovaného pokusu byl dosažen, nebo proces StartTask nebyl spuštěn kvůli chybám při přípravě úkolu (například selhání stahování resource souborů).

BatchTaskContainerExecutionInfo

Obsahuje informace o kontejneru, který spouští úloha.

Name Typ Description
containerId

string

ID kontejneru.

error

string

Podrobné informace o chybách kontejneru. Toto je podrobný chybový řetězec ze služby Docker, pokud je k dispozici. Je ekvivalentní chybovému poli vrácenému "docker inspect".

state

string

Stav kontejneru. Toto je stav kontejneru podle služby Docker. Je ekvivalentní statusovému poli vrácenému "docker inspect".

BatchTaskContainerSettings

Nastavení kontejneru pro úlohu.

Name Typ Description
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

Cesty, které chcete připojit k úloze kontejneru. Pokud je toto pole null nebo není k dispozici, úloha kontejneru připojí celou dočasnou diskovou jednotku ve Windows (nebo AZ_BATCH_NODE_ROOT_DIR v Linuxu). Pokud je toto pole nastavené jako prázdné, nepřipoje do kontejneru žádné cesty k datům.

containerRunOptions

string

Další možnosti příkazu create kontejneru Tyto další možnosti se předávají jako argumenty příkazu "docker create" kromě těch, které řídí služba Batch.

imageName

string

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

registry

ContainerRegistryReference

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

workingDirectory

ContainerWorkingDirectory

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

BatchTaskExecutionInfo

Informace o provádění úlohy.

Name Typ Description
containerInfo

BatchTaskContainerExecutionInfo

Informace o kontejneru, ve kterém se úkol vykonává. Tato vlastnost je nastavena pouze tehdy, pokud Task běží v kontextu kontejneru.

endTime

string (date-time)

Čas, kdy byl úkol dokončen. Tato vlastnost je nastavena pouze tehdy, pokud je úkol ve stavu Dokončeno.

exitCode

integer (int32)

Výstupní kód programu byl uveden v příkazovém řádku Task. Tato vlastnost je nastavena pouze tehdy, pokud je úkol ve stavu dokončení. Obecně výstupní kód procesu odráží specifickou konvenci implementovanou vývojářem aplikace pro daný proces. Pokud používáte hodnotu výstupního kódu k rozhodování ve svém kódu, ujistěte se, že znáte konvenci výstupního kódu, kterou aplikační proces používá. Pokud však služba Batch ukončí úkol (kvůli časovému limitu nebo ukončení uživatele přes API), můžete vidět výstupní kód definovaný operačním systémem.

failureInfo

BatchTaskFailureInfo

Informace popisující selhání úkolu, pokud nějaké jsou. Tato vlastnost se nastaví pouze tehdy, pokud je úkol ve stavu dokončení a došlo k selhání.

lastRequeueTime

string (date-time)

Nejnovější doba, kdy byla úloha znovu zařazena do fronty službou Batch na základě uživatelského požadavku. Tato vlastnost je nastavena pouze tehdy, pokud je requeueCount nenulový.

lastRetryTime

string (date-time)

Nejnovější případ, kdy se pokus o opakování úkolu začal spustit. Tento prvek je přítomen pouze tehdy, pokud byl úkol znovu vyzkoušen (tj. retryCount je nenulový). Pokud je přítomen, obvykle je to stejné jako startTime, ale může se lišit, pokud byl úkol restartován z jiných důvodů než z retry pokusu; například pokud byl Compute Node restartován během opakovaného pokusu, pak se aktualizuje startTime, ale LastRetryTime nikoliv.

requeueCount

integer (int32)

Počet případů, kdy byl úkol znovu zařazen službou Batch v důsledku uživatelského požadavku. Když uživatel odstraní Compute Nodes z Poolu (změnou/zmenšováním poolu) nebo když je Job deaktivován, může uživatel nastavit, že běžící Tasks na Compute Nodes budou znovu zařazeny do fronty k vykonání. Toto počítání sleduje, kolikrát byl úkol znovu zařazen do fronty z těchto důvodů.

result

BatchTaskExecutionResult

Výsledek provedení úkolu. Pokud je hodnota 'failed', podrobnosti o selhání lze najít ve vlastnosti failureInfo.

retryCount

integer (int32)

Počet opakovaných pokusů Batch služby Task. Selhání aplikace úkolů (nenulový výstupní kód) se zkouší znovu, chyby při předzpracování (úkol nemohl být spuštěn) a chyby při nahrávání souborů se nezkoušejí znovu. Batch služba znovu zkusí úkol až do limitu stanoveného omezeními.

startTime

string (date-time)

Čas, kdy Úkol začal běžet. "Běžící" odpovídá stavu běhu, takže pokud úkol specifikuje soubory zdrojů nebo balíčky, pak čas spuštění odráží dobu, kdy úkol začal tyto soubory stahovat nebo nasazovat. Pokud byl úkol restartován nebo znovu vyzkoušen, jedná se o nejnovější spuštění úkolu. Tato vlastnost je přítomna pouze u úkolů, které jsou ve stavu běžícího nebo dokončeného.

BatchTaskExecutionResult

Enumy BatchTaskExecutionResult

Hodnota Description
success

Úkol proběhl úspěšně.

failure

Při zpracování úkolu došlo k chybě. Selhání mohlo nastat před spuštěním procesu Úkolu, během jeho spuštění, nebo po jeho ukončení.

BatchTaskFailureInfo

Informace o selhání úlohy

Name Typ Description
category

BatchErrorSourceCategory

Kategorie chyby Task.

code

string

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

details

NameValuePair[]

Seznam dalších detailů týkajících se chyby.

message

string

Zpráva popisující chybu Task, určená k zobrazení v uživatelském rozhraní.

BatchTaskInfo

Informace o úloze spuštěné na výpočetním uzlu

Name Typ Description
executionInfo

BatchTaskExecutionInfo

Informace o provedení úkolu.

jobId

string

ID práce, ke které úkol patří.

subtaskId

integer (int32)

ID podúkolu, pokud je úkol víceinstancový úkol.

taskId

string

ID úkolu.

taskState

BatchTaskState

Současný stav úkolu.

taskUrl

string (uri)

URL úkolu.

BatchTaskState

BatchTaskState enums

Hodnota Description
active

Úkol je zařazen do fronty a může běžet, ale momentálně není přiřazen k Compute Node. Úloha vstupuje do tohoto stavu při svém vytvoření, při jejím povolení po deaktivaci nebo když čeká na opakovaný pokus po neúspěšném běhu.

preparing

Úkol byl přiřazen výpočetnímu uzlu, ale čeká na dokončení požadovaného úkolu přípravy úkolu na tomto výpočetním uzlu. Pokud úkol Příprava úkolu uspěje, úkol se přesune do běžícího režimu. Pokud úkol Přípravy úkolu selže, úkol se vrátí do aktivní režimu a bude způsobilý k přiřazení jinému výpočetnímu uzlu.

running

Úkol běží na Compute Node. To zahrnuje přípravu na úrovni úkolu, jako je stahování souborů zdrojů nebo nasazení balíčků specifikovaných v úkolu – to však nemusí nutně znamenat, že příkazový řádek úkolu již začal spouštět.

completed

Úkol již není způsobilý k vykonání, obvykle proto, že byl úspěšně dokončen, nebo úkol neúspěšně dokončen a vyčerpal svůj limit pro opakované pokusy. Úkol je také označen jako dokončený, pokud došlo k chybě při spuštění úkolu nebo pokud byl úkol ukončen.

BatchVmImageReference

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 Seznam podporovaných imagí.

Name Typ Description
communityGalleryImageId

string

Unikátní identifikátor obrázku komunitní galerie. Tato vlastnost se vzájemně vylučují s jinými vlastnostmi a lze ji načíst z volání GET galerie komunity.

exactVersion

string

Konkrétní verze obrazu platformy nebo obrázku tržiště použitého k vytvoření uzlu. Toto pole pouze pro čtení se liší od 'version' pouze tehdy, pokud byla hodnota uvedena pro 'version' při vytvoření poolu 'laput'.

offer

string

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

publisher

string

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

sharedGalleryImageId

string

Jedinečný identifikátor sdíleného obrázku galerie. Tato vlastnost se vzájemně vylučují s jinými vlastnostmi a lze ji načíst z volání GET sdíleného obrázku galerie.

sku

string

The SKU of the Azure Virtual Machines Marketplace Image. Například 18.04-LTS nebo 2019-Datacenter.

version

string

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

virtualMachineImageId

string (arm-id)

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

ContainerHostBatchBindMountEntry

Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh.

Name Typ Description
isReadOnly

boolean

Připojte tuto zdrojovou cestu jako režim jen pro čtení nebo ne. Výchozí hodnota je false (režim čtení a zápisu). Pokud tuto cestu pro Linux připojíte jako režim pro čtení a zápis, neznamená to, že všichni uživatelé v kontejneru mají pro cestu přístup pro čtení a zápis, závisí na přístupu na hostitelském virtuálním počítači. Pokud je tato cesta připojená jen pro čtení, nebudou moct změnit cestu všichni uživatelé v kontejneru.

source

ContainerHostDataPath

Cestu, která se připojí k zákazníkovi kontejneru, může vybrat.

ContainerHostDataPath

Cesty, které budou připojeny ke kontejneru úlohy kontejneru.

Hodnota Description
Shared

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

Startup

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

VfsMounts

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

Task

Cesta k úkolu.

JobPrep

Cesta úkolu přípravy úlohy.

Applications

Cesta k aplikacím.

ContainerRegistryReference

Privátní registr kontejneru.

Name Typ Description
identityReference

BatchNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem, 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 (password)

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

registryServer

string (uri)

Adresa URL registru. Pokud tuto hodnotu vynecháte, výchozí hodnota je docker.io.

username

string

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

ContainerWorkingDirectory

ContainerWorkingDirectory enums

Hodnota Description
taskWorkingDirectory

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

containerImageDefault

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

ElevationLevel

Enumy ElevationLevel

Hodnota Description
nonadmin

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

admin

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

EnvironmentSetting

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

Name Typ Description
name

string

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

value

string

Hodnota proměnné prostředí.

InboundEndpoint

Příchozí koncový bod ve výpočetním uzlu.

Name Typ Description
backendPort

integer (int32)

Číslo backendového portu koncového zařízení.

frontendPort

integer (int32)

Veřejné číslo portu koncového zařízení.

name

string

Název koncového bodu

protocol

InboundEndpointProtocol

Protokol koncového bodu.

publicFQDN

string

Veřejné plně kvalifikované doménové jméno pro Compute Node.

publicIPAddress

string

Veřejná IP adresa Compute Node.

InboundEndpointProtocol

Enums InboundEndpointProtocol

Hodnota Description
tcp

Pro koncový bod použijte protokol TCP.

udp

Pro koncový bod použijte UDP.

NameValuePair

Představuje dvojici název-hodnota.

Name Typ Description
name

string

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

value

string

Hodnota v páru jméno-hodnota.

ResourceFile

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

Name Typ Description
autoStorageContainerName

string

Název skladovacího kontejneru v účtu automatického úložiště. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich.

blobPrefix

string

Předpona objektu blob, která se má použít při stahování objektů blob z kontejneru Azure Storage. Stáhnou se jenom objekty blob, jejichž názvy začínají zadanou předponou. Vlastnost je platná pouze při použití autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečným názvem souboru nebo podadresářem. Pokud předpona není zadaná, stáhnou se všechny soubory v kontejneru.

fileMode

string

Atribut režimu oprávnění souboru v osmičkovém formátu. Tato vlastnost se vztahuje pouze na soubory stahované do Linux Compute Nodes. Bude ignorován, pokud je specifikován pro resource file, který bude stažen do Windows Compute Node. Pokud tato vlastnost není specifikována pro Linux Compute Node, je na soubor aplikována výchozí hodnota 0770.

filePath

string

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

httpUrl

string (uri)

Adresa URL souboru, který chcete stáhnout. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Pokud adresa URL odkazuje na Azure Blob Storage, musí být čitelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL objektu blob v úložišti Azure: zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použít spravovanou identitu s oprávněním ke čtení nebo nastavit seznam ACL objektu blob nebo jeho kontejneru tak, aby umožňoval veřejný přístup.

identityReference

BatchNodeIdentityReference

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

storageContainerUrl

string (uri)

Adresa URL kontejneru objektů blob v rámci služby Azure Blob Storage. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a je nutné zadat jeden z nich. Tato adresa URL musí být čitelná a vypisovatelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL kontejneru v úložišti Azure: zahrnutí sdíleného přístupového podpisu (SAS) udělujícího oprávnění ke čtení a seznamu v kontejneru, použití spravované identity s oprávněními ke čtení a seznamu nebo nastavení seznamu ACL pro kontejner tak, aby umožňoval veřejný přístup.

SchedulingState

Plánování Státních enumů

Hodnota Description
enabled

Úlohy lze plánovat na Compute Node.

disabled

Na Compute Node nebudou plánovány žádné nové úkoly. Úlohy již běžící na Compute Node mohou stále běžet do dokončení. Všechny Compute Nodes začínají s povoleným plánováním.

UserIdentity

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

Name Typ Description
autoUser

AutoUserSpecification

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

username

string

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

VirtualMachineInfo

Informace o aktuálním stavu virtuálního počítače

Name Typ Description
imageReference

BatchVmImageReference

Odkaz na Marketplace Image Azure Virtual Machine.

scaleSetVmResourceId

string

ID zdroje aktuálního VM Virtual Machine Scale Set v Compute Node. Definováno pouze tehdy, pokud byl dávkový účet vytvořen s vlastností poolAllocationMode nastavenou na 'UserSubscription'.