すべてのプロダクト
Search

このプロダクト

    Object Storage Service:put-bucket-requester-qos-info

    ドキュメントセンター

    Object Storage Service:put-bucket-requester-qos-info

    最終更新日:Feb 12, 2025

    バケットの帯域幅調整設定を変更します。

    使用上の注意

    重要

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

    • デフォルトでは、Alibaba Cloudアカウントには、バケットの帯域幅調整を設定する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケットの帯域幅調整を構成するには、oss:PutBucketRequesterQoSInfo権限が必要です。 詳細については、「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-bucket-requester-qos-info --method PUT --bucket=<bucket-name> --parameters requesterQosInfo --parameters qosRequester=<uid> --body file://<path-to-xml>

    パラメーター

    タイプ

    説明

    -- 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>
  <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

    外部ネットワーク上のアップロード帯域幅。 外部ネットワークには、インターネットとAlibaba Cloud Content Delivery Network (CDN) が含まれます。

    親ノード: QoSConfiguration

    TotalDownloadBandwidth

    Integer

    はい

    10

    Gbps

    ダウンロード要求の合計帯域幅。

    親ノード: QoSConfiguration

    IntranetDownloadBandwidth

    Integer

    はい

    -1

    Gbps

    内部ネットワーク上のダウンロード帯域幅。 内部ネットワークには、クラシックネットワークとVPCが含まれます。 単位: Gbit/s。

    親ノード: QoSConfiguration

    ExtranetDownloadBandwidth

    Integer

    はい

    -1

    Gbps

    外部ネットワーク上のダウンロード帯域幅。 外部ネットワークには、インターネットとCDNが含まれます。

    親ノード: QoSConfiguration

    説明

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

    例

    QoS. XMLという名前のxml構成ファイルを作成し、次のサンプルコードを構成ファイルに追加することにより、examplebucketという名前のバケットでIDが202835923910178018されているリクエスタに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-bucket-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=202835923910178018 --body file://qos.xml