リソースプール内のバケットの帯域幅調整ルールを設定します。
使用上の注意
リソースプールの QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbit/s 以上に達した場合、テクニカルサポート にお問い合わせいただき、この機能の利用を申請できます。
デフォルトでは、Alibaba Cloud アカウントは、リソースプール内のバケットの帯域幅調整ルールを設定する権限を持っています。RAM ユーザーまたはセキュリティトークンサービス (STS) を使用してバケットの帯域幅調整ルールを設定するには、
oss:PutBucketQoSInfo権限が必要です。詳細については、「RAM ポリシーの一般的な例」をご参照ください。
構文
PUT /?qosInfo HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?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>リクエストヘッダー
PutBucketQoSInfo リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
次の表では、デフォルト値 -1 はバケットの帯域幅が制限されていないことを示します。値 0 は、帯域幅タイプがサポートされていないことを示します。たとえば、ExtranetUploadBandwidth の値が 0 の場合、パブリックネットワーク経由で指定されたバケットにデータをアップロードできないことを示します。
バケットに指定された合計帯域幅は、リソースプールに指定された合計帯域幅を超えることはできません。バケットに指定された合計帯域幅は、すべてのバケットに指定された合計帯域幅を超えることはできません。たとえば、すべてのバケットの合計ダウンロード帯域幅が 100 Gbit/s の場合、バケットのインターネット経由のダウンロード帯域幅は 100 Gbit/s を超えることはできません。
要素 | タイプ | 必須 | 例 | 説明 |
QoSConfiguration | コンテナー | はい | N/A | 帯域幅調整ルールを格納するコンテナー。 親ノード: なし |
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 |
レスポンスヘッダー
PutBucketQoSInfo リクエストへのレスポンス内のすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通レスポンスヘッダー」をご参照ください。
例
リクエスト例
PUT /?qosInfo HTTP/1.1 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 を使用して PutBucketQoSInfo を呼び出すことができます:
ossutil
PutBucketQoSInfo 操作に対応する ossutil コマンドの詳細については、「put-bucket-qos-info」をご参照ください。