Share via

Sestava stavu nasazených balíčků služeb

  • Článek

Odešle zprávu o stavu balíčku služby nasazeného službou Service Fabric.

Sestavuje stav balíčku služby aplikace nasazené v uzlu Service Fabric. Sestava musí obsahovat informace o zdroji sestavy o stavu a vlastnosti, na které je sestava hlášena. Sestava se odešle službě 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ů, získejte nasazený stav balíčku služby a zkontrolujte, jestli se sestava zobrazuje v části HealthEvents.

Žádost

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

Parametry

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

nodeName

Typ: string
Povinné: Ano

Název uzlu

applicationId

Typ: string
Povinné: Ano

Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.

servicePackageName

Typ: string
Povinné: Ano

Název balíčku služby.

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.

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