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

リソースプール内のRAMユーザーのリクエスタ帯域幅調整を設定します。

使用上の注意

重要

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

デフォルトでは、Alibaba Cloudアカウントには、リソースプール内のRAMユーザーのリクエスタ帯域幅調整を設定する権限があります。別のRAMユーザーまたはSecurity Token Service (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>

パラメーター	タイプ	説明
-- パラメータ	stringArray	versionId=123やdeleteなど、k[=v] 形式のリクエストパラメーター。
-- ボディ	String	リクエスト本文。 file:// 設定がファイルから読み取られることを指定しますが、-は設定が標準の入力から読み取られることを指定します。

-- ボディ

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

<QoSConfiguration>
  <TotalUploadBandwidth>integer</TotalUploadBandwidth>
  <IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
  <TotalQps>integer</TotalQps>
  <IntranetQps>integer</IntranetQps>
  <ExtranetQps>integer</ExtranetQps>
</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>
  <TotalQps>-1</TotalQps>
  <IntranetQps>-1</IntranetQps>
  <ExtranetQps>-1</ExtranetQps>
</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以下でなければなりません。
TotalQps、IntranetQps、およびExtranetQpsパラメーターのデフォルト値-1を保持します。これは、1秒あたりのクエリ (QPS) に制限がないことを指定します。

サンプルコマンド:

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