リソースプール内のバケットの帯域幅調整ルールを設定します。
使用上の注意
リソースプール QoS は招待プレビュー中です。 リージョン内の OSS バケットのスループットが 500 Gbps に達した場合、または 500 Gbps を超えた場合は、テクニカルサポート に連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントには、リソースプール内のバケットの帯域幅調整ルールを設定する権限があります。 RAM ユーザーまたは Security Token Service ( 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 | コンテナー | はい | 該当なし | 帯域幅調整ルールを格納するコンテナー。 親ノード: なし |
TotalUploadBandwidth | 整数 | はい | 10 | バケットの合計アップロード帯域幅。 単位: Gbit/s。 親ノード: QoSConfiguration |
IntranetUploadBandwidth | 整数 | はい | -1 | バケットの内部ネットワーク経由のアップロード帯域幅。 内部ネットワークには、クラシックネットワークと VPC が含まれます。 単位: Gbit/s。 親ノード: QoSConfiguration |
ExtranetUploadBandwidth | 整数 | はい | -1 | バケットのパブリックネットワーク経由のアップロード帯域幅。 パブリックネットワークには、インターネットとアクセラレーションエンドポイントが含まれます。 単位: Gbit/s。 親ノード: QoSConfiguration |
TotalDownloadBandwidth | 整数 | はい | 10 | バケットの合計ダウンロード帯域幅。 単位: Gbit/s。 親ノード: QoSConfiguration |
IntranetDownloadBandwidth | 整数 | はい | -1 | バケットの内部ネットワーク経由のダウンロード帯域幅。 内部ネットワークには、クラシックネットワークと VPC が含まれます。 単位: Gbit/s。 親ノード: QoSConfiguration |
ExtranetDownloadBandwidth | 整数 | はい | -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: OSS qn6q****:77Dv**** <?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
ossutil
PutBucketQoSInfo 操作に対応する ossutil コマンドについては、「put-bucket-qos-info」をご参照ください。