Hämta kaoshändelser

Hämtar nästa segment av Chaos-händelserna baserat på fortsättningstoken eller tidsintervallet.

Om du vill hämta nästa segment av Chaos-händelserna kan du ange ContinuationToken. För att komma igång med ett nytt segment av Chaos-händelser kan du ange tidsintervallet via StartTimeUtc och EndTimeUtc. Du kan inte ange både ContinuationToken och tidsintervallet i samma anrop. När det finns fler än 100 Chaos-händelser returneras Chaos-händelserna i flera segment där ett segment inte innehåller fler än 100 Chaos-händelser och för att hämta nästa segment gör du ett anrop till det här API:et med fortsättningstoken.

Förfrågan

Metod	URI för förfrågan
GET	/Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout}

Parametrar

Namn	Typ	Obligatorisk	Location
api-version	sträng	Ja	Söka i data
ContinuationToken	sträng	No	Söka i data
StartTimeUtc	sträng	No	Söka i data
EndTimeUtc	sträng	No	Söka i data
MaxResults	heltal (int64)	No	Söka i data
timeout	heltal (int64)	No	Söka i data

---

api-version

Typ: sträng
Obligatoriskt: Ja
Standard: 6.2

Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.2".

Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Den här versionen är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som beskrivs i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds fram till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0 och körningen är 6.1 accepterar körningen version 6.1 för det API:et. Beteendet för API:et kommer dock att vara enligt den dokumenterade 6.0-versionen.

---

ContinuationToken

Typ: sträng
Obligatoriskt: Nej

Parametern fortsättningstoken används för att hämta nästa uppsättning resultat. En fortsättningstoken med ett icke-tomt värde ingår i API:ets svar när resultatet från systemet inte får plats i ett enda svar. När det här värdet skickas till nästa API-anrop returnerar API:et nästa uppsättning resultat. Om det inte finns några ytterligare resultat innehåller fortsättningstoken inget värde. Värdet för den här parametern ska inte vara URL-kodat.

---

StartTimeUtc

Typ: sträng
Obligatoriskt: Nej

Windows-filtiden som representerar starttiden för det tidsintervall för vilket en Chaos-rapport ska genereras. Mer information finns i DateTime.ToFileTimeUtc-metoden .

---

EndTimeUtc

Typ: sträng
Obligatoriskt: Nej

Windows-filtiden som representerar sluttiden för det tidsintervall för vilket en Chaos-rapport ska genereras. Mer information finns i DateTime.ToFileTimeUtc-metoden .

---

MaxResults

Typ: heltal (int64)
Obligatoriskt: Nej
Standard: 0
InclusiveMinimum: 0

Det maximala antalet resultat som ska returneras som en del av de sidiga frågorna. Den här parametern definierar den övre gränsen för antalet returnerade resultat. Resultatet som returneras kan vara mindre än det angivna maximala resultatet om de inte får plats i meddelandet enligt de maximala begränsningarna för meddelandestorleken som definierats i konfigurationen. Om den här parametern är noll eller inte angiven innehåller den sidade frågan så många resultat som möjligt som får plats i returmeddelandet.

---

timeout

Typ: heltal (int64)
Obligatoriskt: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.

Svar

HTTP-statuskod	Description	Svarsschema
200 (OK)	Nästa segment av Chaos-händelser.	ChaosEventsSegment
Alla andra statuskoder	Det detaljerade felsvaret.	FabricError

Exempel

Hämta kaoshändelser givet ett tidsintervall

Det här exemplet visar hur du hämtar Chaos-händelser i ett enda svarsmeddelande utan att behöva söka via parametern ContinuationToken.

Förfrågan

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

200-svar

Brödtext

{
  "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"
        ]
      }
    }
  ]
}