すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetResourcePoolInfo

    ドキュメントセンター

    Object Storage Service:GetResourcePoolInfo

    最終更新日:Nov 12, 2025

    リソースプールの情報をクエリします。

    使用上の注意

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

    • デフォルトでは、Alibaba Cloud アカウントにはリソースプールのスロットリング設定をクエリする権限があります。Resource Access Management (RAM) ユーザーまたはセキュリティトークンサービス (STS) を使用してリソースプールの情報をクエリするには、oss:GetResourcePoolInfo 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

    リクエスト構文

    GET /?resourcePoolInfo&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    リクエストヘッダー

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

    リクエスト要素

    要素

    タイプ

    必須

    例

    説明

    resourcePool

    String

    はい

    resource-pool-for-ai

    リソースプールの名前。

    レスポンスヘッダー

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

    レスポンス要素

    要素

    タイプ

    例

    説明

    GetResourcePoolInfoResponse

    コンテナー

    N/A

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

    親ノード: なし。

    Region

    String

    oss-cn-hangzhou

    リソースプールが存在するリージョン。

    親ノード: GetResourcePoolInfoResponse。

    Name

    String

    resource-pool-for-ai

    リソースプールの名前。

    親ノード: GetResourcePoolInfoResponse。

    Owner

    String

    103xxxx

    リソースプールが属するアカウントの一意の識別子 (UID)。

    親ノード: GetResourcePoolInfoResponse。

    CreateTime

    String

    2024-11-29T08:42:32.000Z

    リソースプールが作成された時間。時間は ISO 8601 規格に準拠します。

    親ノード: GetResourcePoolInfoResponse。

    QoSConfiguration

    コンテナー

    N/A

    リソースプールのスロットリング設定を格納するコンテナー。

    親ノード: GetResourcePoolInfoResponse。

    TotalUploadBandwidth

    Integer

    10

    リソースプールの合計アップロード帯域幅。単位: Gbit/s。

    親ノード: QoSConfiguration。

    IntranetUploadBandwidth

    Integer

    -1

    内部ネットワーク経由でのリソースプールのアップロード帯域幅。内部ネットワークには、クラシックネットワークと Virtual Private Cloud (VPC) が含まれます。単位: Gbit/s。

    値 -1 は、内部ネットワーク経由のアップロード帯域幅が無制限であることを示します。

    親ノード: QoSConfiguration。

    ExtranetUploadBandwidth

    Integer

    -1

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

    親ノード: QoSConfiguration。

    TotalDownloadBandwidth

    Integer

    10

    リソースプールの合計ダウンロード帯域幅。単位: Gbit/s。

    親ノード: QoSConfiguration。

    IntranetDownloadBandwidth

    Integer

    -1

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

    値 -1 は、内部ネットワーク経由のダウンロード帯域幅が無制限であることを示します。

    親ノード: QoSConfiguration。

    ExtranetDownloadBandwidth

    Integer

    -1

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

    親ノード: QoSConfiguration。

    例

    • リクエストの例

      GET /?resourcePoolInfo&resourcePool=resource-pool-for-ai
Host: 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: 624
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<GetResourcePoolInfoResponse>
  <Region>oss-cn-hangzhou</Region>
  <Name>resource-pool-for-ai</Name>
  <Owner>103xxxx</Owner>
  <CreateTime>2024-11-29T08:42:32.000Z</CreateTime>
  <QoSConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
  </QoSConfiguration>
</GetResourcePoolInfoResponse>

    OSS SDK

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

    ossutil

    GetResourcePoolInfo 操作に対応する ossutil コマンドの詳細については、「get-resource-pool-info」をご参照ください。