華為云計算 云知識 查詢失敗任務(wù)列表ListFailureJobs
查詢失敗任務(wù)列表ListFailureJobs

 

功能介紹

查詢所有保護組失敗任務(wù)列表或者指定保護組下的所有失敗任務(wù)列表。

接口約束

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /v1/{project_id}/task-center/failure-jobs

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID。

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

failure_status

String

失敗任務(wù)狀態(tài)。createFail:表示創(chuàng)建失敗。deleteFail:表示刪除失敗。attachFail:表示掛載失敗。detachFail:表示卸載失敗。expandFail:表示擴容失敗。resizeFail:表示變更規(guī)格失敗。startFail:表示開啟保護失敗。stopFail:表示停止保護失敗。reverseFail:表示切換失敗。failoverFail:表示故障切換失敗。reprotectFail : 表示重保護失敗。

枚舉值:

  • createFail

  • deleteFail

  • attachFail

  • detachFail

  • expandFail

  • resizeFail

  • startFail

  • stopFail

  • reverseFail

  • failoverFail

  • reprotectFail

limit

Integer

每次請求返回結(jié)果個數(shù)限制。取值范圍為[0,1000]的正整數(shù),默認值為1000。

最小值:0

最大值:1000

缺省值:1000

offset

Integer

每次請求開始的下標,即偏移量,默認值為0。offset必須為數(shù)字,不能為負數(shù)。

最小值:0

缺省值:0

resource_name

String

保護組資源名稱。

resource_type

String

資源類型。server_groups:表示保護組。protected_instances:表示保護實例。replications:表示復制對。disaster_recovery_drills:表示容災(zāi)演練。

枚舉值:

  • server_groups

  • protected_instances

  • replications

  • disaster_recovery_drills

server_group_id

String

保護組ID。

請求參數(shù)

表3 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)

響應(yīng)參數(shù)

狀態(tài)碼: 200

表4 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

failure_jobs

Array of FailureJobParams objects

失敗任務(wù)信息列表。

count

Integer

列表中失敗任務(wù)個數(shù)。

表5 FailureJobParams

參數(shù)

參數(shù)類型

描述

job_type

String

任務(wù)名稱。

job_status

String

任務(wù)狀態(tài)。當前僅支持“FAIL”。FAIL:表示任務(wù)失敗。

枚舉值:

  • FAIL

begin_time

String

任務(wù)操作時間。默認格式為:"yyyy-MM-ddTHH:mm:ss.SSSZ",例:"2019-04-01T12:00:00.000Z"。

job_id

String

任務(wù)id。執(zhí)行異步API命令下發(fā)成功的返回參數(shù)。

failure_status

String

失敗任務(wù)狀態(tài)。createFail:表示創(chuàng)建失敗。deleteFail:表示刪除失敗。attachFail:表示掛載失敗。detachFail:表示卸載失敗。expandFail:表示擴容失敗。resizeFail:表示變更規(guī)格失敗。startFail:表示開啟保護失敗。stopFail:表示停止保護失敗。reverseFail:表示切換失敗。failoverFail:表示故障切換失敗。reprotectFail : 表示重保護失敗。

枚舉值:

  • createFail

  • deleteFail

  • attachFail

  • detachFail

  • expandFail

  • resizeFail

  • startFail

  • stopFail

  • reverseFail

  • failoverFail

  • reprotectFail

resource_id

String

資源ID。

resource_name

String

資源名稱。

error_code

String

任務(wù)失敗錯誤碼。

fail_reason

String

任務(wù)失敗原因。

resource_type

String

資源類型。 server_groups:表示保護組。 protected_instances:表示保護實例。 replications:表示復制對。 disaster_recovery_drills:表示容災(zāi)演練。

枚舉值:

  • server_groups

  • protected_instances

  • replications

  • disaster_recovery_drills

狀態(tài)碼: 400

表6 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表7 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 401

表8 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表9 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 403

表10 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表11 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 404

表12 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表13 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 405

表14 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表15 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 406

表16 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表17 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 407

表18 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表19 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 408

表20 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表21 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 409

表22 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表23 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 500

表24 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表25 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 501

表26 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表27 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 502

表28 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表29 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 503

表30 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表31 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

狀態(tài)碼: 504

表32 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表33 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯誤信息

code

String

錯誤碼

請求示例

GET https://{Endpoint}/v1/{project_id}/task-center/failure-jobs?server_group_id=XXXXX

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "count" : 2,
  "failure_jobs" : [ {
    "job_status" : "FAIL",
    "resource_id" : "17984002-ad8a-438b-8ba6-b850224634c5",
    "resource_name" : "Protected-Instance-ab14",
    "resource_type" : "protectedInstance",
    "failure_status" : "createFail",
    "job_id" : "ff808082686f229a0168707beaab014e",
    "job_type" : "createProtectedInstance",
    "begin_time" : "2019-01-21T12:56:35.754Z",
    "error_code" : "EVS.2024",
    "fail_reason" : "SdrsGenerateNativeServerParamsTask-fail:volume is error!"
  }, {
    "job_status" : "FAIL",
    "resource_id" : "897f57b2-6e94-4179-b414-9532726c59f2",
    "resource_name" : "Protected-Instance-5e2e",
    "resource_type" : "protectedInstance",
    "failure_status" : "createFail",
    "job_id" : "ff808082686f229a0168707b9be9013e",
    "job_type" : "createProtectedInstance",
    "begin_time" : "2019-01-21T12:56:15.591Z",
    "error_code" : "EVS.2024",
    "fail_reason" : "SdrsGenerateNativeServerParamsTask-fail:volume is error!"
  } ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Method Not Allowed

406

Not Acceptable

407

Proxy Authentication Required

408

Request Timeout

409

Conflict

500

Internal Server Error

501

Not Implemented

502

Bad Gateway

503

Service Unavailable

504

Gateway Timeout

錯誤碼

請參見錯誤碼