Compute Node - Reimage

Service:

Batch Service

API-versie:

2024-07-01.20.0

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.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2024-07-01.20.0

Met optionele parameters:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?timeout={timeout}&api-version=2024-07-01.20.0

URI-parameters

Name	In	Vereist	Type	Description
batchUrl	path	True	string	De basis-URL voor alle Azure Batch-serviceaanvragen.
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	Client-API-versie.
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 in plaats daarvan de standaardwaarde gebruikt.

Aanvraagkoptekst

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

Name	Vereist	Type	Description
client-request-id		string uuid	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-rfc1123	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	ComputeNodeReimageOption	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 voor de Batch-service is geslaagd. Kopteksten client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	De fout van de Batch-service.

Beveiliging

azure_auth

Microsoft Entra OAuth 2.0-verificatiecodestroom

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

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Authorization

Type: apiKey
In: header

Voorbeelden

Node reimage

Voorbeeldaanvraag

HTTP

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



{
  "nodeReimageOption": "terminate"
}

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.
ComputeNodeReimageOption	Wanneer moet u de installatiekopie van het rekenknooppunt herstellen en wat u moet doen met taken die momenteel worden uitgevoerd.
ErrorMessage	Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.
NodeReimageParameter	Opties voor het opnieuw instellen van een rekenknooppunt.

BatchError

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	ErrorMessage	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

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.

ComputeNodeReimageOption

Wanneer moet u de installatiekopie van het rekenknooppunt herstellen en wat u moet doen met taken die momenteel worden uitgevoerd.

Name	Type	Description
requeue	string	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.
retaineddata	string	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.
taskcompletion	string	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.
terminate	string	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.

ErrorMessage

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.

NodeReimageParameter

Opties voor het opnieuw instellen van een rekenknooppunt.

Name	Type	Description
nodeReimageOption	ComputeNodeReimageOption	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.