Dela via

Flytta instans

  • Artikel

Flyttar instansen av en partition av en tillståndslös tjänst.

Det här kommandot flyttar instansen av en partition av en tillståndslös tjänst med respekt för alla begränsningar. Partitions-ID och tjänstnamn måste anges för att kunna flytta instansen. CurrentNodeName när det anges identifierar den instans som flyttas. Om inte anges flyttas slumpmässig instans Nytt nodnamn kan utelämnas och i så fall flyttas instansen till en slumpmässig nod. Om parametern IgnoreConstraints har angetts och angetts till true flyttas instansen oavsett begränsningarna.

Förfrågan

Metod URI för förfrågan
POST /Services/{serviceId}/$/GetPartitions/{partitionId}/$/MoveInstance?api-version=8.0&CurrentNodeName={CurrentNodeName}&NewNodeName={NewNodeName}&IgnoreConstraints={IgnoreConstraints}&timeout={timeout}

Parametrar

Namn Typ Obligatorisk Location
serviceId sträng Ja Sökväg
partitionId sträng (uuid) Yes Sökväg
api-version sträng Ja Söka i data
CurrentNodeName sträng No Söka i data
NewNodeName sträng No Söka i data
IgnoreConstraints boolean No Söka i data
timeout heltal (int64) No Söka i data

serviceId

Typ: sträng
Obligatoriskt: Ja

Tjänstens identitet. Det här ID:t är vanligtvis det fullständiga namnet på tjänsten utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om tjänstnamnet till exempel är "fabric:/myapp/app1/svc1" skulle tjänstidentiteten vara "myapp~app1~svc1" i 6.0+ och "myapp/app1/svc1" i tidigare versioner.

partitionId

Typ: sträng (uuid)
Obligatoriskt: Ja

Partitionens identitet.

api-version

Typ: sträng
Obligatoriskt: Ja
Standard: 8.0

Versionen av API:et. Den här parametern krävs och dess värde måste vara "8.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. Den här versionen ä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 beskrivs i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds fram till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0 och körningen är 6.1 accepterar körningen version 6.1 för det API:et. Beteendet för API:et kommer dock att vara enligt den dokumenterade 6.0-versionen.

CurrentNodeName

Typ: sträng
Obligatoriskt: Nej

Namnet på källnoden för instansflytt. Om inte anges flyttas instansen från en slumpmässig nod.

NewNodeName

Typ: sträng
Obligatoriskt: Nej

Namnet på målnoden för sekundär replik eller instansflytt. Om det inte anges flyttas repliken eller instansen till en slumpmässig nod.

IgnoreConstraints

Typ: booleskt
Obligatoriskt: Nej
Standard: false

Ignorera begränsningar när du flyttar en replik eller instans. Om den här parametern inte anges respekteras alla begränsningar.

timeout

Typ: heltal (int64)
Obligatoriskt: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns timeout 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) En lyckad åtgärdsbegäran returnerar statuskoden 200.
Alla andra statuskoder Det detaljerade felsvaret.
 FabricError