PutResourcePoolPriorityQosConfiguration 操作を呼び出して、リソースプール内のバケットとバケットグループの優先度およびサービス品質 (QoS) 構成を変更します。
注意事項
優先度レベルの数は 3 から 10 の範囲である必要があります。
優先度レベルは 1 から始まります。数値が大きいほど、優先度が高くなります。
デフォルトの最低帯域幅 (DefaultGuaranteedQosConfiguration) を構成しない場合は、各優先度レベルに最低帯域幅を構成する必要があります。デフォルトが構成されている場合、特定の帯域幅が設定されていない優先度レベルでは、このデフォルト値が使用されます。
すべての優先度レベルにわたる最低帯域幅項目 (TotalUploadBandwidth など) の合計は、リソースプール内の対応する項目の値を超えることはできません。
優先度レベルの最低帯域幅を -1 に設定できるのは、リソースプール内の対応する項目の値が -1 の場合のみです。
バケットとそのバケットグループで優先度構成が異なる場合、バケットグループの優先度が優先されます。
リクエスト構文
PUT /?priorityQos&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content lengthリクエスト要素
名前 | タイプ | パラメーターの位置 | 説明 |
resourcePool | string | Query | 対象となるリソースプールの名前。 |
PriorityQosConfiguration | container | Body | リソースプールの優先度調整設定のコンテナー。 |
PriorityCount | Integer | - | 優先度レベルの数。 |
DefaultPriorityLevel | Integer | - | デフォルトの優先度レベル。 |
DefaultGuaranteedQosConfiguration | container | - | デフォルトの最低帯域幅。このノードが構成されていない場合は、各優先度レベルに最低帯域幅を構成する必要があります。このノードが構成されている場合、特定の帯域幅が設定されていない優先度レベルでは、このデフォルト値が使用されます。 |
QosPriorityLevelConfiguration | container | - | 特定の優先度レベルのスロットリング構成のコンテナー。 |
PriorityLevel | Integer | - | 優先度レベル。 |
GuaranteedQosConfiguration | container | - | 特定の優先度レベルの最低帯域幅を格納するコンテナーです。 |
TotalUploadBandwidth | Integer | - | 合計の最低アップロード帯域幅。単位：Gbps。 |
IntranetUploadBandwidth | Integer | - | 内部ネットワークの最低アップロード帯域幅。単位：Gbps。これには、クラシックネットワークや VPC などの内部ネットワークからのリクエストが含まれます。 |
ExtranetUploadBandwidth | Integer | - | パブリックネットワークの最低アップロード帯域幅。単位：Gbps。これには、インターネットや CDN などのパブリックネットワークからのリクエストが含まれます。 |
TotalDownloadBandwidth | Integer | - | 合計の最低ダウンロード帯域幅。単位：Gbps。 |
IntranetDownloadBandwidth | Integer | - | 内部ネットワークの最低ダウンロード帯域幅。単位：Gbps。これには、クラシックネットワークや VPC などの内部ネットワークからのリクエストが含まれます。 |
ExtranetDownloadBandwidth | Integer | - | パブリックネットワークの最低ダウンロード帯域幅。単位：Gbps。これには、インターネットや CDN などのパブリックネットワークからのリクエストが含まれます。 |
Subjects | container | - | 調整オブジェクトのコンテナー。調整オブジェクトには、バケットとバケットグループが含まれます。 |
Bucket | string | - | バケット名。 |
BucketGroup | string | - | バケットグループ名。 |
例
リクエスト例
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 コマンドラインツール
対応する ossutil コマンドの詳細については、「put-resource-pool-priority-qos-configuration」をご参照ください。