Compute Node - Reimage
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 inactif ou en cours d’exécution. Cette API ne peut être appelée que sur les pools créés avec la propriété de configuration du service cloud.
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?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 d’horloge système actuelle ; définissez-la explicitement si vous appelez l’API REST directement. |
Corps de la demande
Media Types: "application/json; odata=minimalmetadata"
Nom | Type | Description |
---|---|---|
nodeReimageOption |
Quand reimager 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
Microsoft Entra flux de code d’authentification OAuth 2.0
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 reimage
Sample Request
POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2023-11-01.18.0
{
"nodeReimageOption": "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 incluses dans une réponse d’erreur Azure Batch. |
Compute |
Quand reimager 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 réimagination 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 adapté à l’affichage 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 incluses 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 reimager le nœud de calcul et que faire avec les tâches en cours d’exécution.
Nom | Type | Description |
---|---|---|
requeue |
string |
Arrêtez les processus de tâche en cours d’exécution et remettez en file d’attente les tâches. Les tâches s’exécutent à nouveau lorsqu’un nœud de calcul est disponible. Reimagez le nœud de calcul dès que les tâches ont été terminé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. Reimagez 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. Reimagez 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 sont terminées avec failureInfo indiquant qu’elles ont été arrêtées et qu’elles ne s’exécuteront pas à nouveau. Reimagez le nœud de calcul 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. |
NodeReimageParameter
Options de réimagination d’un nœud de calcul.
Nom | Type | Description |
---|---|---|
nodeReimageOption |
Quand reimager le nœud de calcul et que faire avec les tâches en cours d’exécution. |