リソースプールリクエスターQoS情報の設定 - Object Storage Service

PutResourcePoolRequesterQoSInfo 操作を使用して、リソースプールリクエスターの速度制限パラメーターを設定します。

注意事項

リソースプール QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbps に達した場合、または 500 Gbps を超えた場合は、テクニカルサポートに連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントには、リソースプールリクエスターの速度制限を構成する権限があります。 RAM ユーザーまたは Security Token Service (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>
  <TotalQps>-1</TotalQps>
  <IntranetQps>-1</IntranetQps>
  <ExtranetQps>-1</ExtranetQps>
</QoSConfiguration>

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用し、特定のヘッダーは必要ありません。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

説明

以下の帯域幅設定項目では、デフォルト値 -1 は帯域幅に制限がないことを示します。値 0 は、帯域幅タイプがサポートされていないことを意味します。たとえば、ExtranetUploadBandwidth の値が 0 の場合、パブリックネットワーク経由で指定されたバケットにデータをアップロードできないことを示します。
リクエスターの合計帯域幅構成は、リソースプールの合計帯域幅構成を超えてはなりません。同様に、個々のリクエスターの帯域幅構成は、合計帯域幅制限を超えてはなりません。たとえば、合計ダウンロード帯域幅が 100 Gbit/s に設定されている場合、エクストラネットダウンロード帯域幅はこの制限を超えてはなりません。
リクエスターの個々の帯域幅構成は、5 Gbit/s 以上である必要があります。

名前	タイプ	必須	値の例	説明
resourcePool	String	はい	resource-pool-for-ai	リソースプールの名前。
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

レスポンスヘッダー

この操作では、共通のレスポンスヘッダーのみを使用し、特定のヘッダーは必要ありません。詳細については、「共通レスポンスヘッダー」をご参照ください。

例

リクエスト例

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: OSS qn6q****:77Dv****

<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
  <TotalQps>-1</TotalQps>
  <IntranetQps>-1</IntranetQps>
  <ExtranetQps>-1</ExtranetQps>
</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

PutResourcePoolRequesterQoSInfo 操作に関連する ossutil コマンドについては、「put-resource-pool-requester-qos-info」をご参照ください。