ListTables - List tables in a Table Bucket | OSS API - Object Storage Service

Notes d'utilisation

Une seule requête renvoie jusqu'à 1 000 tables. Utilisez le paramètre continuationToken pour la pagination.
Utilisez le paramètre namespace pour répertorier les tables d'un namespace spécifique.
Utilisez le paramètre prefix pour filtrer par préfixe de nom de table.

Permissions

API

Action

Description

ListTables

oss:ListTables

Répertorie les tables.

Syntaxe de la requête

GET /tables/{tableBucketARN} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Paramètres de la requête

Parameter

Type

Required

Example value

Description

tableBucketARN

String

Yes

acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

L'ARN du Table Bucket, spécifié dans l'URI de la requête. Format : acs:osstables:{region}:{uid}:bucket/{bucketName}.

continuationToken

String

No

xxx-continuation-token

Jeton de pagination issu de la réponse précédente. Omettez ce paramètre pour la requête initiale. Paramètre de requête.

maxTables

Integer

No

100

Nombre maximal de tables à renvoyer. Valeurs valides : 1 à 1 000. Valeur par défaut : 1 000. Paramètre de requête.

namespace

String

No

my_namespace

Renvoie uniquement les tables du namespace spécifié. Paramètre de requête.

prefix

String

No

my_

Renvoie uniquement les tables dont le nom commence par ce préfixe. Paramètre de requête.

Paramètres de la réponse

Parameter

Type

Example value

Description

tables

Array

-

Liste des objets table. Chaque objet contient : name (nom de la table), namespace (tableau des noms de namespace), tableARN (ARN de la table), type (type de table), createdAt (heure de création) et modifiedAt (heure de la dernière modification).

continuationToken

String

xxx-continuation-token

Renvoyé uniquement lorsque les résultats sont tronqués. Transmettez cette valeur dans une requête suivante pour récupérer la page suivante.

Exemples

Exemple de requête

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket?namespace=my_namespace HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
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",
   "tables": [
      {
         "name": "my_table",
         "namespace": ["my_namespace"],
         "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
         "type": "customer",
         "createdAt": "2024-01-01T00:00:00.000000Z",
         "modifiedAt": "2024-06-01T00:00:00.000000Z"
      }
   ]
}

SDK

L'opération ListTables est disponible dans les SDK suivants :

CLI ossutil

Commande ossutil correspondante : list-tables.

Codes d'erreur

Error code

HTTP status code

Description

BadRequestException

400

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

ForbiddenException

403

L'appelant ne dispose pas de l'autorisation requise.

NotFoundException

404

La ressource demandée n'existe pas.