ListTables - List tables in a Table Bucket | OSS API - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

Uma única solicitação retorna até 1.000 tabelas. Use continuationToken para paginação.
Use o parâmetro namespace para listar tabelas em um namespace específico.
Use o parâmetro prefix para filtrar pelo prefixo do nome da tabela.

Permissões

API	Action	Descrição
ListTables	oss:ListTables	Lista tabelas.

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Valor de exemplo	Descrição
tableBucketARN	String	Sim	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN do Table Bucket especificado no URI da solicitação. Formato: `acs:osstables:{region}:{uid}:bucket/{bucketName}`.
continuationToken	String	Não	xxx-continuation-token	Token de paginação da resposta anterior. Omita na solicitação inicial. Parâmetro de consulta.
maxTables	Integer	Não	100	Número máximo de tabelas a retornar. Valores válidos: 1 a 1.000. Padrão: 1.000. Parâmetro de consulta.
namespace	String	Não	my_namespace	Retorna apenas tabelas no namespace especificado. Parâmetro de consulta.
prefix	String	Não	my_	Retorna apenas tabelas cujos nomes começam com este prefixo. Parâmetro de consulta.

Parâmetros da resposta

Parâmetro	Tipo	Valor de exemplo	Descrição
tables	Array	-	Lista de objetos de tabela. Cada objeto contém: `name` (nome da tabela), `namespace` (array de nomes de namespace), `tableARN` (ARN da tabela), `type` (tipo da tabela), `createdAt` (hora de criação) e `modifiedAt` (hora da última modificação).
continuationToken	String	xxx-continuation-token	Retornado apenas quando os resultados são truncados. Passe este valor em uma solicitação subsequente para recuperar a próxima página.

Exemplos

Exemplo de solicitação

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

Exemplo de resposta

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"
      }
   ]
}

SDKs

ListTables está disponível nos seguintes SDKs:

ossutil CLI

Comando correspondente do ossutil: list-tables.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
BadRequestException	400	A solicitação é inválida ou malformada.
ForbiddenException	403	O chamador não tem a permissão necessária.
NotFoundException	404	O recurso solicitado não existe.