すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:PutResourcePoolBucketGroupQoSInfo

最終更新日:Nov 09, 2025

PutResourcePoolBucketGroupQoSInfo を呼び出して、リソースプール内のバケットグループのスロットリング設定を構成または変更できます。

使用上の注意

  • リソースプールの QoS は招待プレビュー中です。あるリージョンにおけるお客様の OSS バケットのスループットが 500 Gbit/s 以上に達した場合、テクニカルサポートに連絡してこの機能を申請できます。

  • デフォルトでは、Alibaba Cloud アカウントは完全な権限を持っています。RAM ユーザーまたは RAM ロールとしてこの機能を設定する場合、Alibaba Cloud アカウントまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して oss:PutResourcePoolBucketGroupQoSInfo 権限を付与する必要があります。

リクエスト構文

PUT /?resourcePoolBucketGroupQosInfo&resourcePool=<ResourcePoolName>&resourcePoolBucketGroup=<ResourcePoolBucketGroupName>
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length

リクエストヘッダー

PutResourcePoolBucketGroupQoSInfo リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

説明
  • 次の表では、デフォルト値 -1 はバケットの帯域幅が制限されていないことを示します。値 0 は、その帯域幅タイプがサポートされていないことを示します。たとえば、ExtranetUploadBandwidth の値が 0 の場合、パブリックネットワーク経由で指定されたバケットにデータをアップロードできないことを示します。

  • バケットグループに指定された合計帯域幅は、リソースプールに指定された合計帯域幅を超えることはできません。バケットグループの項目に指定された帯域幅は、リソースプールのその項目に指定された合計帯域幅を超えることはできません。たとえば、リソースプールの合計ダウンロード帯域幅が 10 Gbit/s の場合、バケットグループのインターネット経由のダウンロード帯域幅は 10 Gbit/s を超えることはできません。

  • バケットグループの項目に指定された帯域幅は 5 Gbit/s 未満にすることはできません。

名前

タイプ

必須

説明

resourcePool

string

はい

resource-pool-for-ai

リソースプールの名前。

resourcePoolBucketGroup

string

はい

test-group

バケットグループの名前。

QoSConfiguration

container

はい

N/A

スロットリング設定情報を格納するコンテナー。

親ノード: なし

TotalUploadBandwidth

Integer

はい

10

バケットグループの合計アップロード帯域幅。単位: Gbit/s。

親ノード: QoSConfiguration

IntranetUploadBandwidth

Integer

はい

-1

バケットグループの内部アップロード帯域幅 (クラシックネットワークと VPC の内部アップロード帯域幅を含む)。単位: Gbit/s。

親ノード: QoSConfiguration

ExtranetUploadBandwidth

Integer

はい

-1

バケットグループの外部アップロード帯域幅 (パブリックネットワークとアクセラレーションエンドポイントのアップロード帯域幅を含む)。単位: Gbit/s。

親ノード: QoSConfiguration

TotalDownloadBandwidth

Integer

はい

10

バケットグループの合計ダウンロード帯域幅。単位: Gbit/s。

親ノード: QoSConfiguration

IntranetDownloadBandwidth

Integer

はい

-1

バケットグループの内部ダウンロード帯域幅 (クラシックネットワークと VPC の内部ダウンロード帯域幅を含む)。単位: Gbit/s。

親ノード: QoSConfiguration

ExtranetDownloadBandwidth

Integer

はい

-1

バケットグループの外部ダウンロード帯域幅 (パブリックネットワークとアクセラレーションエンドポイントのダウンロード帯域幅を含む)。単位: Gbit/s。

親ノード: QoSConfiguration

応答ヘッダー

PutResourcePoolBucketGroupQoSInfo リクエストへの応答のすべてのヘッダーは、共通の応答ヘッダーです。詳細については、「共通応答ヘッダー」をご参照ください。

  • リクエストの例

    PUT /?resourcePoolBucketGroupQosInfo&resourcePool=resource-pool-for-ai&resourcePoolBucketGroup=test-group
    Host: oss-cn-shanghai.aliyuncs.com
    Date: Sun, 11 Aug 2024 17:45:00 GMT
    Content-Type: application/xml
    Content-Length: content length
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  • 応答の例

    HTTP/1.1 200 OK
    Date: Sun, 11 Aug 2024 17:45:00 GMT
    Content-Length: 0

SDK

次の SDK は、PutResourcePoolBucketGroupQoSInfo 操作のオペレーションを提供します。