ListJobs

最后更新时间:2020-01-15 17:16:23

    功能描述

    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

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

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助