すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListBucketRequesterQoSInfos

    ドキュメントセンター

    Object Storage Service:ListBucketRequesterQoSInfos

    最終更新日:Jun 10, 2025

    バケットに対するすべてのリクエスタの速度制限構成をクエリします。

    使用上の注意

    • リソースプール QoS は招待プレビュー中です。 リージョン内の OSS バケットのスループットが 500 Gbit/秒に達した場合、またはそれを超えた場合は、テクニカルサポート に連絡して、この機能を申請できます。

    • デフォルトでは、Alibaba Cloud アカウントには、バケットに対するすべてのリクエスタの速度制限構成をクエリする権限があります。 RAM ユーザーまたは Security Token Service (STS) を使用してバケットに対するすべてのリクエスタの速度制限構成をクエリするには、oss:ListBucketRequesterQoSInfo 権限が必要です。 詳細については、「RAM ポリシーの一般的な例」をご参照ください。

    構文

    GET /?requesterQosInfo&max-keys=10&continuation-token=207xxxx
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    リクエストヘッダー

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

    リクエスト要素

    要素

    タイプ

    必須

    例

    説明

    max-keys

    String

    いいえ

    10

    速度制限構成をクエリするリクエスト元の最大数。

    継続トークン

    文字列

    いいえ

    207xxxx

    速度制限構成が返される リクエスター です。

    レスポンスヘッダー

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

    レスポンス要素

    要素

    タイプ

    例

    説明

    ListBucketRequesterQoSInfosResult

    コンテナー

    該当なし

    リクエストの結果を格納するコンテナー。

    親ノード: なし

    Bucket

    文字列

    oss-example

    バケットの名前。

    親ノード: ListBucketRequesterQoSInfosResult

    ContinuationToken

    文字列

    207xxxx

    この ListBucketRequesterQoSInfos リクエストで使用される continuationToken。

    親ノード: ListBucketRequesterQoSInfosResult

    NextContinuationToken

    文字列

    262xxxx

    この ListBucketRequesterQoSInfos リクエストに後続の結果が含まれていることを示します。 NextContinuationToken の値は、後続の結果を照会するために ContinuationToken の値として使用されます。

    親ノード: ListBucketRequesterQoSInfosResult

    IsTruncated

    ブール値

    true

    照会された結果が切り捨てられるかどうかを示します。

    • true は、今回すべての結果が返されないことを示します。

    • false は、今回すべての結果が返されることを示します。

    親ノード: ListBucketRequesterQoSInfosResult

    RequesterQoSInfo

    コンテナー

    該当なし

    リクエスターの速度制限構成を格納するコンテナー。

    親ノード: RequesterQoSInfo

    Requester

    文字列

    266xxxx

    リクエスターのユーザー ID (UID)。

    親ノード: RequesterQoSInfo

    QoSConfiguration

    コンテナー

    該当なし

    リクエスターの速度制限構成を格納するコンテナー。

    親ノード: RequesterQoSInfo

    TotalUploadBandwidth

    整数

    10

    バケットに対するリクエスターの合計アップロード帯域幅。単位: Gbit/s。

    親ノード: QoSConfiguration

    IntranetUploadBandwidth

    整数

    -1

    バケットに対するリクエスターの内部ネットワーク経由のアップロード帯域幅。内部ネットワークには、クラシックネットワークと仮想プライベートクラウド ( VPC ) が含まれます。単位: Gbit/s。

    親ノード: QoSConfiguration

    ExtranetUploadBandwidth

    整数

    -1

    バケットに対するリクエスターのパブリックネットワーク経由のアップロード帯域幅。パブリックネットワークには、インターネットとアクセラレーションエンドポイントが含まれます。単位: Gbit/s。

    親ノード: QoSConfiguration

    TotalDownloadBandwidth

    整数

    10

    バケットに対するリクエスターの合計ダウンロード帯域幅。単位: Gbit/s。

    親ノード: QoSConfiguration

    IntranetDownloadBandwidth

    整数

    -1

    バケットに対するリクエスターの内部ネットワーク経由のダウンロード帯域幅。内部ネットワークには、クラシックネットワークと VPC が含まれます。単位: Gbit/s。

    親ノード: QoSConfiguration

    ExtranetDownloadBandwidth

    整数

    -1

    バケットに対するリクエスターのパブリックネットワーク経由のダウンロード帯域幅。パブリックネットワークには、インターネットとアクセラレーションエンドポイントが含まれます。単位: Gbit/s。

    親ノード: QoSConfiguration

    例

    • リクエストの例

      GET /?requesterQosInfo&max-keys=2&continuation-token=207xxxx
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • レスポンスの例

      HTTP/1.1 200 OK
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Length: 1385
x-oss-request-id: 534****

<ListBucketRequesterQoSInfosResult>
  <Bucket>BucketName</Bucket>
  <ContinuationToken>207xxxx</ContinuationToken>
  <NextContinuationToken>262xxxx</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <RequesterQoSInfo>
    <Requester>266xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
  <RequesterQoSInfo>
    <Requester>276xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
</ListBucketRequesterQoSInfosResult>

    OSS SDK

    次のプログラミング言語用の OSS SDK を使用して、ListBucketRequesterQoSInfos を呼び出すことができます。

    レスポンス要素

    詳細については、「list-bucket-requester-qos-infos」をご参照ください。