Partager via

Compute Node - Reimage

  • Référence
Service:
Batch Service
Version d'API:
2024-07-01.20.0

Réinstalle le système d’exploitation sur le nœud de calcul spécifié.
Vous pouvez réinstaller le système d’exploitation sur un nœud de calcul uniquement s’il est dans un état inactif ou en cours d’exécution.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2024-07-01.20.0
Avec des paramètres facultatifs: 
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?timeout={timeout}&api-version=2024-07-01.20.0

Paramètres URI

Nom Dans Obligatoire Type Description
batchUrl
 path True

string

URL de base pour toutes les demandes de service Azure Batch.
nodeId
 path True

string

ID du nœud de calcul que vous souhaitez redémarrer.
poolId
 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 pendant laquelle le serveur peut passer le traitement de la requête, en secondes. La valeur par défaut est de 30 secondes. Si la valeur est supérieure à 30, la valeur par défaut est utilisée à la place.

En-tête de la demande

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

Nom Obligatoire Type Description
client-request-id

string

uuid

L’identité de requête générée par l’appelant, sous la forme d’un GUID sans décoration telle que les accolades, par exemple 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Indique si le serveur doit retourner l’ID 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 de l’horloge système actuelle ; définissez-le explicitement si vous appelez directement l’API REST.

Corps de la demande

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

Nom Type Description
nodeReimageOption

ComputeNodeReimageOption

Quand réimager le nœud de calcul et ce qu’il faut faire avec les tâches en cours d’exécution.
La valeur par défaut est requeue.

Réponses

Nom Type Description
202 Accepted

La demande adressée au service Batch a réussi.

En-têtes

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

BatchError

Erreur du service Batch.

Sécurité

azure_auth

Flux de code d’authentification Microsoft Entra OAuth 2.0

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 reimage

Exemple de requête

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2024-07-01.20.0



{
  "nodeReimageOption": "terminate"
}

Exemple de réponse

Code d’état:
202

Définitions

Nom Description
BatchError

Réponse d’erreur reçue du service Azure Batch.
BatchErrorDetail

Élément d’informations supplémentaires inclus dans une réponse d’erreur Azure Batch.
ComputeNodeReimageOption

Quand réimager le nœud de calcul et ce qu’il faut faire avec les tâches en cours d’exécution.
ErrorMessage

Message d’erreur reçu dans une réponse d’erreur Azure Batch.
NodeReimageParameter

Options pour la reimage 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 programme.
message

ErrorMessage

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
values

BatchErrorDetail[]

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.

ComputeNodeReimageOption

Quand réimager le nœud de calcul et ce qu’il faut 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 réinitialisation de la file d’attente des tâches. Les tâches s’exécutent à nouveau lorsqu’un nœud de calcul est disponible. Réimagez le nœud de calcul dès que les tâches ont été arrêtées.
retaineddata

string

Autorisez la fin des tâches en cours d’exécution, puis attendez que toutes les périodes de rétention des données de tâche expirent. Planifiez aucune nouvelle tâche en attendant. Réimagez 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. Planifiez aucune nouvelle tâche en attendant. Réimagez le nœud de calcul lorsque toutes les tâches sont terminées.
terminate

string

Terminez l’exécution des tâches. Les tâches sont terminées avec failureInfo indiquant qu’elles ont été arrêtées et ne sont pas réexécuter. Réimagez 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.

NodeReimageParameter

Options pour la reimage d’un nœud de calcul.

Nom Type Description
nodeReimageOption

ComputeNodeReimageOption

Quand réimager le nœud de calcul et ce qu’il faut faire avec les tâches en cours d’exécution.
La valeur par défaut est requeue.