put-resource-pool-requester-qos-info - Object Storage Service - Alibaba Cloud ドキュメントセンター

リソースプール内の RAM ユーザーに対して、リクエスタの帯域幅制限を設定します。

注意事項

重要

リソースプールのサービス品質 (QoS) は招待プレビュー中です。特定のリージョンにおける Object Storage Service (OSS) バケットのスループットが 500 Gbit/s 以上の場合、テクニカルサポートに連絡してこの機能を申請してください。

デフォルトでは、Alibaba Cloud アカウントはリソースプール内の RAM ユーザーに対してリクエスタの帯域幅制限を設定する権限を持っています。別の RAM ユーザーまたはセキュリティトークンサービス (STS) を使用して RAM ユーザーのリクエスタの帯域幅制限を設定するには、oss:PutResourcePoolRequesterQoSInfo 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
各項目の設定は、バケットの帯域幅制限設定を超えることはできません。
値 -1 は、フィールドに制限が課されていないことを指定します。フィールドが指定されていない場合、デフォルト値は -1 です。値 0 は、特定のタイプのアクセスリクエストが禁止されていることを指定します。
サブ項目の設定は、項目の合計設定を超えることはできません。たとえば、合計アップロード帯域幅を 10 Gbit/s に設定した場合、内部ネットワーク経由のアップロード帯域幅は 10 Gbit/s を超えることはできません。
リクエスタの帯域幅制限は 5 Gbit/s 未満にすることはできません。たとえば、アップロード帯域幅は 5 Gbit/s 以上である必要があります。
単一のバケットは、最大 300 の RAM ユーザーに対する帯域幅制限をサポートします。

構文

ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=<resource-pool> --parameters qosRequester=<uid> --parameters requesterQosInfo --body=file://<path-to-xml>

パラメーター	タイプ	説明
--parameters	stringArray	k[=v] フォーマットのリクエストパラメーター (例: versionId=123、delete)。
--body	string	リクエストボディ。file:// はファイルから設定を読み込むことを指定し、- は標準入力から設定を読み込むことを指定します。

--body

--body パラメーターは XML フォーマットをサポートしています。パラメーターの値が file:// で始まる場合、設定は特定のファイルから読み込まれます。

<QoSConfiguration>
  <TotalUploadBandwidth>integer</TotalUploadBandwidth>
  <IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
</QoSConfiguration>

パラメーター	タイプ	必須	例	単位	説明
TotalUploadBandwidth	Integer	はい	10	Gbps	合計アップロード帯域幅。親ノード: QoSConfiguration
IntranetUploadBandwidth	Integer	はい	-1	Gbps	内部ネットワーク経由のアップロード帯域幅。内部ネットワークには、クラシックネットワークと VPC が含まれます。単位: Gbit/s。親ノード: QoSConfiguration
ExtranetUploadBandwidth	Integer	はい	-1	Gbps	外部ネットワーク経由のアップロード帯域幅。外部ネットワークには、インターネットと CDN が含まれます。親ノード: QoSConfiguration
TotalDownloadBandwidth	Integer	はい	10	Gbps	合計ダウンロード帯域幅。親ノード: QoSConfiguration
IntranetDownloadBandwidth	Integer	はい	-1	Gbps	内部ネットワーク経由のダウンロード帯域幅。内部ネットワークには、クラシックネットワークと VPC が含まれます。単位: Gbit/s。親ノード: QoSConfiguration
ExtranetDownloadBandwidth	Integer	はい	-1	Gbps	外部ネットワーク経由のダウンロード帯域幅。外部ネットワークには、インターネットと CDN が含まれます。親ノード: QoSConfiguration

説明

サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。

例

qos.xml という名前の XML 設定ファイルを作成し、その設定ファイルに次のサンプルコードを追加することで、examplePool という名前のリソースプール内の ID が 202835923910178019 のリクエスタに QoS 設定を追加します。

<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

次の項目では、パラメーターについて説明します。

TotalUploadBandwidth パラメーターは 10 に設定されており、合計アップロード帯域幅が 10 Gbit/s であることを指定します。内部ネットワークおよびパブリックネットワーク経由の合計アップロード帯域幅は 10 Gbit/s を超えることはできません。
IntranetUploadBandwidth パラメーターは -1 に設定されており、内部ネットワーク経由のアップロード帯域幅に制限が課されていないことを指定します。ただし、内部ネットワーク経由のアップロード帯域幅は、合計アップロード帯域幅である 10 Gbit/s 以下である必要があります。
ExtranetUploadBandwidth パラメーターは -1 に設定されており、パブリックネットワーク経由のアップロード帯域幅に制限が課されていないことを指定します。ただし、パブリックネットワーク経由のアップロード帯域幅は、合計アップロード帯域幅である 10 Gbit/s 以下である必要があります。
TotalDownloadBandwidth パラメーターは 10 に設定されており、合計ダウンロード帯域幅が 10 Gbit/s であることを指定します。内部ネットワークおよびパブリックネットワーク経由の合計ダウンロード帯域幅は 10 Gbit/s を超えることはできません。
IntranetDownloadBandwidth パラメーターは -1 に設定されており、内部ネットワーク経由のダウンロード帯域幅に制限が課されていないことを指定します。ただし、内部ネットワーク経由のダウンロード帯域幅は、合計ダウンロード帯域幅である 10 Gbit/s 以下である必要があります。
ExtranetDownloadBandwidth パラメーターは -1 に設定されており、パブリックネットワーク経由のダウンロード帯域幅に制限が課されていないことを指定します。ただし、パブリックネットワーク経由のダウンロード帯域幅は、合計ダウンロード帯域幅である 10 Gbit/s 以下である必要があります。

コマンドの例:

ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=examplePool --parameters qosRequester=202835923910178019 --parameters requesterQosInfo --body=file://qos.xml