Získání událostí chaosu

Získá další segment událostí Chaos na základě tokenu pokračování nebo časového rozsahu.

Pokud chcete získat další segment událostí Chaos, můžete zadat ContinuationToken. Chcete-li získat začátek nového segmentu událostí Chaos, můžete zadat časový rozsah prostřednictvím StartTimeUtc a EndTimeUtc. Ve stejném volání nelze zadat parametr ContinuationToken i časový rozsah. Pokud existuje více než 100 událostí chaosu, vrátí se události Chaosu ve více segmentech, kde segment neobsahuje více než 100 událostí Chaosu, a pro získání dalšího segmentu provedete volání tohoto rozhraní API s tokenem pokračování.

Žádost

Metoda	Identifikátor URI žádosti
GET	/Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout}

Parametry

Název	Typ	Vyžadováno	Umístění
api-version	řetězec	Ano	Dotaz
ContinuationToken	řetězec	No	Dotaz
StartTimeUtc	řetězec	No	Dotaz
EndTimeUtc	řetězec	No	Dotaz
MaxResults	celé číslo (int64)	Ne	Dotaz
timeout	celé číslo (int64)	Ne	Dotaz

---

api-version

Typ: string
Povinné: Ano
Výchozí:6.2

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

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. Tato verze je nejnovější podporovanou verzí 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 a modul runtime je 6.1, modul runtime pro toto rozhraní API přijme verzi 6.1. Chování rozhraní API však bude podle zdokumentované verze 6.0.

---

ContinuationToken

Typ: string
Povinné: Ne

Parametr pokračovacího tokenu se používá k získání další sady výsledků. Token pokračování s neprázdnou hodnotou je součástí odpovědi rozhraní API, pokud se výsledky ze systému nevejdou do jedné odpovědi. Když se tato hodnota předá dalšímu volání rozhraní API, vrátí rozhraní API další sadu výsledků. Pokud nejsou k dispozici žádné další výsledky, znamená to, že pokračovací token neobsahuje hodnotu. Hodnota tohoto parametru by neměla být kódovaná adresa URL.

---

StartTimeUtc

Typ: string
Povinné: Ne

Čas souboru systému Windows představující počáteční čas časového rozsahu, pro který se má vygenerovat sestava Chaos. Podrobnosti najdete v metodě DateTime.ToFileTimeUtc .

---

EndTimeUtc

Typ: string
Povinné: Ne

Čas souboru systému Windows představující koncový čas časového rozsahu, pro který se má vygenerovat sestava Chaos. Podrobnosti najdete v metodě DateTime.ToFileTimeUtc .

---

MaxResults

Typ: celé číslo (int64)
Povinné: Ne
Výchozí:0
InclusiveMinimum: 0

Maximální počet výsledků, které se mají vrátit jako součást stránkovaných dotazů. Tento parametr definuje horní mez počtu vrácených výsledků. Vrácené výsledky můžou být menší než zadané maximální výsledky, pokud se nevejdou do zprávy podle omezení maximální velikosti zprávy definované v konfiguraci. Pokud je tento parametr nula nebo není zadaný, stránkovaný dotaz obsahuje co nejvíce výsledků, které se vejdou do návratové zprávy.

---

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.

Odpovědi

Stavový kód HTTP	Description	Schéma odpovědi
200 (OK)	Další segment událostí chaosu.	ChaosEventsSegment
Všechny ostatní stavové kódy	Podrobná odpověď na chybu.	Chyba infrastruktury

Příklady

Získání událostí Chaosu s časovým rozsahem

Tento příklad ukazuje, jak získat události Chaos v jedné zprávě odpovědi bez nutnosti stránkování prostřednictvím parametru ContinuationToken.

Žádost

GET http://localhost:19080/Tools/Chaos/Events?api-version=6.2&StartTimeUtc=0&EndTimeUtc=3155378975999999999

Odpověď: 200

Text

{
  "ContinuationToken": "",
  "History": [
    {
      "ChaosEvent": {
        "Kind": "Started",
        "TimeStampUtc": "2017-04-14T04:27:19.049Z",
        "ChaosParameters": {
          "MaxClusterStabilizationTimeoutInSeconds": "30",
          "MaxConcurrentFaults": "3",
          "WaitTimeBetweenIterationsInSeconds": "10",
          "WaitTimeBetweenFaultsInSeconds": "1",
          "TimeToRunInSeconds": "3600",
          "EnableMoveReplicaFaults": true,
          "ClusterHealthPolicy": {
            "ConsiderWarningAsError": true,
            "MaxPercentUnhealthyNodes": "0",
            "MaxPercentUnhealthyApplications": "10",
            "ApplicationTypeHealthPolicyMap": [
              {
                "Key": "myapp",
                "Value": "3"
              }
            ]
          },
          "Context": {
            "Map": {
              "k1": "v1",
              "k2": "v2",
              "k3": "v5"
            }
          }
        }
      }
    },
    {
      "ChaosEvent": {
        "Kind": "ExecutingFaults",
        "TimeStampUtc": "2017-04-14T04:27:20.667Z",
        "Faults": [
          "ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_1, PartitionId: 6a91b09a-bd76-45da-afaa-ed0fd9bfe7d2, ReplicaId: 131366172775684622",
          "ActionType: CodePackageRestart, NodeName: N0050, ApplicationName: fabric:/TestApp1, ServiceManifestName: SP1, ServiceManifestName: , CodePackageName: CP1.",
          "ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_3, PartitionId: baa3a51e-5c42-435e-89d3-6e97b2164661, ReplicaId: 131366172988968762"
        ]
      }
    }
  ]
}