Tous les produits
Search
Centre de documentation

Object Storage Service:List tables

Dernière mise à jour :Aug 18, 2026

Répertorie toutes les tables d’un namespace spécifié.

Notes

  • Si vous disposez d’un grand nombre de tables, utilisez le paramètre --max-tables pour limiter le nombre de tables renvoyées par requête et le paramètre --continuation-token pour la pagination.

  • Si la réponse inclut un continuation-token, d’autres tables sont disponibles. Transmettez ce jeton au paramètre --continuation-token de votre prochaine requête afin de récupérer la page de résultats suivante.

  • Utilisez le paramètre --prefix pour ne renvoyer que les tables dont le nom commence par un préfixe spécifique.

Format de commande

ossutil tables-api list-tables --table-bucket-arn value --namespace value [--prefix value] [--max-tables value] [--continuation-token value] [flags]

Paramètre

Type

Description

--continuation-token

string

Jeton de pagination issu d’une réponse précédente. Utilisez ce jeton pour récupérer la page de résultats suivante. Omettez ce paramètre lors de la première requête.

--max-tables

int

Nombre maximal de tables à renvoyer par requête. Les valeurs par défaut et maximales dépendent des limites côté serveur.

--namespace

string

Nom du namespace contenant les tables à répertorier.

--prefix

string

Renvoie uniquement les tables dont le nom commence par le préfixe spécifié.

--table-bucket-arn

string

L’ARN du Table Bucket est au format acs:osstables:{region}:{uid}:bucket/{bucket-name}.

Remarque
  • La commande list-tables correspond à l’opération API ListTables. Pour plus de détails sur les paramètres de l’API, consultez ListTables.

  • Pour connaître les options de ligne de commande globales prises en charge, reportez-vous à Options globales ossutil.

Exemples

  • Répertoriez toutes les tables d’un namespace spécifié.

    ossutil tables-api list-tables --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace
  • Filtrez les noms de table par préfixe afin de ne renvoyer que les tables dont le nom commence par test_.

    ossutil tables-api list-tables --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --prefix test_
  • Répertoriez les tables en limitant les résultats à un maximum de 10 par requête.

    ossutil tables-api list-tables --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --max-tables 10