Starta kvorumförlust

Artikel
08/05/2023

Inducerar kvorumförlust för en viss tillståndskänslig tjänstpartition.

Det här API:et är användbart för en tillfällig kvorumförlust på din tjänst.

Anropa API:et GetQuorumLossProgress med samma OperationId för att returnera information om åtgärden som startades med det här API:et.

Detta kan bara anropas för tillståndskänsliga beständiga tjänster (HasPersistedState==true). Använd inte det här API:et på tillståndslösa tjänster eller tillståndskänsliga minnesinterna tjänster.

Förfrågan

Metod	URI för förfrågan
POST	`/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartQuorumLoss?api-version=6.0&OperationId={OperationId}&QuorumLossMode={QuorumLossMode}&QuorumLossDuration={QuorumLossDuration}&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
`OperationId`	sträng (uuid)	Ja	Söka i data
`QuorumLossMode`	sträng (uppräkning)	Ja	Söka i data
`QuorumLossDuration`	heltal	Ja	Söka i data
`timeout`	heltal (int64)	No	Söka i data

`serviceId`

Typ: sträng
Krävs: 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)
Krävs: Ja

Partitionens identitet.

`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

`QuorumLossMode`

Typ: sträng (uppräkning)
Krävs: Ja

Den här uppräkningen skickas till StartQuorumLoss-API:et för att ange vilken typ av kvorumförlust som ska induceras. Möjliga värden är: "Invalid", "QuorumReplicas", "AllReplicas"

`QuorumLossDuration`

Typ: heltal
Krävs: Ja

Hur lång tid partitionen ska hållas i kvorumförlust. Detta måste anges i sekunder.

`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
202 (godkänd)	Statuskoden 202 anger att åtgärden godkändes. Anropa API:et GetQuorumLossProgress för att hämta förloppet.
Alla andra statuskoder	Det detaljerade felsvaret.	FabricError

Dela via