History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
GET /jobs?jobStatuses=<JobStatuses>&maxResults=<MaxResults>&nextToken=<NextToken> HTTP/1.1x-cos-appid: <appid>
参数 | 描述 | 是否必选 |
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>
节点名 | 父节点 | 描述 | 类型 |
Jobs | ListJobsResult | 包含 COS 返回的多个批量处理任务信息。 | Jobs Object |
NextToken | ListJobsResult | 每次ListJobs操作会返回本次任务列表的最后一个 JobId 作为 nextToken,在下一次 ListJobs 传入该值,返回结果即可接续上一次 ListJobs 的内容,用于分页。该参数的长度限制在1 - 64字节。 | String |
节点名 | 父节点 | 描述 | 类型 |
member | Jobs | 包含 COS 返回的某个批量处理任务信息。 | member Object |
节点名 | 父节点 | 描述 | 类型 |
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 |
文档反馈