全部產品
Search
文件中心

Object Storage Service:GetResourcePoolInfo

更新時間:Apr 26, 2025

調用GetResourcePoolInfo擷取指定資源集區的資訊。

注意事項

  • 當前資源集區QoS為邀測功能。您在某個地區的OSS效能達到500Gbps及以上,請聯絡支援人員申請使用。

  • 阿里雲帳號預設擁有擷取指定資源集區流控配置的許可權。如果您需要通過RAM使用者或者STS的方式進行擷取,您必須擁有oss:GetResourcePoolInfo許可權。具體操作,請參見RAM Policy常見樣本

請求文法

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

要求標頭

此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

請求元素

名稱

類型

是否必選

樣本值

描述

resourcePool

字串

resource-pool-for-ai

資源集區名稱。

回應標頭

此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

響應元素

名稱

類型

樣本值

描述

GetResourcePoolInfoResponse

容器

不涉及

儲存請求結果的容器。

父節點:無

Region

字串

oss-cn-hangzhou

資源集區所屬地區。

父節點:GetResourcePoolInfoResponse

Name

字串

resource-pool-for-ai

資源集區名稱。

父節點:GetResourcePoolInfoResponse

Owner

字串

103xxxx

資源集區所屬的帳號UID。

父節點:GetResourcePoolInfoResponse

CreateTime

字串

2024-11-29T08:42:32.000Z

資源集區建立時間,格式為ISO8601。

父節點:GetResourcePoolInfoResponse

QoSConfiguration

容器

不涉及

儲存資源集區流控配置資訊的容器

父節點:GetResourcePoolInfoResponse

TotalUploadBandwidth

整數

10

資源集區的總上傳頻寬,單位Gbps。

父節點:QoSConfiguration

IntranetUploadBandwidth

整數

-1

資源集區的內網上傳頻寬,包括傳統網路和VPC網路的內網上傳頻寬,單位Gbps。

取值為-1,表示不限制內網上傳頻寬。

父節點:QoSConfiguration

ExtranetUploadBandwidth

整數

-1

資源集區的外網上傳頻寬,包括公網和傳輸加速網域名稱的上傳頻寬,單位Gbps。

父節點:QoSConfiguration

TotalDownloadBandwidth

整數

10

資源集區的總下載頻寬,單位Gbps。

父節點:QoSConfiguration

IntranetDownloadBandwidth

整數

-1

內網下載頻寬,包括傳統網路和VPC網路的內網下載請求,單位Gbps。

取值為-1,表示不限制內網下載頻寬。

父節點:QoSConfiguration

ExtranetDownloadBandwidth

整數

-1

外網下載頻寬,包括公網和傳輸加速網域名稱的下載頻寬,單位Gbps。

父節點: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>

SDK

GetResourcePoolInfo介面所對應的各語言SDK如下:

命令列工具ossutil

GetResourcePoolInfo介面所對應的ossutil命令,請參見get-resource-pool-info