Läs på engelska

Dela via

Hämta förlopp för nodövergång

  • Artikel
  • 2023-08-05

Hämtar förloppet för en åtgärd som startats med StartNodeTransition.

Hämtar förloppet för en åtgärd som startas med StartNodeTransition med hjälp av angivet OperationId.

Förfrågan

Metod URI för förfrågan
GET /Faults/Nodes/{nodeName}/$/GetTransitionProgress?api-version=6.0&OperationId={OperationId}&timeout={timeout}

Parametrar

Namn Typ Obligatorisk Location
nodeName sträng Ja Sökväg
api-version sträng Ja Söka i data
OperationId sträng (uuid) Ja Söka i data
timeout heltal (int64) No Söka i data

nodeName

Typ: sträng
Krävs: Ja

Namnet på noden.

api-version

Typ: sträng
Krävs: Ja
Standard: 6.0

Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.0".

Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Det här är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som dokumenteras i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds upp till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0, men om körningen är 6.1, accepterar körningen version 6.1 för det API:et för att göra det enklare att skriva klienterna. Beteendet för API:et är dock enligt den dokumenterade 6.0-versionen.

OperationId

Typ: sträng (uuid)
Krävs: Ja

Ett GUID som identifierar ett anrop för det här API:et. Detta skickas till motsvarande GetProgress-API

timeout

Typ: heltal (int64)
Krävs: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns tidsgräns för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.

Svar

HTTP-statuskod Description Svarsschema
200 (OK) Information om förloppet för en nodövergångsåtgärd.
 NodeTransitionProgress
Alla andra statuskoder Det detaljerade felsvaret.
 FabricError

Exempel

Hämtar information om en slutförd NodeTransition-åtgärd

Detta visar ett exempel på möjliga utdata när GetTransitionProgress har nått tillståndet Slutförd. Om State har värdet Running (Körs) har endast fältet State ett värde.

Förfrågan

GET http://localhost:19080/Faults/Nodes/N0060/$/GetTransitionProgress?api-version=6.0&OperationId=a9c24269-88e9-4812-b4ad-a0bf2b724ad4

200 Svar

Brödtext
{
  "State": "Completed",
  "NodeTransitionResult": {
    "ErrorCode": "0",
    "NodeResult": {
      "NodeName": "N0060",
      "NodeInstanceId": "131366982707950527"
    }
  }
}

Hämtar information om en NodeTransition-åtgärd som körs

Detta visar ett exempel på utdata när GetTransitionProgress har tillståndet Körs.

Förfrågan

GET http://localhost:19080/Faults/Nodes/N0060/$/GetTransitionProgress?api-version=6.0&OperationId=ed903556-acf1-489c-9f33-b484c31f9087

200 Svar

Brödtext
{
  "State": "Running"
}