取得錯誤作業清單

發行項
08/05/2023

取得依提供的輸入所篩選之使用者引起的錯誤作業清單。

依所提供的輸入篩選之後，取得使用者引發的錯誤作業清單。

要求

方法	要求 URI
GET	`/Faults/?api-version=6.0&TypeFilter={TypeFilter}&StateFilter={StateFilter}&timeout={timeout}`

參數

名稱	類型	必要	Location
`api-version`	字串	是	查詢
`TypeFilter`	整數	Yes	查詢
`StateFilter`	整數	Yes	查詢
`timeout`	整數 (int64)	No	查詢

`api-version`

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

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

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

此外，執行時間會接受高於最新支援版本的任何版本，最高為目前版本的執行時間。因此，如果最新的 API 版本是 6.0，但如果執行時間是 6.1，為了更容易撰寫用戶端，執行時間將會接受該 API 6.1 版。不過，API 的行為會根據記載的 6.0 版本。

`TypeFilter`

類型：整數
必要：是
預設：65535

針對使用者引發的作業，用來依據 OperationType 進行篩選。

65535 - 全選
1 - 選取 [PartitionDataLoss]。
2 - 選取 [PartitionQuorumLoss]。
4 - 選取 [PartitionRestart]。
8 - 選取 [NodeTransition]。

`StateFilter`

類型：整數
必要：是
預設：65535

針對使用者引發的作業，用來依據 OperationState 進行篩選。

65535 - 全選
1 - 選取 Running
2 - 選取 [輪流]
8 - 選取 [已完成]
16 - 選取 [錯誤]
32 - 選取 [已取消]
64 - 選取 [ForceCancelled]

`timeout`

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

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

回應

HTTP 狀態碼	描述	回應結構描述
200 (確定)	成功的作業會傳回 200 狀態碼。	OperationStatus的陣列
所有其他狀態碼	詳細的錯誤回應。	FabricError

範例

取得錯誤作業的相關資訊

這會顯示 GetFaultOperationList 可能輸出的範例

要求

GET http://localhost:19080/Faults/?api-version=6.0&TypeFilter=0xFF&StateFilter=0xFF

200 回應

主體

[
  {
    "OperationId": "00000000-0000-0000-0000-000000000010",
    "State": "Completed",
    "Type": "PartitionDataLoss"
  },
  {
    "OperationId": "00000000-0000-0000-0000-000000000020",
    "State": "Completed",
    "Type": "PartitionQuorumLoss"
  },
  {
    "OperationId": "00000000-0000-0000-0000-000000000030",
    "State": "Completed",
    "Type": "PartitionRestart"
  },
  {
    "OperationId": "00000000-0000-0000-0000-000000000500",
    "State": "Faulted",
    "Type": "NodeTransition"
  },
  {
    "OperationId": "00000000-0000-0000-0000-000000000700",
    "State": "Completed",
    "Type": "NodeTransition"
  },
  {
    "OperationId": "00000000-0000-0000-0000-000000000710",
    "State": "Completed",
    "Type": "NodeTransition"
  },
  {
    "OperationId": "88ef90f9-0b94-46b0-b817-a6ea20c07f8a",
    "State": "Completed",
    "Type": "PartitionRestart"
  }
]

共用方式為