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.
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.