調用ListResourcePoolBucketGroups列舉指定資源集區的BucketGroup列表。
注意事項
當前資源集區QoS為邀測功能。您在某個地區的OSS效能達到500Gbps及以上,請聯絡支援人員申請使用。
阿里雲帳號預設擁有全部許可權。如果通過RAM使用者或者RAM角色的方式進行列舉,需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket 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 | 本次返回結果是否截斷。
父節點: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如下: