Share via

Compute Node - Disable Scheduling

  • Riferimento
Service:
Batch Service
API Version:
2023-11-01.18.0

Disabilita la pianificazione delle attività nel nodo di calcolo specificato.
È possibile disabilitare la pianificazione delle attività in un nodo di calcolo solo se lo stato di pianificazione corrente è abilitato.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
batchUrl
 path True

string

URL di base per tutte le richieste di servizio Azure Batch.
nodeId
 path True

string

ID del nodo di calcolo in cui si vuole disabilitare la pianificazione delle attività.
poolId
 path True

string

ID del pool che contiene il nodo di calcolo.
api-version
 query True

string

Versione dell'API client.
timeout
 query

integer

int32

Tempo massimo per cui il server può dedicare l'elaborazione della richiesta, in secondi. Il valore predefinito è 30 secondi.

Intestazione della richiesta

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

Nome Necessario Tipo Descrizione
client-request-id

string

uuid

Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date

string

date-time-rfc1123

Ora di emissione della richiesta. Le librerie client impostano in genere questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Corpo della richiesta

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

Nome Tipo Descrizione
nodeDisableSchedulingOption

DisableComputeNodeSchedulingOption

Operazioni da eseguire con attività attualmente in esecuzione quando si disabilita la pianificazione delle attività nel nodo di calcolo.
Il valore predefinito è requeue.

Risposte

Nome Tipo Descrizione
200 OK

La richiesta al servizio Batch ha avuto esito positivo.

Headers

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

BatchError

Errore del servizio Batch.

Sicurezza

azure_auth

Microsoft Entra flusso del codice di autenticazione OAuth 2.0

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

Scopes

Nome Descrizione
user_impersonation Rappresentare l'account utente

Authorization

Type: apiKey
In: header

Esempio

Node disable scheduling

Sample Request

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

Definizioni

Nome Descrizione
BatchError

Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch.
DisableComputeNodeSchedulingOption

Operazioni da eseguire con attività attualmente in esecuzione quando si disabilita la pianificazione delle attività nel nodo di calcolo.
ErrorMessage

Messaggio di errore ricevuto in una risposta di errore Azure Batch.
NodeDisableSchedulingParameter

Opzioni per disabilitare la pianificazione in un nodo di calcolo.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message

ErrorMessage

Messaggio che descrive l'errore, che deve essere adatto per la visualizzazione in un'interfaccia utente.
values

BatchErrorDetail[]

Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch.

Nome Tipo Descrizione
key

string

Identificatore che specifica il significato della proprietà Value.
value

string

Informazioni aggiuntive incluse nella risposta di errore.

DisableComputeNodeSchedulingOption

Operazioni da eseguire con attività attualmente in esecuzione quando si disabilita la pianificazione delle attività nel nodo di calcolo.

Nome Tipo Descrizione
requeue

string

Terminare l'esecuzione dei processi attività e accodare nuovamente le attività. Le attività possono essere eseguite di nuovo in altri nodi di calcolo o quando la pianificazione delle attività è riabilitata in questo nodo di calcolo. Immettere lo stato offline non appena le attività sono state terminate.
taskcompletion

string

Consenti il completamento delle attività attualmente in esecuzione. Non pianificare nuove attività durante l'attesa. Immettere lo stato offline al termine di tutte le attività.
terminate

string

Termina l'esecuzione di Attività. Le attività verranno completate con failureInfo che indica che sono state terminate e non verranno eseguite di nuovo. Immettere lo stato offline non appena le attività sono state terminate.

ErrorMessage

Messaggio di errore ricevuto in una risposta di errore Azure Batch.

Nome Tipo Descrizione
lang

string

Codice linguistico del messaggio di errore
value

string

Testo del messaggio.

NodeDisableSchedulingParameter

Opzioni per disabilitare la pianificazione in un nodo di calcolo.

Nome Tipo Descrizione
nodeDisableSchedulingOption

DisableComputeNodeSchedulingOption

Operazioni da eseguire con attività attualmente in esecuzione quando si disabilita la pianificazione delle attività nel nodo di calcolo.
Il valore predefinito è requeue.