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

Observações

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ão para obter a lista de buckets em um resource pool especificado. Para acessar essa lista por meio de um usuário RAM ou do Security Token Service, é necessária a permissão oss:ListResourcePoolBuckets. Para obter instruções detalhadas, consulte Exemplos comuns de políticas do RAM.

Sintaxe da solicitaçã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 solicitação

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

Elementos da solicitação

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
resourcePool	String	Sim	resource-pool-for-ai	Nome do resource pool.
max-keys	Integer	Não	10	Número máximo de buckets a retornar nesta solicitação.
continuation-token	String	Não	rp-bucket-01	Bucket a partir do qual as informações começam a ser retornadas.

Cabeçalhos da resposta

Esta operação usa 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	Container que armazena o resultado da solicitação. Nós pai: nenhum
ContinuationToken	String	abcd	ContinuationToken usado nesta solicitação ListResourcePoolBuckets. Nós pai: ListResourcePoolBucketsResult
NextContinuationToken	String	xyz	Indica que esta solicitação ListResourcePoolBuckets contém resultados subsequentes. Use o valor de NextContinuationToken como ContinuationToken para consultar os próximos resultados. Nós pai: ListResourcePoolBucketsResult
IsTruncated	Valor booleano	true	Indica se os resultados consultados foram truncados. true indica que nem todos os resultados foram retornados desta vez. false indica que todos os resultados foram retornados desta vez. Nós pai: ListResourcePoolBucketsResult
ResourcePoolBucket	Container	N/A	Container que armazena os resultados da lista de buckets no resource pool. Nós pai: ListResourcePoolBucketsResult
Name	String	rp-bucket-01	Nome do bucket. Nós pai: ResourcePoolBucket
Group	String	test-group-1	Nome do grupo de buckets.
JoinTime	String	2024-11-29T08:42:32.000Z	Momento em que o bucket foi adicionado ao resource pool, no formato ISO8601. Nós pai: 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

Use os SDKs do OSS nas linguagens de programação a seguir para chamar a operação ListResourcePoolBuckets:

Ferramenta de linha de comando ossutil

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