功能描述
请求
请求示例
POST /jobs/<JobId>/status?requestedJobStatus=<RequestedJobStatus>&statusUpdateReason=<StatusUpdateReason> HTTP/1.1Host: <UIN>.cos-control.<Region>.myqcloud.comx-cos-appid: <appid>
请求参数
调用 UpdateJobStatus 需要使用清单任务名称的参数。该参数格式如下：
参数 | 描述 | 类型 | 是否必选 |
JobId | 您想要更新的批量处理任务的 ID。 | String | 是 |
requestedJobStatus | 您期望的批量处理任务的状态。当您将任务转移至 Ready状态时，COS 将认为您已确认此项任务，并将执行此项任务。当您将任务转移至Cancelled状态时，COS 将取消此项任务。可选参数包括：Ready、Cancelled。 | String | 是 |
statusUpdateReason | 更新任务状态的原因。此项参数长度限制为0 - 256字节。 | String | 否 |
x-cos-appid | 用户的 APPID，长度为1 - 64字节。 | String | 是 |
请求头
请求体
该请求无请求体。
响应
响应头
响应体
<UpdateJobStatusResult><JobId>string</JobId><Status>string</Status><StatusUpdateReason>string</StatusUpdateReason></UpdateJobStatusResult>
具体的节点描述如下：
节点名称（关键字） | 父节点 | 描述 | 类型 |
UpdateJobStatusResult | 无 | 保存 UpdateJobStatus 结果的所有信息 | Container |
Container 节点 UpdateJobStatusResult 的内容：
节点名 | 父节点 | 描述 | 类型 |
JobId | UpdateJobStatusResult | 任务 ID。您所更新的任务的 ID，长度限制为5 - 36字节。 | String |
Status | UpdateJobStatusResult | 任务的当前状态。合法参数项包括：Active、Cancelled、Cancelling、 Complete、Completing、Failed、Failing、New、Paused、Pausing、Preparing、Ready、 Suspended。 | String |
StatusUpdateReason | UpdateJobStatusResult | 任务更新原因。长度限制为0 - 256字节。 | String |
错误码
错误码 | 描述 | 状态码 | API |
InvalidArgument | requestedJobStatus 参数必须为 Cancelled 或 Ready | 400 | UpdateJobStatus |
InvalidRequest | 指定任务已完成 | 400 | UpdateJobStatus |
InvalidRequest | 任务状态变更错误 | 400 | UpdateJobStatus |
NoSuchJob | 指定任务不存在或已完成 | 404 | UpdateJobStatus，UpdateJobPriority |
实际案例
请求
POST /jobs/53dc6228-c50b-46f7-8ad7-65e7159f1aae/status?requestedJobStatus=Cancelled&statusUpdateReason=Reason HTTP/1.1Host: 100000000001.cos-control.ap-chengdu.myqcloud.comDate: Thu, 19 Dec 2024 18:00:29 GMTx-cos-appid: 1250000000Content-Type: application/xmlContent-Length: 1056Content-MD5: hHcgq5mu8s0Ywe4WTGiQ+uA==Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1576778429;1576785629&q-key-time=1576778429;1576785629&q-header-list=content-length;content-md5;content-type;date;host;x-cos-appid&q-url-param-list=&q-signature=****************************************Connection: close
响应
HTTP/1.1 200 OK<UpdateJobStatusResult><JobId>53dc6228-c50b-46f7-8ad7-65e7159f1aae</JobId><Status>Cancelled</Status><StatusUpdateReason>Reason</StatusUpdateReason></UpdateJobStatusResult>
