ListResourcePoolBuckets - Object Storage Service - Centro de documentación de Alibaba Cloud

Utilice la operación ListResourcePoolBuckets para obtener una lista de buckets dentro de un resource pool específico.

Notas

La QoS del resource pool se encuentra en versión preliminar por invitación. Si el rendimiento de sus buckets de OSS en una región ha alcanzado o superado los 500 Gbit/s, póngase en contacto con soporte técnico para solicitar esta función.
De forma predeterminada, una cuenta de Alibaba Cloud tiene permiso para obtener la lista de buckets en un resource pool especificado. Para acceder a esta lista mediante un usuario de RAM o Security Token Service, debe contar con el permiso oss:ListResourcePoolBuckets. Para obtener instrucciones detalladas, consulte RAM policy common examples.

Sintaxis de la solicitud

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

Encabezados de solicitud

Esta operación utiliza únicamente encabezados de solicitud comunes. Para más información, consulte common request headers.

Elementos de solicitud

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
resourcePool	String	Sí	resource-pool-for-ai	Nombre del resource pool.
max-keys	Integer	No	10	Número máximo de buckets que se devolverán en esta solicitud.
continuation-token	String	No	rp-bucket-01	Bucket a partir del cual se comenzará a devolver la información.

Encabezados de respuesta

Esta operación utiliza únicamente encabezados de respuesta comunes. Para más información, consulte common response headers.

Elementos de respuesta

Nombre	Tipo	Valor de ejemplo	Descripción
ListResourcePoolBucketsResult	Container	N/A	Contenedor que almacena el resultado de la solicitud. Nodos principales: ninguno
ContinuationToken	String	abcd	ContinuationToken utilizado en esta solicitud de ListResourcePoolBuckets. Nodos principales: ListResourcePoolBucketsResult
NextContinuationToken	String	xyz	Indica que esta solicitud de ListResourcePoolBuckets contiene resultados adicionales. Utilice el valor de NextContinuationToken como ContinuationToken para consultar dichos resultados. Nodos principales: ListResourcePoolBucketsResult
IsTruncated	Boolean value	true	Indica si los resultados consultados están truncados. true indica que no se devolvieron todos los resultados en esta ocasión. false indica que se devolvieron todos los resultados en esta ocasión. Nodos principales: ListResourcePoolBucketsResult
ResourcePoolBucket	Container	N/A	Contenedor que almacena los resultados de la lista de buckets en el resource pool. Nodos principales: ListResourcePoolBucketsResult
Name	String	rp-bucket-01	Nombre del bucket. Nodos principales: ResourcePoolBucket
Group	String	test-group-1	Nombre del grupo de buckets.
JoinTime	String	2024-11-29T08:42:32.000Z	Hora en que el bucket se une al resource pool, en formato ISO8601. Nodos principales: ResourcePoolBucket

Ejemplos

Ejemplo 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

Ejemplo de respuesta exitosa

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>

SDK de OSS

Puede utilizar los SDK de OSS para los siguientes lenguajes de programación a fin de invocar ListResourcePoolBuckets:

Herramienta de línea de comandos ossutil

Para consultar el comando de ossutil correspondiente a la operación ListResourcePoolBuckets, consulte list-resource-pool-buckets.