すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Nov 12, 2025

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

    使用上の注意

    重要

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

    • デフォルトでは、Alibaba Cloud アカウントはバケットの帯域幅調整を設定する権限を持っています。RAM ユーザーまたはセキュリティトークンサービス (STS) を使用してバケットの帯域幅調整を設定するには、oss:PutBucketRequesterQoSInfo 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

    • 各項目の設定は、バケットの帯域幅調整設定を超えることはできません。

    • 値 -1 は、フィールドに制限が課されないことを指定します。フィールドが指定されていない場合、デフォルト値は -1 です。値 0 は、特定のタイプのアクセスリクエストが禁止されることを指定します。

    • サブ項目の設定は、項目の合計設定を超えることはできません。たとえば、合計アップロード帯域幅を 10 Gbit/s に設定した場合、内部ネットワーク経由のアップロード帯域幅は 10 Gbit/s を超えることはできません。

    • リクエスタの帯域幅調整は 5 Gbit/s 未満にすることはできません。たとえば、アップロード帯域幅は 5 Gbit/s 以上である必要があります。

    • 1 つのバケットは、最大 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

    バケットの名前。

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

    外部ネットワーク経由のアップロード帯域幅。外部ネットワークには、インターネットと 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

    説明

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

    例

    ID が 202835923910178018 のリクエスタに QoS 設定を、examplebucket という名前のバケットに追加するには、qos.xml という名前の XML 設定ファイルを作成し、次のサンプルコードを設定ファイルに追加します。

    <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-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=202835923910178018 --body file://qos.xml