取得混亂事件

發行項
08/05/2023

根據接續權杖或時間範圍取得 Chaos 事件的下一個區段。

若要取得 Chaos 事件的下一個區段，您可以指定 ContinuationToken。若要取得 Chaos 事件新區段的開頭，您可以透過 StartTimeUtc 和 EndTimeUtc 來指定時間範圍。您可以在同一個呼叫中同時指定 ContinuationToken 和時間範圍。當 Chaos 事件超過 100 個時，系統會以多個區段傳回 Chaos 事件，其中每個區段包含的 Chaos 事件不超過 100 個，而若要取得下一個區段，您可以使用接續權杖來對此 API 發出呼叫。

要求

方法	要求 URI
GET	`/Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout}`

參數

名稱	類型	必要	Location
`api-version`	字串	是	查詢
`ContinuationToken`	字串	No	查詢
`StartTimeUtc`	字串	No	查詢
`EndTimeUtc`	字串	No	查詢
`MaxResults`	整數 (int64)	No	查詢
`timeout`	整數 (int64)	No	查詢

`api-version`

類型：字串
必要：是
預設：6.2

API 的版本。這是必要參數，其值必須是 '6.2'。

Service Fabric REST API 版本是以導入或變更 API 的執行時間版本為基礎。 Service Fabric 執行時間支援多個版本的 API。此版本是 API 的最新支援版本。如果傳遞較低的 API 版本，傳回的回應可能與此規格中所述的回應不同。

此外，執行時間會接受高於最新支援版本的任何版本，最高到目前版本的執行時間。因此，如果最新的 API 版本為 6.0，且執行時間為 6.1，則執行時間將會接受該 API 的版本 6.1。不過，API 的行為會根據記載的 6.0 版本。

`ContinuationToken`

類型：字串
必要：否

接續權杖參數可用來取得下一組結果。當來自系統的結果無法放入單一回應中時，API 的回應中會包含具有非空白值的接續權杖。當此值傳遞至下一個 API 呼叫時，API 會傳回下一組結果。如果沒有任何進一步的結果，接續權杖就不會包含值。此參數的值不能經過 URL 編碼。

`StartTimeUtc`

類型：字串
必要：否

表示要產生 Chaos 報告之時間範圍開始時間的 Windows 檔案時間。如需詳細資料，請參閱 DateTime.ToFileTimeUtc 方法 \(機器翻譯\)。

`EndTimeUtc`

類型：字串
必要：否

表示要產生 Chaos 報告之時間範圍結束時間的 Windows 檔案時間。如需詳細資料，請參閱 DateTime.ToFileTimeUtc 方法 \(機器翻譯\)。

`MaxResults`

類型：整數 (int64)
必要：否
預設：0
InclusiveMinimum： 0

分頁式查詢時傳回的最大結果數目。此參數定義傳回結果數目的上限。根據設定中所定義的訊息大小限制上限，如果所傳回的結果無法放入訊息中，則它們可以小於指定的結果上限。如果此參數為零或未指定，則分頁式查詢會在傳回訊息中盡可能包含較多結果。

`timeout`

類型：整數 (int64)
必要：否
預設：60
InclusiveMaximum： 4294967295
InclusiveMinimum： 1

用來執行作業的伺服器逾時 (以秒為單位)。此逾時指定了用戶端願意等候要求作業完成的持續時間。這個參數的預設值是 60 秒。

回應

HTTP 狀態碼	描述	回應結構描述
200 (確定)	混亂事件的下一個區段。	ChaosEventsSegment
所有其他狀態碼	詳細的錯誤回應。	FabricError

範例

取得指定時間範圍的混亂事件

此範例示範如何在單一回應訊息中取得 Chaos 事件，而不需要透過 ContinuationToken 參數分頁。

要求

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

200 回應

主體

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

共用方式為