Kvórumvesztés indítása
Egy adott állapotalapú szolgáltatáspartíció kvórumvesztését idézi elő.
Ez az API a szolgáltatás ideiglenes kvórumvesztési helyzetéhez használható.
Hívja meg a GetQuorumLossProgress API-t ugyanazzal az OperationId azonosítóval, és adja vissza az ezzel az API-val indított művelettel kapcsolatos információkat.
Ez csak állapotalapú tartós (HasPersistedState==true) szolgáltatások esetén hívható meg. Ne használja ezt az API-t állapot nélküli szolgáltatásokhoz vagy csak memóriabeli állapotalapú szolgáltatásokhoz.
Kérés
Metódus | Kérés URI-ja |
---|---|
POST | /Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartQuorumLoss?api-version=6.0&OperationId={OperationId}&QuorumLossMode={QuorumLossMode}&QuorumLossDuration={QuorumLossDuration}&timeout={timeout} |
Paraméterek
Név | Típus | Kötelező | Hely |
---|---|---|---|
serviceId |
sztring | Igen | Elérési út |
partitionId |
sztring (uuid) | Yes | Elérési út |
api-version |
sztring | Igen | Lekérdezés |
OperationId |
sztring (uuid) | Igen | Lekérdezés |
QuorumLossMode |
sztring (enumerálás) | Igen | Lekérdezés |
QuorumLossDuration |
egész szám | Igen | Lekérdezés |
timeout |
egész szám (int64) | No | Lekérdezés |
serviceId
Típus: sztring
Kötelező: Igen
A szolgáltatás identitása. Ez az azonosító általában a szolgáltatás teljes neve a "háló:" URI-séma nélkül.
A 6.0-s verziótól kezdve a hierarchikus nevek a "~" karakterrel vannak elválasztva.
Ha például a szolgáltatás neve "fabric:/myapp/app1/svc1", akkor a szolgáltatás identitása a "myapp~app1~svc1" lesz a 6.0+-ban és a "myapp/app1/svc1" a korábbi verziókban.
partitionId
Típus: sztring (uuid)
Kötelező: Igen
A partíció identitása.
api-version
Típus: sztring
Kötelező: Igen
Alapértelmezett: 6.0
Az API verziója. Ez a paraméter kötelező, értéke pedig "6.0".
A Service Fabric REST API-verziója azon a futtatókörnyezeti verzión alapul, amelyben az API-t bevezették vagy módosították. A Service Fabric-futtatókörnyezet az API több verzióját is támogatja. Ez az API legújabb támogatott verziója. Ha egy alacsonyabb API-verziót ad át, a visszaadott válasz eltérhet az ebben a specifikációban dokumentálttól.
Emellett a futtatókörnyezet elfogad minden olyan verziót, amely magasabb, mint a legújabb támogatott verzió, egészen a futtatókörnyezet aktuális verziójáig. Ha tehát a legújabb API-verzió a 6.0, de a futtatókörnyezet 6.1, az ügyfelek írásának megkönnyítése érdekében a futtatókörnyezet elfogadja az API 6.1-es verzióját. Az API viselkedése azonban a dokumentált 6.0-s verziónak megfelelően fog változni.
OperationId
Típus: sztring (uuid)
Kötelező: Igen
Az API hívását azonosító GUID. Ez a megfelelő GetProgress API-nak lesz átadva
QuorumLossMode
Típus: sztring (enumerálás)
Kötelező: Igen
Ez az enumerálás a StartQuorumLoss API-nak továbbítja, hogy jelezze, milyen típusú kvórumveszteséget okoz. Lehetséges értékek: "Invalid", "QuorumReplicas", "AllReplicas"
QuorumLossDuration
Típus: egész szám
Kötelező: Igen
A partíció kvórumvesztésben való megőrzésének időtartama. Ezt másodpercben kell megadni.
timeout
Típus: egész szám (int64)
Kötelező: Nem
Alapértelmezett: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
A kiszolgáló időtúllépése a művelet másodpercben történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc.
Válaszok
HTTP-állapotkód | Description | Válaszséma |
---|---|---|
202 (Elfogadva) | A 202-s állapotkód azt jelzi, hogy a művelet elfogadva lett. Hívja meg a GetQuorumLossProgress API-t a folyamat lekéréséhez. |
|
Minden más állapotkód | A részletes hibaválasz. |
FabricError |