功能介紹
該接口為擴(kuò)展接口,主要用于查詢異步接口執(zhí)行情況,比如查詢導(dǎo)出 鏡像 任務(wù)的執(zhí)行狀態(tài)。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v1/{project_id}/jobs/{job_id}
請求消息
請求參數(shù)
無
請求示例
查詢異步接口執(zhí)行情況。
GET /v1/ac234de25c6741d2b1273da49eea1b9e/jobs/ff8080814dbd65d7014dbe0d84db0013
響應(yīng)消息
- 響應(yīng)參數(shù)
參數(shù)
參數(shù)類型
描述
status
String
任務(wù)狀態(tài),目前取值如下:
- SUC CES S:表示該任務(wù)執(zhí)行已經(jīng)結(jié)束,任務(wù)執(zhí)行成功。
- FAIL:表示該任務(wù)執(zhí)行已經(jīng)結(jié)束,任務(wù)執(zhí)行失敗。
- RUNNING:表示該任務(wù)正在執(zhí)行。
- INIT:表示該任務(wù)還未執(zhí)行,正在初始化。
job_id
String
任務(wù)ID。
job_type
String
任務(wù)類型。
- imsCreateImageByInstance: 云服務(wù)器 制作鏡像
- imsImportImageJob:外部鏡像文件創(chuàng)建鏡像
- imsImportOvaImageJob:外部Ova鏡像文件創(chuàng)建鏡像
- imsVolumeCreateImageJob:數(shù)據(jù)盤制作數(shù)據(jù)盤鏡像
- imsImportDataImageJob:外部鏡像文件制作數(shù)據(jù)盤鏡像
- imsCreateWholeImageByInstanceJob:云服務(wù)器制作整機(jī)鏡像
- imsCreateWholeImageByBackupJob: 云備份 或 云服務(wù)器備份 制作整機(jī)鏡像
- imsNativeImportImageJob:注冊鏡像
- imsNativeExportImageJob:導(dǎo)出鏡像
- imsAddImageMembersJob:添加鏡像成員
- imsDelImageMembersJob:刪除鏡像成員
- imsUpdateImageMembersJob:修改鏡像成員
- imsCopyImageInRegionJob:Region內(nèi)復(fù)制鏡像
- imsCopyImageCrossUserJob:跨Region復(fù)制鏡像
begin_time
String
任務(wù)開始執(zhí)行時間。格式為UTC時間。
end_time
String
任務(wù)結(jié)束時間。格式為UTC時間。
error_code
String
錯誤碼。
fail_reason
String
失敗原因。
entities
Object
任務(wù)自定義屬性。
任務(wù)正常時,返回鏡像的ID;任務(wù)異常時,返回錯誤碼和信息。
表2 entities字段數(shù)據(jù)結(jié)構(gòu)說明 參數(shù)
參數(shù)類型
描述
image_id
String
鏡像ID。
current_task
String
當(dāng)前任務(wù)名稱。
image_name
String
鏡像名稱。
process_percent
Double
任務(wù)執(zhí)行進(jìn)度。
results
Array of result objects
sub_jobs_result
Array of SubJobResult objects
sub_jobs_list
Array of string
子任務(wù)id列表。
表3 result字段數(shù)據(jù)結(jié)構(gòu)說明 參數(shù)
數(shù)據(jù)結(jié)構(gòu)說明
描述
image_id
String
鏡像ID。
project_id
String
項目ID。
status
String
任務(wù)狀態(tài)。
表4 SubJobResult字段數(shù)據(jù)結(jié)構(gòu)說明 參數(shù)
數(shù)據(jù)結(jié)構(gòu)說明
描述
status
String
子任務(wù)狀態(tài),取值如下:
- SUCCESS:表示該任務(wù)執(zhí)行已經(jīng)結(jié)束,任務(wù)執(zhí)行成功。
- FAIL:表示該任務(wù)執(zhí)行已經(jīng)結(jié)束,任務(wù)執(zhí)行失敗。
- RUNNING:表示該任務(wù)正在執(zhí)行。
- INIT:表示該任務(wù)還未執(zhí)行,正在初始化。
job_id
String
子任務(wù)ID。
job_type
String
子任務(wù)類型。
begin_time
String
子任務(wù)開始執(zhí)行時間。格式為UTC時間。
end_time
String
子任務(wù)結(jié)束時間。格式為UTC時間。
error_code
String
錯誤碼。
fail_reason
String
失敗原因。
entities
Object SubJobEntities
- 任務(wù)正常時,返回鏡像的ID。
- 任務(wù)異常時,返回錯誤碼和信息。
- 響應(yīng)樣例
STATUS CODE 200
{ "status": "SUCCESS", "entities": { "image_id": "e9e91bff-14b6-4a0b-8377-4ed0813e3360", "image_name": "asdfasdfasdfas", "process_percent": 0.20, "current_task": "CreateImageByInstanceTask", "results": [{ "image_id": "49e9447f-7dff-41e0-8036-f66fe5488c8b", "project_id": "089b2f9a3d80d3062f24c00ca4ed5cbd", "status": "success" } ] }, "job_id": "ff8080814dbd65d7014dbe0d84db0013", "job_type": "createImageByInstance", "begin_time": "04-Jun-2015 18:11:06:586", "end_time": "", "error_code": null, "fail_reason": null }