- 动态与公告
- 产品简介
- 购买指南
- 快速入门
- 控制台指南
- 工具指南
- 实践教程
- 开发者指南
- 数据湖存储
- 数据处理
- 故障处理
- API 文档
- 简介
- 公共请求头部
- 公共响应头部
- 错误码
- 请求签名
- 操作列表
- Service 接口
- Bucket 接口
- Object 接口
- 批量处理接口
- 数据处理接口
- 任务与工作流
- 内容审核接口
- 云查毒接口
- SDK 文档
- SDK 概览
- 准备工作
- Android SDK
- C SDK
- C++ SDK
- .NET(C#) SDK
- Flutter SDK
- Go SDK
- iOS SDK
- Java SDK
- JavaScript SDK
- Node.js SDK
- PHP SDK
- Python SDK
- React Native SDK
- 小程序 SDK
- 错误码
- 常见问题
- Related Agreements
- 附录
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 快速入门
- 控制台指南
- 工具指南
- 实践教程
- 开发者指南
- 数据湖存储
- 数据处理
- 故障处理
- API 文档
- 简介
- 公共请求头部
- 公共响应头部
- 错误码
- 请求签名
- 操作列表
- Service 接口
- Bucket 接口
- Object 接口
- 批量处理接口
- 数据处理接口
- 任务与工作流
- 内容审核接口
- 云查毒接口
- SDK 文档
- SDK 概览
- 准备工作
- Android SDK
- C SDK
- C++ SDK
- .NET(C#) SDK
- Flutter SDK
- Go SDK
- iOS SDK
- Java SDK
- JavaScript SDK
- Node.js SDK
- PHP SDK
- Python SDK
- React Native SDK
- 小程序 SDK
- 错误码
- 常见问题
- Related Agreements
- 附录
- 词汇表
功能描述
请求
请求示例
POST /jobs/<JobId>/status?requestedJobStatus=<RequestedJobStatus>&statusUpdateReason=<StatusUpdateReason> HTTP/1.1x-cos-appid: <appid>
请求参数
调用 UpdateJobStatus 需要使用清单任务名称的参数。该参数格式如下：
参数 | 描述 | 是否必选 |
JobId | 您想要更新的批量处理任务的 ID。 | 是 |
requestedJobStatus | 您期望的批量处理任务的状态。当您将任务转移至 Ready状态时，COS 将认为您已确认此项任务，并将执行此项任务。当您将任务转移至Cancelled状态时，COS 将取消此项任务。可选参数包括：Ready、Cancelled。 | 是 |
statusUpdateReason | 更新任务状态的原因。此项参数长度限制为0 - 256字节。 | 否 |
x-cos-appid | 用户的 APPID，长度为1 - 64字节。 | 是 |
请求头
请求体
该请求无请求体。
响应
响应示例
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 |
是
否
本页内容是否解决了您的问题？