Megosztás a következőn keresztül:

Infrastruktúra-lekérdezés meghívása v82

Egy írásvédett lekérdezést hív meg az adott infrastruktúra-szolgáltatáspéldányon.

Az infrastruktúra-szolgáltatás egy vagy több példányával rendelkező fürtök esetében ez az API lehetővé teszi az infrastruktúra-specifikus lekérdezések küldését az infrastruktúra-szolgáltatás egy adott példányára.

Az elérhető parancsok és a hozzájuk tartozó válaszformátumok attól függően változnak, hogy milyen infrastruktúrán fut a fürt.

Ez az API támogatja a Service Fabric platformot; nem közvetlenül a kódból való használatra szolgál.

Kérés

Metódus Kérés URI-ja
GET /$/InvokeInfrastructureQuery?api-version=6.0&Command={Command}&ServiceId={ServiceId}&timeout={timeout}

Paraméterek

Név Típus Kötelező Hely
api-version sztring Igen Lekérdezés
Command sztring Igen Lekérdezés
ServiceId sztring No Lekérdezés
timeout egész szám (int64) No Lekérdezés

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 elfogad minden olyan verziót, amely magasabb, mint a legújabb támogatott verzió, egészen a futtatókörnyezet aktuális verziójáig. Ha tehát a legújabb API-verzió a 6.0, de 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.

Command

Típus: sztring
Kötelező: Igen

A meghívandó parancs szövege. A parancs tartalma infrastruktúra-specifikus.

ServiceId

Típus: sztring
Kötelező: Nem

Az infrastruktúra-szolgáltatás identitása. Ez az infrastruktúra-szolgáltatás teljes neve a "háló:" URI-séma nélkül. Ez a paraméter csak ahhoz a fürthöz szükséges, amelyen egynél több infrastruktúra-szolgáltatás fut.

timeout

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

A kiszolgáló időtúllépése a művelet másodpercben történő végrehajtásához. 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.

Válaszok

HTTP-állapotkód Description Válaszséma
200 (OK) Az infrastruktúra-szolgáltatás válasza. A válaszformátum egy JSON-stream.
A válasz tartalma attól függ, hogy melyik parancs lett kiadva.
 sztring
Minden más állapotkód A részletes hibaválasz.
 FabricError