Freigeben über

Nodes - Reimage Node

Dienst:
Batch Service
API-Version:
2025-06-01

Installiert das Betriebssystem auf dem angegebenen Computeknoten neu.
Sie können das Betriebssystem nur dann auf einem Computeknoten neu installieren, wenn es sich in einem Leerlauf- oder Ausführungszustand befindet. Diese API kann nur auf Pools aufgerufen werden, die mit der Cloud-Service-Konfigurationseigenschaft erstellt wurden.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2025-06-01
Mit optionalen Parametern: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2025-06-01&timeOut={timeOut}

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string (uri)

Batchkontoendpunkt (z. B. https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

Die ID des Computeknotens, den Sie neu starten möchten.
poolId
 path True

string

Die ID des Pools, der den Computeknoten enthält.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.
timeOut
 query

integer (int32)

Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden ausgeben kann. Der Standardwert ist 30 Sekunden. Ist der Wert größer als 30, wird stattdessen der Standard verwendet."

Anforderungsheader

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

Name Erforderlich Typ Beschreibung
client-request-id

string

Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Gibt an, ob der Server die Clientanforderungs-ID in der Antwort zurückgeben soll.
ocp-date

string (date-time-rfc7231)

Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. legen Sie sie explizit fest, wenn Sie die REST-API direkt aufrufen.

Anforderungstext

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

Name Typ Beschreibung
nodeReimageOption

BatchNodeReimageOption

Wann sie den Computeknoten neu abbilden und was mit derzeit ausgeführten Aufgaben zu tun ist. Der Standardwert wird erneut abfragt.

Antworten

Name Typ Beschreibung
202 Accepted

Die Anforderung wurde zur Verarbeitung akzeptiert, die Verarbeitung wurde jedoch noch nicht abgeschlossen.

Header

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

BatchError

Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name Beschreibung
https://batch.core.windows.net//.default

Beispiele

Node reimage

Beispielanforderung

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2025-06-01

Beispiel für eine Antwort

Statuscode:
202

Definitionen

Name Beschreibung
BatchError

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.
BatchErrorDetail

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.
BatchErrorMessage

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.
BatchNodeReimageOption

BatchNodeReimageOption enums
BatchNodeReimageOptions

Parameter zum Reimaging eines Azure Batch Compute Node.

BatchError

Objekt

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message

BatchErrorMessage

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
values

BatchErrorDetail[]

Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthalten.

BatchErrorDetail

Objekt

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.

Name Typ Beschreibung
key

string

Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.
value

string

Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

BatchErrorMessage

Objekt

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

Name Typ Beschreibung
lang

string

Der Sprachcode der Fehlermeldung.
value

string

Der Text der Nachricht.

BatchNodeReimageOption

Enumeration

BatchNodeReimageOption enums

Wert Beschreibung
requeue

Beenden Sie die Ausführung von Aufgabenprozessen, und stellen Sie die Aufgaben erneut ab. Die Aufgaben werden erneut ausgeführt, wenn ein Computeknoten verfügbar ist. Aktualisieren Sie den Computeknoten, sobald Aufgaben beendet wurden.
terminate

Beenden Sie die Ausführung von Aufgaben. Die Aufgaben werden mit failureInfo abgeschlossen, die angibt, dass sie beendet wurden und nicht erneut ausgeführt werden. Aktualisieren Sie den Computeknoten, sobald Aufgaben beendet wurden.
taskcompletion

Zurzeit ausführende Aufgaben zulassen. Planen Sie beim Warten keine neuen Vorgänge. Aktualisieren Sie den Computeknoten, wenn alle Aufgaben abgeschlossen wurden.
retaineddata

Veraltet, empfehlen wir Ihnen, Aufgabendaten in Ihrer Aufgabe in Azure Storage hochzuladen und stattdessen zu verwenden TaskCompletion . Zulassen, dass derzeit ausgeführte Aufgaben abgeschlossen werden, und warten Sie dann, bis alle Aufbewahrungszeiträume für Aufgabendaten ablaufen. Planen Sie beim Warten keine neuen Vorgänge. Aktualisieren Sie den Computeknoten, wenn alle Aufbewahrungszeiträume für Aufgaben abgelaufen sind.

BatchNodeReimageOptions

Objekt

Parameter zum Reimaging eines Azure Batch Compute Node.

Name Typ Beschreibung
nodeReimageOption

BatchNodeReimageOption

Wann sie den Computeknoten neu abbilden und was mit derzeit ausgeführten Aufgaben zu tun ist. Der Standardwert wird erneut abfragt.