全部產品
Search

搜尋本產品

    Object Storage Service：PutResourcePoolRequesterPriorityQosConfiguration

    文件中心

    Object Storage Service：PutResourcePoolRequesterPriorityQosConfiguration

    更新時間：Dec 03, 2025

    調用PutResourcePoolRequesterPriorityQosConfiguration介面修改資源集區要求者的優先順序流控配置。

    注意事項

    • 優先順序數量的合法範圍為3到10。

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

    • 當預設保底頻寬配置不存在時，每個優先順序都必須配置保底頻寬。如果存在預設保底頻寬配置，未單獨配置保底頻寬的優先順序將使用預設配置。

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

    • 當資源集區中某個配置項的值為-1時，優先順序保底頻寬中對應配置項可設定為-1；否則不能設定為-1。

    請求文法

    PUT /?requesterPriorityQos&resourcePool=ResoucePoolName
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

    整數

    -

    內網上傳保底頻寬配置，包括傳統網路內網上傳和VPC網路內網上傳等來自內網的請求，單位為Gbps。

    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    ExtranetUploadBandwidth

    整數

    -

    外網上傳保底頻寬配置，包括公網上傳和CDN上傳等來自外網的請求，單位為Gbps。

    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    TotalDownloadBandwidth

    整數

    -

    總下載保底頻寬配置，單位為Gbps。

    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    IntranetDownloadBandwidth

    整數

    -

    內網下載保底頻寬配置，包括傳統網路內網下載和VPC網路內網下載等來自內網的請求，單位為Gbps。

    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    ExtranetDownloadBandwidth

    整數

    -

    外網下載保底頻寬配置，包括公網下載和CDN下載等來自外網的請求，單位為Gbps。

    父節點：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration

    Subjects

    容器

    -

    儲存按特定優先順序生效的流控對象的容器。對於要求者優先順序流控，子項目只能為Requester。

    父節點：QosPriorityLevelConfiguration

    Requester

    字串

    -

    按當前優先順序生效的要求者UID。

    父節點：Subjects

    樣本

    • 請求樣本

      PUT /?requesterPriorityQos&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>5</PriorityCount>
  <DefaultPriorityLevel>1</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>
    <Subjects>
      <Requester>2387497xx390843</Requester>
      <Requester>348397xxx348793</Requester>
    </Subjects>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>5</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <Requester>2387497xx390843</Requester>
      <Requester>348397xxx348793</Requester>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

    • 響應樣本

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

    SDK

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

    命令列工具ossutil

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