Compute Node - Reboot
Redémarre le nœud de calcul spécifié.
Vous pouvez redémarrer un nœud de calcul uniquement s’il est inactif ou en cours d’exécution.
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?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 que vous souhaitez redémarrer. |
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 |
---|---|---|
nodeRebootOption |
Quand redémarrer le nœud de calcul et que faire avec les tâches en cours d’exécution. |
Réponses
Nom | Type | Description |
---|---|---|
202 Accepted |
La demande adressée au service Batch a réussi. Headers
|
|
Other Status Codes |
Erreur du service Batch. |
Sécurité
azure_auth
flux de code d’authentification OAuth 2.0 Microsoft Entra
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Authorization
Type:
apiKey
In:
header
Exemples
Node reboot
Sample Request
POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reboot?api-version=2023-11-01.18.0
{
"nodeRebootOption": "terminate"
}
Sample Response
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. |
Compute |
Quand redémarrer le nœud de calcul et que faire avec les tâches en cours d’exécution. |
Error |
Message d’erreur reçu dans une réponse d’erreur Azure Batch. |
Node |
Options de redémarrage d’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. |
ComputeNodeRebootOption
Quand redémarrer le nœud de calcul et que faire avec les tâches en cours d’exécution.
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 s’exécutent à nouveau lorsqu’un nœud de calcul est disponible. Redémarrez le nœud de calcul dès que les tâches ont été arrêtées. |
retaineddata |
string |
Autoriser l’exécution des tâches en cours d’exécution, puis attendre l’expiration de toutes les périodes de conservation des données des tâches. Ne planifiez aucune nouvelle tâche pendant l’attente. Redémarrez le nœud de calcul lorsque toutes les périodes de rétention des tâches ont expiré. |
taskcompletion |
string |
Autoriser l’exécution des tâches en cours d’exécution. Ne planifiez aucune nouvelle tâche pendant l’attente. Redémarrez le nœud de calcul 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. Redémarrez le nœud de calcul dès que les tâches ont été arrêté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. |
NodeRebootParameter
Options de redémarrage d’un nœud de calcul.
Nom | Type | Description |
---|---|---|
nodeRebootOption |
Quand redémarrer le nœud de calcul et que faire avec les tâches en cours d’exécution. |