功能介绍
该接口为扩展接口,主要用于查询异步接口执行情况,比如查询导出 镜像 任务的执行状态。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/jobs/{job_id}
请求消息
请求参数
无
请求示例
查询异步接口执行情况。
GET /v1/ac234de25c6741d2b1273da49eea1b9e/jobs/ff8080814dbd65d7014dbe0d84db0013
响应消息
- 响应参数
参数
参数类型
描述
status
String
任务状态,目前取值如下:
- SUC CES S:表示该任务执行已经结束,任务执行成功。
- FAIL:表示该任务执行已经结束,任务执行失败。
- RUNNING:表示该任务正在执行。
- INIT:表示该任务还未执行,正在初始化。
job_id
String
任务ID。
job_type
String
任务类型。
- imsCreateImageByInstance: 云服务器 制作镜像
- imsImportImageJob:外部镜像文件创建镜像
- imsImportOvaImageJob:外部Ova镜像文件创建镜像
- imsVolumeCreateImageJob:数据盘制作数据盘镜像
- imsImportDataImageJob:外部镜像文件制作数据盘镜像
- imsCreateWholeImageByInstanceJob: 云服务 器制作整机镜像
- imsCreateWholeImageByBackupJob: 云备份 或 云服务器备份 制作整机镜像
- imsNativeImportImageJob:注册镜像
- imsNativeExportImageJob:导出镜像
- imsAddImageMembersJob:添加镜像成员
- imsDelImageMembersJob:删除镜像成员
- imsUpdateImageMembersJob:修改镜像成员
- imsCopyImageInRegionJob:Region内复制镜像
- imsCopyImageCrossUserJob:跨Region复制镜像
begin_time
String
任务开始执行时间。格式为UTC时间。
end_time
String
任务结束时间。格式为UTC时间。
error_code
String
错误码。
fail_reason
String
失败原因。
entities
Object
任务自定义属性。
任务正常时,返回镜像的ID;任务异常时,返回错误码和信息。
表2 entities字段数据结构说明 参数
参数类型
描述
image_id
String
镜像ID。
current_task
String
当前任务名称。
image_name
String
镜像名称。
process_percent
Double
任务执行进度。
results
Array of result objects
sub_jobs_result
Array of SubJobResult objects
sub_jobs_list
Array of string
子任务id列表。
表4 SubJobResult字段数据结构说明 参数
数据结构说明
描述
status
String
子任务状态,取值如下:
- SUCCESS:表示该任务执行已经结束,任务执行成功。
- FAIL:表示该任务执行已经结束,任务执行失败。
- RUNNING:表示该任务正在执行。
- INIT:表示该任务还未执行,正在初始化。
job_id
String
子任务ID。
job_type
String
子任务类型。
begin_time
String
子任务开始执行时间。格式为UTC时间。
end_time
String
子任务结束时间。格式为UTC时间。
error_code
String
错误码。
fail_reason
String
失败原因。
entities
Object SubJobEntities
- 任务正常时,返回镜像的ID。
- 任务异常时,返回错误码和信息。
- 响应样例
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 }