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 |