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

バケットのサービス品質 (QoS) 情報を設定します。

使用上の注意

重要

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

デフォルトでは、Alibaba Cloudアカウントには、バケットのQoS情報を設定する権限があります。 Resource Access Management (RAM) ユーザーまたはSecurity Token Service (STS) を使用してバケットのQoS情報を構成するには、oss:PutBucketQoSInfo権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
帯域幅調整は、リソースプールに追加されたバケットに対してのみ設定できます。バケットの各構成項目の帯域幅しきい値は、バケットが属するリソースプールの帯域幅しきい値を超えることはできません。
-1の値は、フィールドに制限が課されないことを指定します。フィールドが指定されていない場合、デフォルト値は-1です。値0は、特定のタイプのアクセス要求が禁止されることを指定する。
サブアイテムの帯域幅は、アイテムの合計帯域幅を超えることはできません。たとえば、合計アップロード帯域幅を10 Gbit/sに設定した場合、内部ネットワーク上のアップロード帯域幅は10 Gbit/sを超えることはできません。

構文

ossutil api invoke-operation --op-name put-bucket-qos-info --method PUT --bucket <bucket-name> --parameters qosInfo --body=file://<path-to-xml-file>

パラメーター	タイプ	説明
-- bucket	String	バケットの名前です。
-- パラメータ	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>
</QoSConfiguration>

次の表に、設定ファイルで必要なパラメーターを示します。

パラメーター	型	必須 / 任意	例	単位	説明
TotalUploadBandwidth	Integer	はい	10	Gbit/s	合計アップロード帯域幅。親ノード: QoSConfiguration。
IntranetUploadBandwidth	Integer	はい	-1	Gbit/s	内部ネットワーク上のアップロード帯域幅。内部ネットワークには、クラシックネットワークと仮想プライベートクラウド (VPC) が含まれます。単位: Gbit/s。親ノード: QoSConfiguration。
ExtranetUploadBandwidth	Integer	はい	-1	Gbit/s	外部ネットワーク上のアップロード帯域幅。外部ネットワークには、インターネットとAlibaba Cloud Content Delivery Network (CDN) が含まれます。親ノード: QoSConfiguration。
TotalDownloadBandwidth	Integer	はい	10	Gbit/s	総ダウンロード帯域幅。親ノード: QoSConfiguration。
IntranetDownloadBandwidth	Integer	はい	-1	Gbit/s	内部ネットワーク上のダウンロード帯域幅。内部ネットワークには、クラシックネットワークとVPCが含まれます。単位: Gbit/s。親ノード: QoSConfiguration。
ExtranetDownloadBandwidth	Integer	はい	-1	Gbit/s	外部ネットワーク上のダウンロード帯域幅。外部ネットワークには、インターネットとCDNが含まれます。親ノード: QoSConfiguration。

説明

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

例：

QoS. XMLという名前のxml構成ファイルを作成し、次のサンプルコードを構成ファイルに追加して、examplebucketという名前のバケットに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-bucket-qos-info --method PUT --bucket examplebucket --parameters qosInfo --body=file://qos.xml