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」をご参照ください。