ListJobs

最近更新时间:2019-10-28 11:08:13

功能描述

ListJobs 用于列出您的批量处理任务。有关批量处理任务的详细介绍,可参见 批量处理概述

请求

请求示例

GET /jobs?jobStatuses=<JobStatuses>&maxResults=<MaxResults>&nextToken=<NextToken> HTTP/1.1
x-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

其他错误请参考 批量处理功能错误响应