Todos os produtos
Search
Central de documentação

Object Storage Service:ListResourcePoolBucketGroups

Última atualização: Jul 03, 2026

Lista grupos de buckets em um resource pool especificado.

Observações de uso

  • O QoS de resource pool está em visualização por convite. Se o throughput dos seus buckets do OSS em uma região atingir ou ultrapassar 500 Gbit/s, entre em contato com o suporte técnico para solicitar esse recurso.

  • Por padrão, uma conta Alibaba Cloud tem permissões totais sobre os próprios recursos. Para executar a operação como usuário RAM ou com uma função RAM, solicite ao proprietário da conta Alibaba Cloud ou ao administrador a concessão da permissão oss:ListResourcePoolBucketGroups por meio de uma política do RAM ou de uma política de bucket.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

Esta operação requer apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.

Elementos da solicitação

Nome

Tipo

Obrigatório

Exemplo

Descrição

resourcePool

string

Sim

resource-pool-for-ai

Nome do resource pool.

max-keys

Integer

Não

2

Número máximo de buckets a retornar do resource pool.

continuation-token

string

Não

abc

Token a partir do qual iniciar a listagem.

Cabeçalhos da resposta

Esta operação retorna apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.

Elementos da resposta

Nome

Tipo

Exemplo

Descrição

ListResourcePoolBucketGroupsResult

container

N/A

Container que armazena o resultado da solicitação.

Nó pai: nenhum

ResourcePool

string

resource-pool-for-ai

Nome do resource pool.

Nó pai: ListResourcePoolBucketGroupsResult

ContinuationToken

string

abcd

Token de continuação usado nesta solicitação.

Nó pai: ListResourcePoolBucketGroupsResult

NextContinuationToken

string

defg

Token a ser usado como valor de continuation-token em uma solicitação subsequente para recuperar entradas adicionais.

Nó pai: ListResourcePoolBucketGroupsResult

IsTruncated

Boolean

true

Indica se o resultado foi truncado.

  • true: nem todas as entradas foram retornadas.

  • false: todas as entradas foram retornadas.

Nó pai: ListResourcePoolBucketGroupsResult

ResourcePoolBucketGroup

container

N/A

Container que armazena informações sobre o grupo de buckets.

Nó pai: ListResourcePoolBucketGroupsResult

Name

string

test-group

Nome do grupo de buckets.

Nó pai: ResourcePoolBucketGroup

GroupBucketInfo

container

N/A

Informações sobre o grupo de buckets.

Nó pai: ResourcePoolBucketGroup

BucketName

string

examplebucket

Nome do bucket.

Nó pai: GroupBucketInfo

Exemplos

  • Exemplo de solicitação

    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
  • Exemplo de resposta

    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>

SDKs

Os seguintes SDKs do OSS oferecem suporte a esta operação: