Todos os produtos
Search

Este produto

    Object Storage Service:Listar tabelas

    Central de documentação

    Object Storage Service:Listar tabelas

    Última atualização: Jul 03, 2026

    Lista todas as tabelas em um namespace especificado.

    Observações

    • Se houver muitas tabelas, use o parâmetro --max-tables para limitar a quantidade de tabelas retornadas por solicitação e o parâmetro --continuation-token para paginação.

    • Se a resposta incluir um continuation-token, há mais tabelas disponíveis. Passe esse token ao parâmetro --continuation-token na próxima solicitação para obter a página seguinte de resultados.

    • Use o parâmetro --prefix para retornar apenas as tabelas cujos nomes começam com um prefixo específico.

    Formato do comando

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

    Parâmetro

    Tipo

    Descrição

    --continuation-token

    string

    Token de paginação de uma resposta anterior. Use este token para recuperar a próxima página de resultados. Omita este parâmetro na primeira solicitação.

    --max-tables

    int

    Número máximo de tabelas retornadas por solicitação. Os valores padrão e máximo dependem dos limites do servidor.

    --namespace

    string

    Nome do namespace que contém as tabelas a serem listadas.

    --prefix

    string

    Retorna somente tabelas cujos nomes começam com o prefixo especificado.

    --table-bucket-arn

    string

    O ARN do Table Bucket segue o formato acs:osstables:{region}:{uid}:bucket/{bucket-name}.
    Nota

    • O comando list-tables corresponde à operação da API ListTables. Para obter detalhes sobre os parâmetros da API, consulte ListTables.

    • Para ver as opções globais de linha de comando compatíveis, consulte Opções globais do ossutil.

    Exemplos

    • Liste todas as tabelas em um namespace especificado.

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

    • Filtre os nomes das tabelas por prefixo para retornar apenas aquelas que começam com test_.

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

    • Liste as tabelas e limite os resultados a no máximo 10 por solicitação.

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