功能介紹
查詢所有保護組失敗任務(wù)列表或者指定保護組下的所有失敗任務(wù)列表。
接口約束
無
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v1/{project_id}/task-center/failure-jobs
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
項目ID。 |
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
failure_status |
否 |
String |
失敗任務(wù)狀態(tài)。createFail:表示創(chuàng)建失敗。deleteFail:表示刪除失敗。attachFail:表示掛載失敗。detachFail:表示卸載失敗。expandFail:表示擴容失敗。resizeFail:表示變更規(guī)格失敗。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_group_id |
否 |
String |
保護組ID。 |
請求參數(shù)
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值) |
響應(yīng)參數(shù)
狀態(tài)碼: 200
參數(shù) |
參數(shù)類型 |
描述 |
---|---|---|
failure_jobs |
失敗任務(wù)信息列表。 |
|
count |
Integer |
列表中失敗任務(wù)個數(shù)。 |
參數(shù) |
參數(shù)類型 |
描述 |
---|---|---|
job_type |
String |
任務(wù)名稱。 |
job_status |
String |
任務(wù)狀態(tài)。當前僅支持“FAIL”。FAIL:表示任務(wù)失敗。 枚舉值:
|
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 : 表示重保護失敗。 枚舉值:
|
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)演練。 枚舉值:
|
狀態(tài)碼: 400
狀態(tài)碼: 401
狀態(tài)碼: 403
狀態(tài)碼: 404
狀態(tài)碼: 405
狀態(tài)碼: 406
狀態(tài)碼: 407
狀態(tài)碼: 408
狀態(tài)碼: 409
狀態(tài)碼: 500
狀態(tài)碼: 501
狀態(tài)碼: 502
狀態(tài)碼: 503
狀態(tài)碼: 504
請求示例
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 |
錯誤碼
請參見錯誤碼。