Share via


Compute Node - Reboot

Startar om den angivna beräkningsnoden.
Du kan bara starta om en beräkningsnod om den är inaktiv eller körs.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?timeout={timeout}&api-version=2023-11-01.18.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.

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 client-request-id i svaret.

ocp-date

string

date-time-rfc1123

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

Begärandetext

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

Name Typ Description
nodeRebootOption

ComputeNodeRebootOption

När beräkningsnoden ska startas om 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.

Headers

  • 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

Microsoft Entra OAuth 2.0-autentiseringskodflöde

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Personifiera ditt användarkonto

Authorization

Type: apiKey
In: header

Exempel

Node reboot

Sample Request

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reboot?api-version=2023-11-01.18.0



{
  "nodeRebootOption": "terminate"
}

Sample Response

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.

ComputeNodeRebootOption

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

ErrorMessage

Ett felmeddelande som tas emot i ett Azure Batch felsvar.

NodeRebootParameter

Alternativ för att starta om 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.

ComputeNodeRebootOption

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

Name Typ Description
requeue

string

Avsluta aktivitetsprocesser som körs och skicka aktiviteterna i kö igen. Aktiviteterna körs igen när en beräkningsnod är tillgänglig. Starta om 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 sedan tills alla kvarhållningsperioder för uppgiftsdata upphör att gälla. Schemalägg inga nya aktiviteter medan du väntar. Starta om 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. Starta om 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. Starta om beräkningsnoden så snart aktiviteterna har avslutats.

ErrorMessage

Ett felmeddelande som tas emot i ett Azure Batch felsvar.

Name Typ Description
lang

string

Språkkoden för felmeddelandet

value

string

Texten i meddelandet.

NodeRebootParameter

Alternativ för att starta om en beräkningsnod.

Name Typ Description
nodeRebootOption

ComputeNodeRebootOption

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