PutResourcePoolRequesterQoSInfo を呼び出して、リソースプール内のリクエスタの帯域幅調整を設定できます。
使用上の注意
リソースプールの QoS は招待プレビュー中です。 あるリージョンにおけるお客様の OSS バケットのスループットが 500 Gbit/s 以上に達した場合、テクニカルサポートに連絡してこの機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントはリソースプール内のリクエスタの帯域幅調整を設定する権限を持っています。 RAM ユーザーとして、またはセキュリティトークンサービス (STS) を使用して帯域幅調整を設定する場合は、
oss:PutResourcePoolRequesterQoSInfo権限が必要です。 詳細については、「RAM ポリシーの一般的な例」をご参照ください。
リクエスト構文
PUT /?requesterQosInfo&resourcePool=ResourcePoolName&qosRequester=uid
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length
<QoSConfiguration>
<TotalUploadBandwidth>10</TotalUploadBandwidth>
<IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>10</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>リクエストヘッダー
PutResourcePoolRequesterQoSInfo リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
次の表では、デフォルト値 -1 はバケットの帯域幅が制限されていないことを示します。 値 0 は、その帯域幅タイプがサポートされていないことを示します。 たとえば、ExtranetUploadBandwidth の値が 0 の場合、パブリックネットワーク経由で指定されたバケットにデータをアップロードできないことを示します。
リクエスタの帯域幅設定の合計は、リソースプールの合計帯域幅設定を超えることはできません。 リクエスタの個別の帯域幅設定は、合計帯域幅設定を超えることはできません。 たとえば、合計ダウンロード帯域幅が 100 Gbit/s に設定されている場合、パブリックネットワークのダウンロード帯域幅は 100 Gbit/s を超えることはできません。
リクエスタの個別の帯域幅設定は 5 Gbit/s 未満にすることはできません。
名前 | タイプ | 必須 | 例 | 説明 |
resourcePool | 文字列 | はい | resource-pool-for-ai | リソースプールの名前。 |
qosRequester | 文字列 | はい | 300xxxx | リクエスタのユーザー ID (UID)。 |
QoSConfiguration | コンテナー | はい | N/A | 帯域幅調整ルールを格納するコンテナー。 親ノード: なし |
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 |
レスポンスヘッダー
PutResourcePoolRequesterQoSInfo リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
リクエスト例
PUT /?requesterQosInfo&resourcePool=resource-pool-for-ai&qosRequester=300xxxx Host: oss-cn-hangzhou.aliyuncs.com Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Type: application/xml Content-Length: 454 Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <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
SDK
次の SDK は PutResourcePoolRequesterQoSInfo 操作を提供します:
コマンドラインツール ossutil
PutResourcePoolRequesterQoSInfo 操作に対応する ossutil コマンドの詳細については、「put-resource-pool-requester-qos-info」をご参照ください。