UpdateJobPriority

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

    功能描述

    UpdateJobPriority 用于更新任务优先级。您可以使用这一接口以更新一项任务的优先级,数值越大,优先级越高,高优先级的 Job 会被优先执行。有关批量处理任务的详细介绍,可参见 批量处理概述

    请求

    请求示例

    POST /jobs/<JobId>/priority?priority=<Priority> HTTP/1.1
    x-cos-appid: <appid>

    请求参数

    调用 UpdateJobPriority 接口所需的参数。该参数格式如下:

    参数 描述 是否必选
    JobId 您想要更新的批量处理任务的 ID。长度限制为1 - 64字节。
    priority 更新后的任务优先级。此项参数大小限制为0 - 2147483647。
    x-cos-appid 用户的 APPID,长度为1 - 64字节。

    请求头

    此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

    请求体

    该请求无请求体。

    响应

    响应示例

    HTTP/1.1 200
    <UpdateJobPriorityResult>
        <JobId>string</JobId>
        <Priority>integer</Priority>
    </UpdateJobPriorityResult>

    响应头
    此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

    响应体

    <UpdateJobPriorityResult>
        <JobId>string</JobId>
        <Priority>integer</Priority>
    </UpdateJobPriorityResult>

    具体内容描述如下:

    UpdateJobStatusResult

    节点名 父节点 描述 类型
    JobId UpdateJobPriorityResult 任务 ID。您所更新的任务的 ID,长度限制为1 - 64字节。 String
    Priority UpdateJobPriorityResult 任务的当前优先级。大小限制为0 - 2147483647。 Integer

    错误分析

    该请求可能会发生的一些常见的特殊错误如下:

    错误代码 描述 状态码 API
    InvalidRequest 未提供任务优先级 400 UpdateJobPriority
    NoSuchJob 指定任务不存在或已完成 404 UpdateJobStatus,UpdateJobPriority

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

    Was this page helpful?

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

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