- 动态与公告
- 产品简介
- 购买指南
- 快速入门
- 控制台指南
- 工具指南
- 实践教程
- 开发者指南
- 数据湖存储
- 数据处理
- 故障处理
- 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
- 附录
- 词汇表
功能描述
请求
请求示例
GET /jobs?jobStatuses=<JobStatuses>&maxResults=<MaxResults>&nextToken=<NextToken> HTTP/1.1x-cos-appid: <appid>
请求参数
调用 ListJobs 所需要使用的参数。该参数格式如下：
参数 | 描述 | 是否必选 |
jobStatuses | 您所需查询的任务状态信息。如您未指定任务状态，则 COS 将返回所有执行过的任务状态，包括正在执行的任务。若您指定任务状态，则 COS 将返回指定状态的任务。可选的任务状态包括：Active、Cancelled、Cancelling、Complete、Completing、Failed、Failing、New、Paused、Pausing、Preparing、Ready、Suspended。 | 否 |
maxResults | COS 返回的任务数量最大值。如您配置了此项参数，每次返回的任务数最多不会超过这个最大值。您可以配合 nextToken 参数进行分页返回。该参数范围为1 - 1000，默认为1000。 | 否 |
nextToken | 翻页符。每次 list 操作会返回本次任务列表的最后一个 JobId 作为 nextToken，在下一次 list 传入该值，即可接续上一次 list 的内容进行 list，用于分页。该参数的长度限制在1 - 64字节。 | 否 |
x-cos-appid | 用户的 APPID，长度为1 - 64字节。 | 是 |
请求头
请求体
该请求无请求体。
响应
响应示例
HTTP/1.1 200<ListJobsResult>...</ListJobsResult>
响应头
响应体
<ListJobsResult><Jobs><member><CreationTime>timestamp</CreationTime><Description>string</Description><JobId>string</JobId><Operation>string</Operation><Priority>integer</Priority><ProgressSummary><NumberOfTasksFailed>integer</NumberOfTasksFailed><NumberOfTasksSucceeded>integer</NumberOfTasksSucceeded><TotalNumberOfTasks>integer</TotalNumberOfTasks></ProgressSummary><Status>string</Status><TerminationDate>timestamp</TerminationDate></member></Jobs><NextToken></NextToken></ListJobsResult>
具体内容描述如下：
ListJobsResult
包含COS返回的批量处理任务列表信息。
节点名 | 父节点 | 描述 | 类型 |
Jobs | ListJobsResult | 包含 COS 返回的多个批量处理任务信息。 | Jobs Object |
NextToken | ListJobsResult | 每次ListJobs操作会返回本次任务列表的最后一个 JobId 作为 nextToken，在下一次 ListJobs 传入该值，返回结果即可接续上一次 ListJobs 的内容，用于分页。该参数的长度限制在1 - 64字节。 | String |
Jobs
节点名 | 父节点 | 描述 | 类型 |
member | Jobs | 包含 COS 返回的某个批量处理任务信息。 | member Object |
member
节点名 | 父节点 | 描述 | 类型 |
CreationTime | member | 任务创建时间。 | Timestamp |
Description | member | 任务描述。长度限制为0 - 256字节。 | String |
JobId | member | 任务 ID。长度限制为1 - 64字节。 | String |
Operation | member | 批量处理任务中对对象执行的操作。例如 COSPutObjectCopy | String |
Priority | member | 任务优先级。值越大的任务将会被优先执行。优先级大小限制为0 - 2147483647。 | Integer |
ProgressSummary | member | 任务执行状况概述。描述您此项任务中所执行的操作总数，成功的操作数量以及失败的操作数量。 | ProgressSummary Object |
Status | member | 任务执行状态。合法参数值包括 Active、Cancelled、Cancelling、Complete、Completing、Failed、Failing、New、Paused、Pausing、Preparing、Ready、Suspended。 | String |
TerminationDate | member | 批量处理任务的结束时间。 | Timestamp |
错误分析
该请求可能会发生的一些常见的特殊错误如下：
错误代码 | 描述 | 状态码 | API |
InvalidArgument | Parameter jobStatuses is invalid | 400 | ListJobs |
InvalidArgument | maxResults 参数必须为整数 | 400 | ListJobs |
InvalidArgument | nextToken 参数无效 | 400 | ListJobs |
是
否
本页内容是否解决了您的问题？