全部產品
Search
文件中心

Object Storage Service:UpdateJobPriority

更新時間:Nov 01, 2025

調用UpdateJobPriority介面更新指定大量操作任務的優先順序。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket Policy授予操作許可權。

API

Action

說明

UpdateJobPriority

oss:UpdateJobPriority

更新大量操作任務優先順序。

請求文法

POST /?batchJobPriority&batchJobId=xx&targetPriority=10 HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

請求參數

名稱

類型

是否必選

樣本值

描述

batchJobId

字串

MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

待更新優先順序的大量操作任務ID。您可以通過調用CreateJob介面擷取該ID。長度為44個字元,不包含短劃線(-)和底線(_),可以包含小寫字母(a-z)、大寫字母(A-Z)、數字(0-9)。

targetPriority

整數

10

大量操作任務的目標優先順序。用於動態調整任務的執行順序。取值範圍為0~2147483647,數值越大,優先順序越高。

要求標頭

此介面除支援公用要求標頭外,無特有要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

響應元素

名稱

類型

樣本值

描述

UpdateJobPriorityResult

容器

儲存更新任務優先順序結果的容器。
父節點:無
子節點:JobId、Priority

JobId

字串

MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

已更新優先順序的任務ID。
父節點:UpdateJobPriorityResult
子節點:無

Priority

整數

20

任務更新後的優先順序。
父節點:UpdateJobPriorityResult
子節點:無

回應標頭

此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

樣本

  • 請求樣本

    POST /?batchJobPriority&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=&targetPriority=20 HTTP/1.1
    Host: oss-cn-hangzhou.aliyuncs.com
    Authorization: SignatureValue
  • 返回樣本

    HTTP/1.1 200 OK
    <?xml version="1.0" encoding="UTF-8"?>
    <UpdateJobPriorityResult>
       <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
       <Priority>20</Priority>
    </UpdateJobPriorityResult>