Delen via

Nodes - Reimage Node

Service:
Batch Service
API-versie:
2025-06-01

Installeert het besturingssysteem opnieuw op het opgegeven rekenknooppunt.
U kunt het besturingssysteem alleen opnieuw installeren op een rekenknooppunt als het een niet-actieve of actieve status heeft. Deze API kan alleen worden aangeroepen op pools die zijn aangemaakt met de cloud service configuratie-eigenschap.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2025-06-01
Met optionele parameters: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2025-06-01&timeOut={timeOut}

URI-parameters

Name In Vereist Type Description
endpoint
 path True

string (uri)

Batch-accounteindpunt (bijvoorbeeld: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

De id van het rekenknooppunt dat u opnieuw wilt opstarten.
poolId
 path True

string

De id van de pool die het rekenknooppunt bevat.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.
timeOut
 query

integer (int32)

De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. Als de waarde groter is dan 30, wordt de standaard in plaats daarvan gebruikt."

Aanvraagkoptekst

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

Name Vereist Type Description
client-request-id

string

De door de aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Of de server de clientaanvraag-id in het antwoord moet retourneren.
ocp-date

string (date-time-rfc7231)

Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige kloktijd van het systeem; stel deze expliciet in als u de REST API rechtstreeks aanroept.

Aanvraagbody

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

Name Type Description
nodeReimageOption

BatchNodeReimageOption

Wanneer moet u de installatiekopie van het rekenknooppunt herstellen en wat u moet doen met taken die momenteel worden uitgevoerd. De standaardwaarde wordt opnieuw weergegeven.

Antwoorden

Name Type Description
202 Accepted

De aanvraag is geaccepteerd voor verwerking, maar de verwerking is nog niet voltooid.

Kopteksten

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

BatchError

Een onverwachte foutreactie.

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

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

Voorbeelden

Node reimage

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
202

Definities

Name Description
BatchError

Er is een foutbericht ontvangen van de Azure Batch-service.
BatchErrorDetail

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
BatchErrorMessage

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.
BatchNodeReimageOption

BatchNodeReimageOption enums
BatchNodeReimageOptions

Parameters voor het opnieuw opgeven van een Azure Batch Compute-knooppunt.

BatchError

Object

Er is een foutbericht ontvangen van de Azure Batch-service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message

BatchErrorMessage

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
values

BatchErrorDetail[]

Een verzameling sleutel-waardeparen met aanvullende informatie over de fout.

BatchErrorDetail

Object

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.

Name Type Description
key

string

Een id die de betekenis van de eigenschap Waarde aangeeft.
value

string

De aanvullende informatie die is opgenomen in het foutbericht.

BatchErrorMessage

Object

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.

Name Type Description
lang

string

De taalcode van het foutbericht.
value

string

De tekst van het bericht.

BatchNodeReimageOption

Opsomming

BatchNodeReimageOption enums

Waarde Description
requeue

Beëindig actieve taakprocessen en volg de taken opnieuw. De taken worden opnieuw uitgevoerd wanneer er een rekenknooppunt beschikbaar is. De installatiekopie van het rekenknooppunt herstellen zodra taken zijn beëindigd.
terminate

Beëindig de uitvoering van taken. De taken worden voltooid met failureInfo die aangeeft dat ze zijn beëindigd en worden niet opnieuw uitgevoerd. De installatiekopie van het rekenknooppunt herstellen zodra taken zijn beëindigd.
taskcompletion

Sta toe dat taken die momenteel worden uitgevoerd, worden voltooid. Plan geen nieuwe taken tijdens het wachten. Wijzig de installatiekopie van het rekenknooppunt wanneer alle taken zijn voltooid.
retaineddata

Als deze is afgeschaft, raden we u aan taakgegevens te uploaden naar Azure Storage in uw taak en in plaats daarvan te gebruiken TaskCompletion . Sta toe dat actieve taken zijn voltooid en wacht totdat alle retentieperioden voor taakgegevens verlopen. Plan geen nieuwe taken tijdens het wachten. Wijzig de installatiekopie van het rekenknooppunt wanneer alle retentieperioden voor taken zijn verlopen.

BatchNodeReimageOptions

Object

Parameters voor het opnieuw opgeven van een Azure Batch Compute-knooppunt.

Name Type Description
nodeReimageOption

BatchNodeReimageOption

Wanneer moet u de installatiekopie van het rekenknooppunt herstellen en wat u moet doen met taken die momenteel worden uitgevoerd. De standaardwaarde wordt opnieuw weergegeven.