Stav repliky sestavy

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