ListResourcePoolBuckets - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações

O QoS de pool de recursos está em preview por convite. Se a throughput dos seus buckets OSS em uma região atingiu ou ultrapassou 400 Gbit/s, você pode entrar em contato com o suporte técnico para solicitar esse recurso.
Por padrão, uma conta Alibaba Cloud tem permissão para recuperar a lista de buckets em um pool de recursos especificado. Para acessar essa lista por meio de um usuário RAM ou do Security Token Service, você deve ter a permissão oss:ListResourcePoolBuckets. Para instruções detalhadas, consulte Exemplos comuns de políticas RAM.

Sintaxe da requisição

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

Cabeçalhos da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte cabeçalhos de requisição comuns.

Elementos da requisição

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
resourcePool	String	Sim	resource-pool-for-ai	O nome do pool de recursos.
max-keys	Integer	Não	10	O número máximo de buckets a serem retornados nesta requisição.
continuation-token	String	Não	rp-bucket-01	O bucket a partir do qual as informações devem começar a ser retornadas.

Cabeçalhos da resposta

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

Elementos da resposta

Nome	Tipo	Valor de exemplo	Descrição
ListResourcePoolBucketsResult	Container	N/A	O contêiner que armazena o resultado da requisição. Nós pais: nenhum
ContinuationToken	String	abcd	O continuationToken usado nesta requisição ListResourcePoolBuckets. Nós pais: ListResourcePoolBucketsResult
NextContinuationToken	String	xyz	Indica que esta requisição ListResourcePoolBuckets contém resultados subsequentes. O valor de NextContinuationToken é usado como valor de ContinuationToken para consultar os resultados subsequentes. Nós pais: ListResourcePoolBucketsResult
IsTruncated	Boolean value	true	Indica se os resultados consultados estão truncados. true indica que nem todos os resultados foram retornados desta vez. false indica que todos os resultados foram retornados desta vez. Nós pais: ListResourcePoolBucketsResult
ResourcePoolBucket	Container	N/A	O contêiner que armazena os resultados da lista de buckets no pool de recursos. Nós pais: ListResourcePoolBucketsResult
Name	String	rp-bucket-01	O nome do bucket. Nós pais: ResourcePoolBucket
Group	String	test-group-1	O nome do grupo de buckets.
JoinTime	String	2024-11-29T08:42:32.000Z	O momento em que o bucket ingressa no pool de recursos, no formato ISO8601. Nós pais: ResourcePoolBucket

Exemplos

Exemplo de consulta

GET /?resourcePoolBuckets&resourcePool=resource-pool-for-ai&continuation-token=abc&maxKeys=2
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

Exemplo de resposta de sucesso

HTTP/1.1 200 OK
Date: Sun, 11 Aug 2024 17:45:00 GMT
Content-Length: 510
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<ListResourcePoolBucketsResult>
  <ResourcePool>resource-pool-for-ai</ResourcePool>
  <ContinuationToken>abcd</ContinuationToken>
  <NextContinuationToken>defg</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <ResourcePoolBucket>
    <Name>rp-bucket-01</Name>
    <Group>test-group-1</Group>
    <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
  </ResourcePoolBucket>
  <ResourcePoolBucket>
    <Name>rp-bucket-02</Name>
    <Group>test-group-1</Group>
    <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
  </ResourcePoolBucket>
</ListResourcePoolBucketsResult>

SDKs do OSS

Você pode usar os SDKs do OSS para as seguintes linguagens de programação para chamar ListResourcePoolBuckets:

Ferramenta de linha de comando ossutil

Para o comando ossutil correspondente à operação ListResourcePoolBuckets, consulte list-resource-pool-buckets.