Alkalmazásállapot jelentése

Állapotjelentést küld a Service Fabric-alkalmazásról.

A megadott Service Fabric-alkalmazás állapotjelentése. A jelentésnek tartalmaznia kell az állapotjelentés forrására és a jelentés alapjául szolgáló tulajdonságra vonatkozó információkat. A jelentés egy Service Fabric-átjáróalkalmazásnak lesz elküldve, amely az állapottárolóba továbbítja. Előfordulhat, hogy az átjáró elfogadja a jelentést, de a további ellenőrzés után az állapottároló elutasítja. Előfordulhat például, hogy az állapottároló elutasítja a jelentést egy érvénytelen paraméter, például egy elavult sorszám miatt. Annak ellenőrzéséhez, hogy a jelentés alkalmazva lett-e az állapottárolóban, kérje le az alkalmazás állapotát, és ellenőrizze, hogy a jelentés megjelenik-e a HealthEvents szakaszban.

Kérés

Metódus	Kérés URI-ja
POST	/Applications/{applicationId}/$/ReportHealth?api-version=6.0&Immediate={Immediate}&timeout={timeout}

Paraméterek

Név	Típus	Kötelező	Hely
applicationId	sztring	Igen	Elérési út
api-version	sztring	Igen	Lekérdezés
Immediate	boolean	No	Lekérdezés
timeout	egész szám (int64)	No	Lekérdezés
HealthInformation	HealthInformation	Yes	Törzs

---

applicationId

Típus: sztring
Kötelező: Igen

Az alkalmazás identitása. Ez általában az alkalmazás teljes neve a "fabric:" URI séma nélkül. A 6.0-s verziótól kezdődően a hierarchikus nevek "~" karakterrel vannak elválasztva. Ha például az alkalmazás neve "fabric:/myapp/app1", akkor az alkalmazás identitása a "myapp~app1" lesz a 6.0-s vagy újabb verziókban, illetve a "myapp/app1" a korábbi verziókban.

---

api-version

Típus: sztring
Kötelező: Igen
Alapértelmezett: 6.0

Az API verziója. Ez a paraméter kötelező, értéke pedig "6.0".

A Service Fabric REST API-verziója azon a futtatókörnyezeti verzión alapul, amelyben az API-t bevezették vagy módosították. A Service Fabric-futtatókörnyezet az API több verzióját is támogatja. Ez az API legújabb támogatott verziója. Ha egy alacsonyabb API-verziót ad át, a visszaadott válasz eltérhet az ebben a specifikációban dokumentálttól.

Emellett a futtatókörnyezet minden olyan verziót elfogad, amely magasabb, mint a legújabb támogatott verzió, egészen a futtatókörnyezet aktuális verziójáig. Tehát ha a legújabb API-verzió a 6.0, de ha a futtatókörnyezet 6.1, az ügyfelek írásának megkönnyítése érdekében a futtatókörnyezet elfogadja az API 6.1-es verzióját. Az API viselkedése azonban a dokumentált 6.0-s verziónak megfelelően fog változni.

---

Immediate

Típus: logikai
Kötelező: Nem
Alapértelmezett: false

Jelölő, amely jelzi, hogy a jelentést azonnal el kell-e küldeni. A rendszer állapotjelentést küld egy Service Fabric-átjáróalkalmazásnak, amely az állapottárolóba továbbítja. Ha az Azonnali érték igaz, a rendszer azonnal elküldi a jelentést a HTTP Gatewayből az állapottárolóba, függetlenül attól, hogy milyen hálóügyfél-beállításokat használ a HTTP Gateway-alkalmazás. Ez olyan kritikus jelentések esetén hasznos, amelyeket a lehető leghamarabb el kell küldeni. Az időzítéstől és más feltételektől függően a jelentés elküldése továbbra is sikertelen lehet, például ha a HTTP-átjáró bezárult, vagy az üzenet nem éri el az átjárót. Ha az Azonnali érték false (hamis) értékre van állítva, a rendszer a jelentést a HTTP-átjáró állapotügyfél-beállításai alapján küldi el. Ezért a rendszer a HealthReportSendInterval konfigurációnak megfelelően kötegelve lesz. Ez az ajánlott beállítás, mert lehetővé teszi, hogy az állapotügyfél optimalizálja az állapotjelentési üzeneteket az állapottárolóba, valamint az állapotjelentések feldolgozását. Alapértelmezés szerint a jelentések nem lesznek azonnal elküldve.

---

timeout

Típus: egész szám (int64)
Kötelező: Nem
Alapértelmezett: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc.

---

HealthInformation

Típus: HealthInformation
Kötelező: Igen

Az állapotjelentés állapotinformációinak ismertetése. Ennek az információnak szerepelnie kell az állapotkezelőnek küldött összes állapotjelentésben.

Válaszok

HTTP-állapotkód	Description	Válaszséma
200 (OK)	A sikeres művelet 200 állapotkódot ad vissza.
Minden más állapotkód	A részletes hibaválasz.	Hálóerror