tencent cloud

文档反馈

UpdateJobPriority

最后更新时间:2023-12-21 17:43:45

    功能描述

    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
    其他错误请参见 批量处理功能错误响应