Stav uzlu sestavy

Článek
08/05/2023

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

Hlásí stav zadaného uzlu Service Fabric. Sestava musí obsahovat informace o zdroji sestavy o stavu a vlastnosti, na které je sestava hlášena. Sestava se odešle do uzlu 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 stavů. Úložiště stavů může například sestavu odmítnout 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 GetNodeHealth a zkontrolujte, jestli se sestava zobrazuje v části HealthEvents.

Žádost

Metoda	Identifikátor URI žádosti
POST	`/Nodes/{nodeName}/$/ReportHealth?api-version=6.0&Immediate={Immediate}&timeout={timeout}`

Parametry

Název	Typ	Vyžadováno	Umístění
`nodeName`	řetězec	Yes	Cesta
`api-version`	řetězec	Ano	Dotaz
`Immediate`	boolean	No	Dotaz
`timeout`	integer (int64)	No	Dotaz
`HealthInformation`	Informace o stavu	Yes	Text

`nodeName`

Typ: řetězec
Povinné: Ano

Název uzlu

`api-version`

Typ: řetězec
Povinné: Ano
Výchozí:6.0

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

Verze rozhraní REST API Service Fabric 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 se předá nižší verze rozhraní API, může se vrácená odpověď 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.

`Immediate`

Typ: boolean
Povinné: Ne
Výchozí:false

Příznak, který označuje, zda má být sestava odeslána okamžitě. Zpráva o stavu se odešle do aplikace brány Service Fabric, která se předává do úložiště stavů. Pokud je vlastnost Immediate nastavená na hodnotu true, sestava se okamžitě odešle z http Gateway do úložiště stavů 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 nedorazí do brány. Pokud je možnost Immediate nastavená na 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 do úložiště stavu i zpracování sestav stavu. Ve výchozím nastavení se sestavy neodesílají okamžitě.

`timeout`

Typ: integer (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 odesílaný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á chybová odpověď.	Chyba infrastruktury

Share via