Compute Node - Disable Scheduling
Désactive la planification des tâches sur le nœud de calcul spécifié.
Vous pouvez désactiver la planification des tâches sur un nœud de calcul uniquement si son état de planification actuel est activé.
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/disablescheduling?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/disablescheduling?timeout={timeout}&api-version=2023-11-01.18.0
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
batch
|
path | True |
string |
URL de base pour toutes les demandes de service Azure Batch. |
node
|
path | True |
string |
ID du nœud de calcul sur lequel vous souhaitez désactiver la planification des tâches. |
pool
|
path | True |
string |
ID du pool qui contient le nœud de calcul. |
api-version
|
query | True |
string |
Version de l’API cliente. |
timeout
|
query |
integer int32 |
Durée maximale que le serveur peut consacrer au traitement de la demande, en secondes. La valeur par défaut est 30 secondes. |
En-tête de la demande
Media Types: "application/json; odata=minimalmetadata"
Nom | Obligatoire | Type | Description |
---|---|---|---|
client-request-id |
string uuid |
Identité de requête générée par l’appelant, sous la forme d’un GUID sans décoration telle que des accolades, par exemple 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Indique si le serveur doit retourner le client-request-id dans la réponse. |
|
ocp-date |
string date-time-rfc1123 |
Heure à laquelle la demande a été émise. Les bibliothèques clientes définissent généralement cette valeur sur l’heure actuelle de l’horloge système ; définissez-la explicitement si vous appelez directement l’API REST. |
Corps de la demande
Media Types: "application/json; odata=minimalmetadata"
Nom | Type | Description |
---|---|---|
nodeDisableSchedulingOption |
Que faire avec les tâches en cours d’exécution lors de la désactivation de la planification des tâches sur le nœud de calcul. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
La demande adressée au service Batch a réussi. En-têtes
|
|
Other Status Codes |
Erreur du service Batch. |
Sécurité
azure_auth
flux de code d’authentification OAuth 2.0 Microsoft Entra
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Authorization
Type:
apiKey
Dans:
header
Exemples
Node disable scheduling
Exemple de requête
POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/disablescheduling?api-version=2023-11-01.18.0
{
"nodeDisableSchedulingOption": "terminate"
}
Exemple de réponse
Définitions
Nom | Description |
---|---|
Batch |
Réponse d’erreur reçue du service Azure Batch. |
Batch |
Élément d’informations supplémentaires inclus dans une réponse d’erreur Azure Batch. |
Disable |
Que faire avec les tâches en cours d’exécution lors de la désactivation de la planification des tâches sur le nœud de calcul. |
Error |
Message d’erreur reçu dans une réponse d’erreur Azure Batch. |
Node |
Options de désactivation de la planification sur un nœud de calcul. |
BatchError
Réponse d’erreur reçue du service Azure Batch.
Nom | Type | Description |
---|---|---|
code |
string |
Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation. |
message |
Message décrivant l’erreur, destiné à être affiché dans une interface utilisateur. |
|
values |
Collection de paires clé-valeur contenant des détails supplémentaires sur l’erreur. |
BatchErrorDetail
Élément d’informations supplémentaires inclus dans une réponse d’erreur Azure Batch.
Nom | Type | Description |
---|---|---|
key |
string |
Identificateur spécifiant la signification de la propriété Value. |
value |
string |
Informations supplémentaires incluses dans la réponse d’erreur. |
DisableComputeNodeSchedulingOption
Que faire avec les tâches en cours d’exécution lors de la désactivation de la planification des tâches sur le nœud de calcul.
Nom | Type | Description |
---|---|---|
requeue |
string |
Arrêtez l’exécution des processus de tâche et remettez les tâches en file d’attente. Les tâches peuvent s’exécuter à nouveau sur d’autres nœuds de calcul, ou lorsque la planification des tâches est réactivé sur ce nœud de calcul. Entrez l’état hors connexion dès que les tâches ont été terminées. |
taskcompletion |
string |
Autoriser l’exécution des tâches en cours d’exécution. Ne planifiez aucune nouvelle tâche pendant l’attente. Entrez l’état hors connexion lorsque toutes les tâches sont terminées. |
terminate |
string |
Arrêtez l’exécution des tâches. Les tâches seront terminées avec failureInfo, indiquant qu’elles ont été arrêtées et ne s’exécuteront pas à nouveau. Entrez l’état hors connexion dès que les tâches ont été terminées. |
ErrorMessage
Message d’erreur reçu dans une réponse d’erreur Azure Batch.
Nom | Type | Description |
---|---|---|
lang |
string |
Code de langue du message d’erreur |
value |
string |
Texte du message. |
NodeDisableSchedulingParameter
Options de désactivation de la planification sur un nœud de calcul.
Nom | Type | Description |
---|---|---|
nodeDisableSchedulingOption |
Que faire avec les tâches en cours d’exécution lors de la désactivation de la planification des tâches sur le nœud de calcul. |