Tous les produits
Search
Centre de documentation

Object Storage Service:ListResourcePoolBuckets

Dernière mise à jour :Aug 18, 2026

Utilisez l'opération ListResourcePoolBuckets pour récupérer la liste des buckets d'un pool de ressources spécifié.

Notes

  • La fonctionnalité QoS du pool de ressources est en aperçu sur invitation. Si le débit de vos buckets OSS dans une région a atteint ou dépassé 500 Gbit/s, contactez le support technique pour demander l'accès à cette fonctionnalité.

  • Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour consulter la liste des buckets d'un pool de ressources donné. Pour accéder à cette liste via un utilisateur RAM ou le Security Token Service, vous devez disposer de l'autorisation oss:ListResourcePoolBuckets. Pour plus de détails, consultez la section Exemples courants de politiques RAM.

Syntaxe de la requête

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

En-têtes de requête

Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.

Éléments de requête

Nom

Type

Obligatoire

Exemple de valeur

Description

resourcePool

String

Oui

resource-pool-for-ai

Nom du pool de ressources.

max-keys

Integer

Non

10

Nombre maximal de buckets à renvoyer dans cette requête.

continuation-token

String

Non

rp-bucket-01

Bucket à partir duquel commencer le renvoi des informations.

En-têtes de réponse

Cette opération utilise uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.

Éléments de réponse

Nom

Type

Exemple de valeur

Description

ListResourcePoolBucketsResult

Container

N/A

Conteneur stockant le résultat de la requête.

Nœuds parents : aucun

ContinuationToken

String

abcd

Jeton de continuation utilisé dans cette requête ListResourcePoolBuckets.

Nœuds parents : ListResourcePoolBucketsResult

NextContinuationToken

String

xyz

Indique que cette requête ListResourcePoolBuckets contient des résultats supplémentaires. La valeur de NextContinuationToken sert de valeur pour ContinuationToken afin d'interroger les résultats suivants.

Nœuds parents : ListResourcePoolBucketsResult

IsTruncated

Valeur booléenne

true

Indique si les résultats interrogés sont tronqués.

  • true indique que tous les résultats n'ont pas été renvoyés cette fois-ci.

  • false indique que tous les résultats ont été renvoyés cette fois-ci.

Nœuds parents : ListResourcePoolBucketsResult

ResourcePoolBucket

Container

N/A

Conteneur stockant les résultats de la liste des buckets dans le pool de ressources.

Nœuds parents : ListResourcePoolBucketsResult

Name

String

rp-bucket-01

Nom du bucket.

Nœuds parents : ResourcePoolBucket

Group

String

test-group-1

Nom du groupe de buckets.

JoinTime

String

2024-11-29T08:42:32.000Z

Heure à laquelle le bucket a rejoint le pool de ressources, au format ISO8601.

Nœuds parents : ResourcePoolBucket

Exemples

  • Exemple de requête

    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
  • Exemple de réponse réussie

    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 OSS

Vous pouvez utiliser les SDK OSS pour les langages de programmation suivants afin d'appeler ListResourcePoolBuckets :

Outil de ligne de commande ossutil

Pour la commande ossutil correspondant à l'opération ListResourcePoolBuckets, consultez la section list-resource-pool-buckets.