Consulta de bancos de dados
Função
Esta API é usada para consultar bancos de dados de uma instância de banco de dados especificada.
- Antes de chamar uma API, você precisa entender a API em Autenticação.
Restrições
- Esta operação não pode ser executada quando a instância de banco de dados está no estado anormal ou congelado.
- Os detalhes sobre bancos de dados de réplicas de leitura não podem ser consultados.
URI
- Descrição do parâmetro
Tabela 1 Descrição do parâmetro Nome
Obrigatório
Descrição
project_id
Sim
Especifica o ID do projeto de um locatário em uma região.
Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.
instance_id
Sim
Especifica o ID da instância de banco de dados.
page
Sim
Especifica o número da página. O valor começa a partir de 1.
limit
Sim
Especifica o número de registros em cada página. O valor varia de 1 (inclusive) a 100 (inclusive).
Solicitação
Resposta
- Resposta normal
Tabela 2 Descrição do parâmetro Nome
Tipo
Descrição
databases
Array of objects
Cada elemento na lista indica um banco de dados.
Para mais detalhes, consulte Tabela 3.
total_count
Integer
Indica o número total de bancos de dados.
Tabela 3 Descrição da estrutura do elemento databases Nome
Tipo
Descrição
name
String
Indica o nome de banco de dados.
owner
String
Indica o proprietário de banco de dados.
character_set
String
Indica o conjunto de caracteres usado pelo banco de dados, como UTF8.
collate_set
String
Indica o agrupamento de banco de dados, como en_US.UTF-8.
size
Integer
Indica o tamanho de banco de dados, em bytes.
- Exemplo de resposta normal
{ "databases": [ { "name": "rds_test", "owner": "root", "character_set": "UTF8", "collate_set":"en_US.UTF-8", "size":10777247 }, { "name": "rds_test2", "owner":"root", "character_set": "UTF8" "collate_set":"en_US.UTF-8", "size":1055623 }, { "name": "rds_test3", "owner":"root", "character_set": "UTF8" "collate_set":"en_US.UTF-8", "size":107772488 } ], "total_count": 3 }
- Resposta anormal
Para mais detalhes, consulte Resultados anormais da solicitação.
Código de status
- Normal
- Anormal
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.