PutBucketRequesterQoSInfo を呼び出して、リソースプール内のバケットにアクセスするリクエスタの速度制限ルールを設定できます。
注意事項
リソースプール QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbit/s に達した場合、または 500 Gbit/s を超えた場合は、テクニカルサポート に連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントには、バケットにアクセスするリクエスタの速度制限ルールを設定する権限があります。RAM ユーザーとして、または Security Token Service (STS) を使用して設定するには、
oss:PutBucketRequesterQoSInfo権限が必要です。詳細については、「RAM ポリシーの例」をご参照ください。
構文
PUT /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<QoSConfiguration>
<TotalUploadBandwidth>10</TotalUploadBandwidth>
<IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>10</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>リクエストヘッダー
PutBucketRequesterQoSInfo リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通のリクエストヘッダー」をご参照ください。
リクエスト パラメーター
次の表で、デフォルト値 -1 は、バケットの帯域幅が制限されていないことを示します。値 0 は、帯域幅タイプがサポートされていないことを示します。たとえば、ExtranetUploadBandwidth の値 0 は、パブリックネットワーク経由で指定されたバケットにデータをアップロードできないことを示します。
リクエスタに設定された合計帯域幅のしきい値は、リソースプールに指定された合計帯域幅を超えることはできません。たとえば、すべてのバケットの合計ダウンロード帯域幅が 100 Gbit/s の場合、リクエスタのインターネット経由のダウンロード帯域幅は 100 Gbit/s を超えることはできません。
リクエスタに指定された各項目の帯域幅のしきい値は、5 Gbit/s 以上にする必要があります。
パラメーター | タイプ | 必須 | 例 | 説明 |
qosRequester | String | はい | 300xxxx | リクエスタのユーザー ID (UID)。 親ノード: なし |
QoSConfiguration | コンテナー | はい | 該当なし | 結果を格納するコンテナー。 親ノード: なし |
TotalUploadBandwidth | Integer | はい | 10 | バケットに対するリクエスタの合計アップロード帯域幅。単位: Gbit/s。 親ノード: QoSConfiguration |
IntranetUploadBandwidth | Integer | はい | -1 | バケットに対するリクエスタの内部ネットワーク経由のアップロード帯域幅。内部ネットワークには、クラシックネットワークと 仮想プライベートクラウド (VPC) が含まれます。単位: Gbit/s。 親ノード: QoSConfiguration |
ExtranetUploadBandwidth | Integer | はい | -1 | バケットに対するリクエスタのパブリックネットワーク経由のアップロード帯域幅。パブリックネットワークには、インターネットと アクセラレーションエンドポイント が含まれます。単位: Gbit/s。 親ノード: QoSConfiguration |
TotalDownloadBandwidth | Integer | はい | 10 | バケットに対するリクエスタの合計ダウンロード帯域幅。単位: Gbit/s。 親ノード: QoSConfiguration |
IntranetDownloadBandwidth | Integer | はい | -1 | バケットに対するリクエスタの内部ネットワーク経由のダウンロード帯域幅。内部ネットワークには、クラシックネットワークと VPC が含まれます。単位: Gbit/s。 親ノード: QoSConfiguration |
ExtranetDownloadBandwidth | Integer | はい | -1 | バケットに対するリクエスタのパブリックネットワーク経由のダウンロード帯域幅。パブリックネットワークには、インターネットと アクセラレーションエンドポイント が含まれます。単位: Gbit/s。 親ノード: QoSConfiguration |
レスポンスヘッダー
PutBucketRequesterQoSInfo リクエストに対するレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通のレスポンスヘッダー」をご参照ください。
例
リクエストの例
PUT /?requesterQosInfo&qosRequester=300xxxx Host: oss-example.oss-cn-hangzhou.aliyuncs.com Content-Length: 209 Date: Fri, 27 Dec 2024 03:21:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <?xml version="1.0" encoding="UTF-8"?> <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration>レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 534**** Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Length: 0 Connection: keep-alive Server: AliyunOSS
OSS SDK
次のプログラミング言語の OSS SDK を使用して、PutBucketRequesterQoSInfo を呼び出すことができます。
ossutil
PutBucketRequesterQoSInfo 操作に対応する ossutil コマンドについては、「put-bucket-requester-qos-info」をご参照ください。