查询任务的执行状态
功能介绍
查询Job的执行状态。
对于创建云应用服务器命令下发后会返回job_id,通过job_id可以查询任务的执行状态。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/job/{job_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目唯一标识。 |
job_id |
是 |
String |
任务ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
job |
JobDetail object |
Job信息详情。 |
参数 |
参数类型 |
描述 |
---|---|---|
job_id |
String |
任务ID。 |
job_type |
Integer |
job类型,固定值1。 |
job_status |
Integer |
job执行状态
|
sub_jobs |
Array of SubJobInfo objects |
子任务信息。 |
begin_time |
String |
Job处理开始时间。 |
end_time |
String |
job处理结束时间。 |
expected_end_time |
String |
云服务预估的Job处理结束时间,只针对job有效,针对子job无效。 |
execute_code |
String |
Job执行结果码 |
execute_message |
String |
Job执行结果描述,以及每个SubJob的执行结果描述。 |
参数 |
参数类型 |
描述 |
---|---|---|
job_id |
String |
子job标识。 |
job_type |
Integer |
任务类型,固定值2:子Job。 |
job_status |
Integer |
job状态
|
entities |
Array of JobResourceInfo objects |
SubJob中处理的云服务/云资源对象。 创建、规格变更等场景是必填;冻结、解冻、删除等场景可空。 |
begin_time |
String |
任务开始时间。 |
end_time |
String |
任务结束时间。 |
expected_end_time |
String |
云服务预估的Job处理结束时间,只针对job有效,针对子job无效。 |
execute_code |
String |
Job执行结果码。 |
execute_message |
String |
Job执行结果描述,以及每个SubJob的执行结果描述。 |
参数 |
参数类型 |
描述 |
---|---|---|
resource_id |
String |
客户在云服务Console上可见的资源实例Id,全局唯一,且不可更改,最大64个字符。 注:“规格变更”场景下(包括升降配),是对某个资源实例的规格进行调整, 该资源实例其他信息(比如资源Id、资源名称)和运行的业务数据不变化。 |
resource_name |
String |
资源名称;创建、有最新资源名称场景,必填。 |
cloud_service_type |
String |
云服务类型编码;新购、规格变更场景,必填。 |
resource_type |
String |
资源类型编码;新购、规格变更场景,必填。 |
resource_spec_code |
String |
资源规格编码;新购、规格变更场景,必填。 |
spec_type |
Map<String,Object> |
规格类型,运营上需要呈现和使用的一些规格属性,多个使用K:V格式。 比如带宽的共享/独享(shareable:true/false),数据盘的系统盘/数据盘类型(root:true/false)。 当前针对共享带宽、共享盘使用,必填。 |
spec_size |
Double |
某些规格属性大小:比如带宽大小、数据盘大小。 |
measure |
Integer |
specSize的单位编码,比如GB、M,有specSize时,此字段必填。 |
processed_time |
String |
处理时间。 |
is_main_resource |
Integer |
该resourceId是否是主资源(仅开通场景使用,其他场景为空)。
|
main_resources |
Array of RelativeResource objects |
resourceId的主资源。 是挂载到/绑定到/依附到/包含于/关联到资源,比如IP的主资源‘云主机’、数据盘的主资源‘云主机’。 如果resourceId是依附在多个资源上,则有多个主资源,比如共享盘挂载到多个云主机上。 无关联主资源,则空,比如独立未挂载的数据盘。 |
extend_params |
String |
expireTime:到期时间,域名注册服务使用。 UTC时间,格式:yyyy-MM-ddTHH:mm:ssZ(2016-06-28T00:00:00Z)。 |
old_resource_id |
String |
仅针对ECS/BMS云服务的“切换操作系统”场景使用。 云主机切换操作系统的资源id会变化场景。 填写变更前老的资源Id。资源Id未变化,无此字段。 |
old_cloud_service_type |
String |
仅针对ECS/BMS云服务的“切换操作系统”场景使用:云主机切换操作系统的云服务类型编码会变化场景。 填写变更前老的云服务类型编码。云服务类型未变化,无此字段。 |
old_resource_type |
String |
仅针对ECS/BMS云服务“切换操作系统”场景使用。 云主机切换操作系统的资源类型编码会变化场景。 填写变更前老的资源类型编码。资源类型未变化,无此字段。 |
参数 |
参数类型 |
描述 |
---|---|---|
relative_resource_id |
String |
关联的资源ID。 |
relative_resource_name |
String |
有资源名称的云资源,都需要返回resourceName,如果为空值,则返回“”。 |
relative_type |
Integer |
|
relative_cloud_service_type |
String |
比如ECS云服务类型为‘hws.service.type.ec2’。 |
relative_resource_type |
String |
比如VM的资源类型为‘hws.resource.type.vm’。 |
extend_params |
String |
扩展信息,Key:Value格式。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
请求示例
GET /v1/29dfe82ada564ac2b927e1ff036d9a9b/job/575768277444198400
响应示例
状态码: 200
成功响应。
{ "job" : { "job_id" : "575768277444198400", "job_type" : 1, "job_status" : 0, "sub_jobs" : [ { "job_id" : "575768277481947136", "job_type" : 2, "job_status" : 0, "entities" : [ ], "begin_time" : "2023-06-06T02:30:06Z", "end_time" : "2023-06-06T02:45:49Z" } ], "begin_time" : "2023-06-06T02:30:06Z", "end_time" : "2023-06-06T02:45:49Z", "expected_end_time" : "2023-06-06T15:55:57Z", "execute_code" : "", "execute_message" : "" } }
状态码
状态码 |
描述 |
---|---|
200 |
成功响应。 |
400 |
由于包含语法错误,当前请求无法被服务器理解。 |
401 |
鉴权失败。 |
403 |
没有操作权限。 |
500 |
服务内部错误,具体返回错误码请参见错误码说明。 |
错误码
请参见错误码。