Stav repliky sestavy

Článek
08/05/2023

Odešle zprávu o stavu repliky Service Fabric.

Hlásí stav zadané repliky Service Fabric. Sestava musí obsahovat informace o zdroji sestavy o stavu a vlastnosti, na které je sestava hlášena. Sestava se odešle do repliky brány Service Fabric, která se předá do úložiště stavů. Sestava může být bránou přijata, ale po dodatečném ověření odmítnuta úložištěm stavu. Úložiště stavu může například odmítnout sestavu kvůli neplatnému parametru, jako je zastaralé pořadové číslo. Pokud chcete zjistit, jestli se sestava použila v úložišti stavů, spusťte příkaz GetReplicaHealth a zkontrolujte, jestli se sestava zobrazuje v části HealthEvents.

Žádost

Metoda	Identifikátor URI žádosti
POST	`/Partitions/{partitionId}/$/GetReplicas/{replicaId}/$/ReportHealth?api-version=6.0&ServiceKind={ServiceKind}&Immediate={Immediate}&timeout={timeout}`

Parametry

Název	Typ	Vyžadováno	Umístění
`partitionId`	string (uuid)	Yes	Cesta
`replicaId`	řetězec	Yes	Cesta
`api-version`	řetězec	Ano	Dotaz
`ServiceKind`	string (výčet)	Ano	Dotaz
`Immediate`	boolean	Ne	Dotaz
`timeout`	celé číslo (int64)	No	Dotaz
`HealthInformation`	Informace o stavu	Ano	Text

`partitionId`

Typ: řetězec (uuid)
Povinné: Ano

Identita oddílu.

`replicaId`

Typ: string
Povinné: Ano

Identifikátor repliky.

`api-version`

Typ: string
Povinné: Ano
Výchozí:6.0

Verze rozhraní API Tento parametr je povinný a jeho hodnota musí být 6.0.

Verze rozhraní SERVICE Fabric REST API je založená na verzi modulu runtime, ve které bylo rozhraní API zavedeno nebo změněno. Modul runtime Service Fabric podporuje více než jednu verzi rozhraní API. Toto je nejnovější podporovaná verze rozhraní API. Pokud je předána nižší verze rozhraní API, vrácená odpověď se může lišit od odpovědi popsané v této specifikaci.

Modul runtime navíc přijímá všechny verze, které jsou vyšší než nejnovější podporovaná verze až do aktuální verze modulu runtime. Pokud je tedy nejnovější verze rozhraní API 6.0, ale modul runtime je 6.1, aby se usnadnil zápis klientů, modul runtime pro toto rozhraní API přijme verzi 6.1. Chování rozhraní API však bude podle zdokumentované verze 6.0.

`ServiceKind`

Typ: řetězec (výčet)
Povinné: Ano
Výchozí:Stateful

Druh repliky služby (bezstavové nebo stavové), pro kterou se stav hlásí. Níže jsou uvedené možné hodnoty. Mezi možné hodnoty patří: "Bezstavový", "Stavový"

`Immediate`

Typ: logická
Povinné: Ne
Výchozí:false

Příznak, který označuje, jestli má být sestava odeslána okamžitě. Zpráva o stavu se odešle do aplikace služby Service Fabric Gateway, která se předá do úložiště stavu. Pokud je vlastnost Immediate nastavená na hodnotu true, sestava se okamžitě odešle ze služby HTTP Gateway do úložiště stavu bez ohledu na nastavení klienta prostředků infrastruktury, které aplikace SLUŽBY HTTP Gateway používá. To je užitečné pro kritické sestavy, které by se měly odeslat co nejdříve. V závislosti na načasování a dalších podmínkách může odeslání sestavy přesto selhat, například pokud je brána HTTP zavřená nebo se zpráva nedostane do brány. Pokud je možnost Immediate nastavená na hodnotu false, sestava se odešle na základě nastavení klienta stavu z brány HTTP. Proto bude dávková podle konfigurace HealthReportSendInterval. Toto nastavení se doporučuje, protože umožňuje klientovi stavu optimalizovat zprávy sestav o stavu pro úložiště stavu a zpracování sestav o stavu. Ve výchozím nastavení se sestavy neodesílají okamžitě.

`timeout`

Typ: celé číslo (int64)
Povinné: Ne
Výchozí:60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund.

`HealthInformation`

Typ: HealthInformation
Povinné: Ano

Popisuje informace o stavu sestavy stavu. Tyto informace musí být obsaženy ve všech sestavách o stavu odeslaných správci stavu.

Odpovědi

Stavový kód HTTP	Description	Schéma odpovědi
200 (OK)	Úspěšná operace vrátí stavový kód 200.
Všechny ostatní stavové kódy	Podrobná odpověď na chybu.	Chyba infrastruktury

Sdílet prostřednictvím