Dela via

Compute Node - Reimage

  • Referens
Tjänst:
Batch Service
API-version:
2024-07-01.20.0

Installerar om operativsystemet på den angivna beräkningsnoden.
Du kan bara installera om operativsystemet på en beräkningsnod om det är i ett inaktivt eller körs-tillstånd.

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

URI-parametrar

Name I Obligatorisk Typ Description
batchUrl
 path True

string

Bas-URL:en för alla Azure Batch-tjänstbegäranden.
nodeId
 path True

string

ID:t för den beräkningsnod som du vill starta om.
poolId
 path True

string

ID:t för poolen som innehåller beräkningsnoden.
api-version
 query True

string

Klient-API-version.
timeout
 query

integer

int32

Den maximala tid som servern kan ägna åt att bearbeta begäran i sekunder. Standardvärdet är 30 sekunder. Om värdet är större än 30 används standardvärdet i stället.

Begärandehuvud

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

Name Obligatorisk Typ Description
client-request-id

string

uuid

Den anropargenererade begärandeidentiteten i form av ett GUID utan dekoration, till exempel klammerparenteser, t.ex. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Om servern ska returnera klient-request-id i svaret.
ocp-date

string

date-time-rfc1123

Den tid då begäran utfärdades. Klientbibliotek anger vanligtvis detta till den aktuella systemklockatiden. ange det explicit om du anropar REST-API:et direkt.

Begärandetext

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

Name Typ Description
nodeReimageOption

ComputeNodeReimageOption

När beräkningsnoden ska optimeras och vad du ska göra med aktiviteter som körs.
Standardvärdet skickas på nytt.

Svar

Name Typ Description
202 Accepted

Begäran till Batch-tjänsten lyckades.

Sidhuvuden

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

BatchError

Felet från Batch-tjänsten.

Säkerhet

azure_auth

Autentiseringskodflöde för Microsoft Entra OAuth 2.0

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation Personifiera ditt användarkonto

Authorization

Typ: apiKey
I: header

Exempel

Node reimage

Exempelbegäran

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



{
  "nodeReimageOption": "terminate"
}

Exempelsvar

Statuskod:
202

Definitioner

Name Description
BatchError

Ett felsvar som tagits emot från Azure Batch-tjänsten.
BatchErrorDetail

Ett objekt med ytterligare information som ingår i ett Azure Batch-felsvar.
ComputeNodeReimageOption

När beräkningsnoden ska optimeras och vad du ska göra med aktiviteter som körs.
ErrorMessage

Ett felmeddelande som togs emot i ett Azure Batch-felsvar.
NodeReimageParameter

Alternativ för att återskapa en beräkningsnod.

BatchError

Ett felsvar som tagits emot från Azure Batch-tjänsten.

Name Typ Description
code

string

En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
message

ErrorMessage

Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.
values

BatchErrorDetail[]

En samling nyckel/värde-par som innehåller ytterligare information om felet.

BatchErrorDetail

Ett objekt med ytterligare information som ingår i ett Azure Batch-felsvar.

Name Typ Description
key

string

En identifierare som anger innebörden av egenskapen Value.
value

string

Den ytterligare information som ingår i felsvaret.

ComputeNodeReimageOption

När beräkningsnoden ska optimeras och vad du ska göra med aktiviteter som körs.

Name Typ Description
requeue

string

Avsluta aktivitetsprocesser som körs och skicka aktiviteterna på nytt. Aktiviteterna körs igen när en beräkningsnod är tillgänglig. Ändra storlek på beräkningsnoden så snart aktiviteterna har avslutats.
retaineddata

string

Tillåt att aktiviteter som körs för närvarande slutförs och vänta tills alla kvarhållningsperioder för uppgiftsdata upphör att gälla. Schemalägg inga nya aktiviteter medan du väntar. Återskapa beräkningsnoden när alla kvarhållningsperioder för aktiviteter har upphört att gälla.
taskcompletion

string

Tillåt att aktiviteter som körs för närvarande slutförs. Schemalägg inga nya aktiviteter medan du väntar. Ändra storlek på beräkningsnoden när alla aktiviteter har slutförts.
terminate

string

Avsluta aktiviteter som körs. Aktiviteterna slutförs med failureInfo som anger att de har avslutats och inte körs igen. Ändra storlek på beräkningsnoden så snart aktiviteterna har avslutats.

ErrorMessage

Ett felmeddelande som togs emot i ett Azure Batch-felsvar.

Name Typ Description
lang

string

Språkkoden för felmeddelandet
value

string

Texten i meddelandet.

NodeReimageParameter

Alternativ för att återskapa en beräkningsnod.

Name Typ Description
nodeReimageOption

ComputeNodeReimageOption

När beräkningsnoden ska optimeras och vad du ska göra med aktiviteter som körs.
Standardvärdet skickas på nytt.