Csomópont eseménylistájának lekérése

  • Cikk

Csomóponttal kapcsolatos események lekérése.

A válasz a NodeEvent-objektumok listája.

Kérés

Metódus Kérés URI-ja
GET /EventsStore/Nodes/{nodeName}/$/Events?api-version=6.4&timeout={timeout}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&EventsTypesFilter={EventsTypesFilter}&ExcludeAnalysisEvents={ExcludeAnalysisEvents}&SkipCorrelationLookup={SkipCorrelationLookup}

Paraméterek

Név Típus Kötelező Hely
nodeName sztring Igen Elérési út
api-version sztring Igen Lekérdezés
timeout egész szám (int64) No Lekérdezés
StartTimeUtc sztring Igen Lekérdezés
EndTimeUtc sztring Igen Lekérdezés
EventsTypesFilter sztring No Lekérdezés
ExcludeAnalysisEvents boolean No Lekérdezés
SkipCorrelationLookup boolean No Lekérdezés

nodeName

Típus: sztring
Kötelező: Igen

A csomópont neve.

api-version

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

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

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 a verzió 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 a legújabb támogatott verziónál magasabb a futtatókörnyezet aktuális verziójáig. Tehát ha az API legújabb verziója 6.0, a futtatókörnyezet pedig 6.1, akkor 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.

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.

StartTimeUtc

Típus: sztring
Kötelező: Igen

Keresési lekérdezés kezdő időpontja ISO UTC yyyy-MM-ddTHH:mm:ssZ formátumban.

EndTimeUtc

Típus: sztring
Kötelező: Igen

Keresési lekérdezés záró időpontja ISO UTC yyyy-MM-ddTHH:mm:ssZ formátumban.

EventsTypesFilter

Típus: sztring
Kötelező: Nem

Ez egy vesszővel tagolt sztring, amely megadja a FabricEvents típusait, amelyeket csak a válasz tartalmaz.

ExcludeAnalysisEvents

Típus: logikai
Kötelező: Nem

Ez a param letiltja az AnalysisEvents lekérését, ha igaz érték van átadva.

SkipCorrelationLookup

Típus: logikai
Kötelező: Nem

Ez a param letiltja a CorrelatedEvents-információk keresését, ha igaz értéket ad meg. ellenkező esetben a CorrelationEvents feldolgozása és a HasCorrelatedEvents mező minden FabricEventben fel lesz töltve.

Válaszok

HTTP-állapotkód Description Válaszséma
200 (OK) A NodeEvent alaptípusú eseményobjektumok listája.
 NodeEvent tömbje
Minden más állapotkód A részletes hibaválasz.
 FabricError

Példák

Ez a példa bemutatja, hogyan szerezhet be minden csomóponttal kapcsolatos eseményt egy adott időszakban.

Kérés

GET http://localhost:19080/EventsStore/Nodes/node1/$/Events?api-version=6.4&StartTimeUtc=2018-04-03T18:00:00Z&EndTimeUtc=2018-04-04T18:00:00Z

200 Válasz

Törzs
[
  {
    "Kind": "NodeOpenSucceeded",
    "NodeInstance": "131672596159209220",
    "NodeId": "ba001a8bb353543e646be031afb10f1e",
    "UpgradeDomain": "0",
    "FaultDomain": "fd:/0",
    "IpAddressOrFQDN": "100.78.240.56",
    "Hostname": "RD0003FF5089AA",
    "IsSeedNode": false,
    "NodeVersion": "6.2:1.0",
    "NodeName": "node1",
    "EventInstanceId": "ecbce04a-a42b-4b70-a800-dfc6bc4f9b89",
    "TimeStamp": "2018-04-03T20:06:55.966073Z",
    "HasCorrelatedEvents": false
  }
]