Compute Node - Disable Scheduling

Service:

Batch Service

API Version:

2023-11-01.18.0

Zakáže plánování úkolů na zadaném výpočetním uzlu.
Plánování úkolů na výpočetním uzlu můžete zakázat jenom v případě, že je povolený jeho aktuální stav plánování.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/disablescheduling?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/disablescheduling?timeout={timeout}&api-version=2023-11-01.18.0

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
batchUrl	path	True	string	Základní adresa URL pro všechny požadavky služby Azure Batch.
nodeId	path	True	string	ID výpočetního uzlu, na kterém chcete zakázat plánování úkolů.
poolId	path	True	string	ID fondu, který obsahuje výpočetní uzel.
api-version	query	True	string	Verze klientského rozhraní API.
timeout	query		integer int32	Maximální čas, který může server strávit zpracováním požadavku, v sekundách. Výchozí hodnota je 30 sekund.

Hlavička požadavku

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

Name	Vyžadováno	Typ	Description
client-request-id		string uuid	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez ozdob, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Jestli má server v odpovědi vrátit client-request-id.
ocp-date		string date-time-rfc1123	Čas, kdy byla žádost vystavena. Klientské knihovny obvykle tuto možnost nastaví na aktuální systémový čas. pokud přímo voláte rozhraní REST API, nastavte ho explicitně.

Text požadavku

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

Name	Typ	Description
nodeDisableSchedulingOption	DisableComputeNodeSchedulingOption	Co dělat s aktuálně spuštěnými úkoly při zakázání plánování úkolů na výpočetním uzlu Výchozí hodnota je opětovné zařazení do fronty.

Odpovědi

Name	Typ	Description
200 OK		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	BatchError	Chyba ze služby Batch.

Zabezpečení

azure_auth

Microsoft Entra tok kódu ověřování OAuth 2.0

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

Node disable scheduling

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/disablescheduling?api-version=2023-11-01.18.0



{
  "nodeDisableSchedulingOption": "terminate"
}

Sample Response

Status code:

200

Definice

Name	Description
BatchError	Ze služby Azure Batch byla přijata chybová odpověď.
BatchErrorDetail	Položka s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu.
DisableComputeNodeSchedulingOption	Co dělat s aktuálně spuštěnými úkoly při zakázání plánování úkolů na výpočetním uzlu
ErrorMessage	Chybová zpráva přijatá v Azure Batch odpověď na chybu.
NodeDisableSchedulingParameter	Možnosti zákazu plánování na výpočetním uzlu

BatchError

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

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově.
message	ErrorMessage	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 s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu.

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v chybové odpovědi.

DisableComputeNodeSchedulingOption

Co dělat s aktuálně spuštěnými úkoly při zakázání plánování úkolů na výpočetním uzlu

Name	Typ	Description
requeue	string	Ukončete spuštěné procesy úloh a znovu zaváděte úlohy do fronty. Úkoly se můžou znovu spustit na jiných výpočetních uzlech nebo při opětovném povolení plánování úkolů na tomto výpočetním uzlu. Jakmile budou úkoly ukončeny, zadejte offline stav.
taskcompletion	string	Povolte dokončení aktuálně spuštěných úloh. Během čekání neplánujte žádné nové úkoly. Po dokončení všech úkolů zadejte offline stav.
terminate	string	Ukončete spuštěné úlohy. Úkoly budou dokončeny s informací o selhání označující, že byly ukončeny, a nebudou znovu spuštěny. Jakmile budou úkoly ukončeny, zadejte offline stav.

ErrorMessage

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

Name	Typ	Description
lang	string	Kód jazyka chybové zprávy
value	string	Text zprávy.

NodeDisableSchedulingParameter

Možnosti zákazu plánování na výpočetním uzlu

Name	Typ	Description
nodeDisableSchedulingOption	DisableComputeNodeSchedulingOption	Co dělat s aktuálně spuštěnými úkoly při zakázání plánování úkolů na výpočetním uzlu Výchozí hodnota je opětovné zařazení do fronty.