すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:PutResourcePoolRequesterPriorityQosConfiguration

最終更新日:Dec 04, 2025

PutResourcePoolRequesterPriorityQosConfiguration 操作は、リソースプールのリクエスタの優先度に基づく速度制限構成を変更します。

注意事項

  • 優先度レベルの数は、3 から 10 までの整数である必要があります。

  • 優先度レベルは 1 から始まります。数値が大きいほど、優先度が高くなります。

  • デフォルトの最低帯域幅設定を指定しない場合は、各優先度レベルに最低帯域幅を設定する必要があります。デフォルト設定を指定した場合、特定の最低帯域幅が設定されていない優先度レベルでは、このデフォルト設定が使用されます。

  • 最低帯域幅構成の各設定項目 (TotalUploadBandwidth や IntranetDownloadBandwidth など) について、すべての優先度レベルの値の合計は、リソースプールの対応する設定項目の値を超えることはできません。

  • 優先度に基づく最低帯域幅の項目の値を -1 に設定できるのは、リソースプールの対応する設定項目の値も -1 の場合のみです。

リクエスト構文

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

リクエスト要素

名前

タイプ

場所

説明

resourcePool

String

Query

ターゲットリソースプールの名前。

PriorityQosConfiguration

コンテナー

Body

リソースプールの優先度に基づく速度制限構成のコンテナーです。

親ノード:なし

PriorityCount

Integer

-

優先度レベルの数。値は 3 から 10 までの整数である必要があります。

親ノード:PriorityQosConfiguration

DefaultPriorityLevel

Integer

-

デフォルトの優先度レベル。値は 1 から PriorityCount の値までの整数である必要があります。

親ノード:PriorityQosConfiguration

DefaultGuaranteedQosConfiguration

コンテナー

-

デフォルトの最低帯域幅構成。このノードが指定されていない場合は、各優先度レベルに最低帯域幅を設定する必要があります。指定されている場合、特定の最低帯域幅が設定されていない優先度レベルでは、このデフォルト構成が使用されます。

親ノード:PriorityQosConfiguration

QosPriorityLevelConfiguration

コンテナー

-

特定の優先度レベルのスロットリング構成のコンテナーです。

親ノード:PriorityQosConfiguration

PriorityLevel

Integer

-

優先度レベル。値は 1 から PriorityCount の値までの整数である必要があります。

親ノード:QosPriorityLevelConfiguration

GuaranteedQosConfiguration

コンテナー

-

特定の優先度レベルの最低帯域幅構成のコンテナーです。

親ノード:QosPriorityLevelConfiguration

TotalUploadBandwidth

Integer

-

最低合計アップロード帯域幅。単位:Gbit/s。

親ノード:DefaultGuaranteedQosConfiguration または GuaranteedQosConfiguration

IntranetUploadBandwidth

Integer

-

最低内部ネットワークアップロード帯域幅。クラシックネットワークや VPC などの内部ネットワークからのリクエストが含まれます。単位:Gbit/s。

親ノード:DefaultGuaranteedQosConfiguration または GuaranteedQosConfiguration

ExtranetUploadBandwidth

Integer

-

最低外部ネットワークアップロード帯域幅。パブリックネットワークや CDN などの外部ネットワークからのリクエストが含まれます。単位:Gbit/s。

親ノード:DefaultGuaranteedQosConfiguration または GuaranteedQosConfiguration

TotalDownloadBandwidth

Integer

-

最低合計ダウンロード帯域幅。単位:Gbit/s。

親ノード:DefaultGuaranteedQosConfiguration または GuaranteedQosConfiguration

IntranetDownloadBandwidth

Integer

-

最低内部ネットワークダウンロード帯域幅。クラシックネットワークや VPC などの内部ネットワークからのリクエストが含まれます。単位:Gbit/s。

親ノード:DefaultGuaranteedQosConfiguration または GuaranteedQosConfiguration

ExtranetDownloadBandwidth

Integer

-

最低外部ネットワークダウンロード帯域幅。パブリックネットワークや CDN などの外部ネットワークからのリクエストが含まれます。単位:Gbit/s。

親ノード:DefaultGuaranteedQosConfiguration または GuaranteedQosConfiguration

Subjects

コンテナー

-

特定の優先度レベルの対象となる速度制限オブジェクトのコンテナーです。リクエスタの優先度に基づく速度制限の場合、子要素は Requester のみです。

親ノード:QosPriorityLevelConfiguration

Requester

String

-

現在の優先度レベルの対象となるリクエスタの UID。

親ノード:Subjects

  • リクエスト例

    PUT /?requesterPriorityQos&resourcePool=ResourcePoolName
    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」をご参照ください。