全部產品
Search
文件中心

Object Storage Service:ListResourcePoolBucketGroups

更新時間:Jun 04, 2025

調用ListResourcePoolBucketGroups列舉指定資源集區的BucketGroup列表。

注意事項

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

  • 阿里雲帳號預設擁有全部許可權。如果通過RAM使用者或者RAM角色的方式進行列舉,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket Policy授予oss:ListResourcePoolBucketGroups許可權。

請求文法

GET /?resourcePoolBucketGroup&resourcePool=ResourcePoolName&continuation-token=abc&max-keys=2
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

要求標頭

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

請求元素

名稱

類型

是否必選

樣本值

描述

resourcePool

字串

resource-pool-for-ai

資源集區名稱。

max-keys

整數

2

限定此次返回資源集區內Bucket的最大數量。

continuation-token

字串

abc

限定從哪個Bucket開始返回資訊。

回應標頭

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

響應元素

名稱

類型

樣本值

描述

ListResourcePoolBucketGroupsResult

容器

不涉及

儲存請求結果的容器。

父節點:無

ResourcePool

字串

resource-pool-for-ai

返回目標資源集區名稱。

父節點:ListResourcePoolBucketGroupsResult

ContinuationToken

字串

abcd

本次列舉請求使用的ContinuationToken。

父節點:ListResourcePoolBucketGroupsResult

NextContinuationToken

字串

defg

表明此次列舉請求包含後續結果,需要將NextContinuationToken指定為下次列舉請求的起點,繼續擷取結果。

父節點:ListResourcePoolBucketGroupsResult

IsTruncated

布爾值

true

本次返回結果是否截斷。

  • true表示本次沒有返回全部結果。

  • false表示本次已經返回了全部結果。

父節點:ListResourcePoolBucketGroupsResult

ResourcePoolBucketGroup

容器

不涉及

儲存BucketGroup資訊的容器。

父節點:ListResourcePoolBucketGroupsResult

Name

字串

test-group

BucketGroup的名稱。

父節點:ResourcePoolBucketGroup

GroupBucketInfo

容器

不涉及

BucketGroup的資訊。

父節點:ResourcePoolBucketGroup

BucketName

字串

examplebucket

Bucket名稱。

父節點:GroupBucketInfo

樣本

  • 請求樣本

    GET /?resourcePoolBucketGroup&resourcePool=resource-pool-for-ai&continuation-token=abc&maxKeys=2
    Host: oss-cn-shanghai.aliyuncs.com
    Date: Sun, 11 Aug 2024 17:45:00 GMT
    Authorization: SignatureValue
  • 返回樣本

    HTTP/1.1 200 OK
    Date: Sun, 11 Aug 2024 17:45:00 GMT
    Content-Length: 5678
    Content-Type: application/xml
    
    <?xml version="1.0" encoding="UTF-8"?>
    <ListResourcePoolBucketGroupsResult>
      <ResourcePool>rp-for-ai</ResourcePool>
      <ContinuationToken>abcd</ContinuationToken>
      <NextContinuationToken>defg</NextContinuationToken>
      <IsTruncated>true</IsTruncated>
      <ResourcePoolBucketGroup>
        <Name>test-group<Name/>
        <GroupBucketInfo>
          <BucketName>bucket-01</BucketName>
        <GroupBucketInfo>
        <GroupBucketInfo>
          <BucketName>bucket-02</BucketName>
        <GroupBucketInfo>
      </ResourcePoolBucketGroup>
    </ListResourcePoolBucketGroupsResult>

SDK

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