全部產品
Search

搜尋本產品

    Object Storage Service：PutResourcePoolPriorityQosConfiguration

    文件中心

    Object Storage Service：PutResourcePoolPriorityQosConfiguration

    更新時間：Dec 03, 2025

    調用PutResourcePoolPriorityQosConfiguration介面，修改資源集區中Bucket和BucketGroup的優先順序流控配置。

    注意事項

    • 優先順序數量的取值範圍為3~10。

    • 優先順序序號從1開始，數字越大，優先順序越高。

    • 如果未配置預設保底頻寬（DefaultGuaranteedQosConfiguration），則必須為每個優先順序配置保底頻寬。如果已配置預設保底頻寬，則未單獨配置保底頻寬的優先順序將使用該預設值。

    • 所有優先順序的各保底頻寬配置項（例如TotalUploadBandwidth）之和，不能超過資源集區中對應配置項的值。

    • 僅當資源集區中對應配置項的值為-1時，優先順序的保底頻寬配置項才可設定為-1。

    • 當Bucket與其所屬的BucketGroup配置了不同的優先順序時，以BucketGroup的優先順序為準。

    請求文法

    PUT /?priorityQos&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length

    請求元素

    名稱

    類型

    參數位置

    描述

    resourcePool

    字串

    Query

    目標資源集區名稱。

    PriorityQosConfiguration

    容器

    Body

    用於指定資源集區優先順序流控配置的容器。
    父節點：無

    PriorityCount

    整數

    -

    優先順序數量。
    取值範圍：3~10。
    父節點：PriorityQosConfiguration

    DefaultPriorityLevel

    整數

    -

    預設優先順序。
    取值範圍：1~PriorityCount。
    父節點：PriorityQosConfiguration

    DefaultGuaranteedQosConfiguration

    容器

    -

    預設保底頻寬。如果未配置此節點，則必須為每個優先順序配置保底頻寬。如果已配置此節點，則未單獨配置保底頻寬的優先順序將使用該預設值。
    父節點：PriorityQosConfiguration

    QosPriorityLevelConfiguration

    容器

    -

    用於指定特定優先順序流控配置的容器。
    父節點：PriorityQosConfiguration

    PriorityLevel

    整數

    -

    優先順序。
    取值範圍：1~PriorityCount。
    父節點：QosPriorityLevelConfiguration

    GuaranteedQosConfiguration

    容器

    -

    用於指定特定優先順序保底頻寬配置的容器。
    父節點：QosPriorityLevelConfiguration

    TotalUploadBandwidth

    整數

    -

    總上傳保底頻寬，單位為Gbps。
    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    IntranetUploadBandwidth

    整數

    -

    內網上傳保底頻寬，單位為Gbps。包括傳統網路和VPC等內網請求。
    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    ExtranetUploadBandwidth

    整數

    -

    外網上傳保底頻寬，單位為Gbps。包括公網和CDN等外網請求。
    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    TotalDownloadBandwidth

    整數

    -

    總下載保底頻寬，單位為Gbps。
    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    IntranetDownloadBandwidth

    整數

    -

    內網下載保底頻寬，單位為Gbps。包括傳統網路和VPC等內網請求。
    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    ExtranetDownloadBandwidth

    整數

    -

    外網下載保底頻寬，單位為Gbps。包括公網和CDN等外網請求。
    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    Subjects

    容器

    -

    用於指定流控對象的容器，流控對象包括Bucket和BucketGroup。
    父節點：QosPriorityLevelConfiguration

    Bucket

    字串

    -

    Bucket名稱。
    父節點：Subjects

    BucketGroup

    字串

    -

    BucketGroup名稱。
    父節點：Subjects

    樣本

    • 請求樣本

      PUT /?priorityQos&resourcePool=ResoucePoolName
Host: oss-cn-shanghai.aliyuncs.com
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Type: application/xml
Content-Length: content length

<PriorityQosConfiguration>
  <PriorityCount>4</PriorityCount>
  <DefaultPriorityLevel>3</DefaultPriorityLevel>
  <DefaultGuaranteedQosConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>40</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>50</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>60</ExtranetDownloadBandwidth>
  </DefaultGuaranteedQosConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>1</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>2</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <BucketGroup>bucketGroup-02</BucketGroup>
      <Bucket>bucket-02</Bucket>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

    • 響應樣本

      HTTP/1.1 200 OK
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Length: 0

    SDK

    PutResourcePoolPriorityQosConfiguration介面所對應的各語言SDK如下：

    命令列工具ossutil

    PutResourcePoolPriorityQosConfiguration介面所對應的ossutil命令，請參見put-resource-pool-priority-qos-configuration。