功能描述
请求
请求示例
POST /jobs/<JobId>/status?requestedJobStatus=<RequestedJobStatus>&statusUpdateReason=<StatusUpdateReason> HTTP/1.1x-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 | 是 |
请求头
请求体
该请求无请求体。
响应
响应示例
HTTP/1.1 200<UpdateJobStatusResult><JobId>string</JobId><Status>string</Status><StatusUpdateReason>string</StatusUpdateReason></UpdateJobStatusResult>
响应头
响应体
<UpdateJobStatusResult><JobId>string</JobId><Status>string</Status><StatusUpdateReason>string</StatusUpdateReason></UpdateJobStatusResult>
具体内容描述如下。
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 |