すべてのプロダクト
Search

このプロダクト

    Object Storage Service:バケットリクエスタ QoS 情報の取得

    ドキュメントセンター

    Object Storage Service:バケットリクエスタ QoS 情報の取得

    最終更新日:Apr 29, 2025

    GetBucketRequesterQoSInfo を呼び出して、リソースプール内のバケットにアクセスするリクエスタの速度制限構成をクエリできます。

    注意事項

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

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

    構文

    GET /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    リクエストヘッダー

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

    リクエスト要素

    名前

    タイプ

    必須

    例

    説明

    qosRequester

    文字列

    はい

    300xxxx

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

    レスポンスヘッダー

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

    レスポンス要素

    名前

    タイプ

    例

    説明

    RequesterQoSInfo

    コンテナ

    該当なし

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

    親ノード: なし

    Requester

    文字列

    300xxxx

    リクエスタのユーザー 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&qosRequester=300xxxx
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: 515
x-oss-request-id: 534****

<RequesterQoSInfo>
  <Requester>300xxxx</Requester>
  <QoSConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
  </QoSConfiguration>
</RequesterQoSInfo>

    OSS SDK

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

    ossutil

    GetBucketRequesterQoSInfo 操作に対応する ossutil コマンドについては、「get-bucket-requester-qos-info」をご参照ください。