ListTableBuckets - Object Storage Service - Centre de documentation Alibaba Cloud

Notes d'utilisation

Utilisez le paramètre prefix pour filtrer les buckets de table par préfixe de nom.
Utilisez le paramètre maxBuckets pour limiter le nombre maximal de buckets de table renvoyés dans une seule réponse. Valeur par défaut : 1 000.
Si une réponse contient le jeton continuationToken, les résultats sont tronqués. Pour récupérer la page de résultats suivante, incluez ce jeton dans votre requête suivante.

Autorisations

API

Actions

Description

ListTableBuckets

oss:ListTableBuckets

Répertorie les buckets de table.

Syntaxe de la requête

GET /buckets?continuationToken={continuationToken}&maxBuckets={maxBuckets}&prefix={prefix} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

maxBuckets

Integer

Non

10

Nombre maximal de buckets de table à renvoyer. Valeurs valides : 1 à 1 000. Valeur par défaut : 1 000.

prefix

String

Non

my-

Limite la réponse aux buckets de table dont les noms commencent par le préfixe spécifié.

continuationToken

String

Non

-

Jeton de pagination issu d'une réponse précédente tronquée. Incluez ce jeton pour récupérer la page de résultats suivante.

Paramètres de réponse

Paramètre

Type

Exemple

Description

tableBuckets

Array

-

Liste des buckets de table. Chaque élément contient l'ARN (arn), la date de création (createdAt), le nom (name), l'ID du compte propriétaire (ownerAccountId), l'ID du bucket de table (tableBucketId) et le type (type) d'un bucket de table.

continuationToken

String

-

Jeton de pagination renvoyé lorsque l'ensemble de résultats est tronqué. Incluez ce jeton dans une requête ultérieure pour récupérer la page de résultats suivante.

Exemples

Exemple de requête

GET /buckets?maxBuckets=10 HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****

Exemple de réponse

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json

{
   "continuationToken": "xxxxx",
   "tableBuckets": [
      {
         "arn": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket",
         "createdAt": "2024-01-01T00:00:00.000000Z",
         "name": "my-table-bucket",
         "ownerAccountId": "1234567890",
         "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
         "type": "customer"
      }
   ]
}

SDK

Vous pouvez appeler cette opération à l'aide des SDK suivants :

Outil de ligne de commande ossutil

Pour la commande ossutil associée à cette opération, consultez list-table-buckets.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

BadRequestException

400

La requête n'est pas valide ou est mal formée.

ForbiddenException

403

L'appelant n'est pas autorisé à effectuer cette opération.