Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Relational Database Service/ Referência de API/ API v3 (recomendada)/ Gerenciamento de bancos de dados e contas (Microsoft SQL Server)/ Consulta de bancos de dados

Atualizado em 2023-05-05 GMT+08:00

Ver PDF

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.
A lista de usuários de banco de dados de réplicas de leitura não pode ser consultada.

URI

Formato de URI
GET /v3/{project_id}/instances/{instance_id}/database/detail?page={page}&limit={limit}&db-name={db-name}

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 intervalo de valor é de 1 (inclusive) a 100 (inclusive).
db-name	Não	Especifica o nome de banco de dados. Quando este parâmetro está especificado, os parâmetros page e limit precisam estar especificados, mas não têm efeito.

Solicitação

Parâmetros de solicitação
Nenhum
Exemplo de URI
GET https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/database/detail?page=1&limit=10&db-name=testdb1

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.
character_set	String	Indica o conjunto de caracteres usado pelo banco de dados, como Chinese_PRC_CI_AS.
state	String	Indica o status de banco de dados. O valor pode ser qualquer um dos seguintes: Creating: o banco de dados está sendo criado. Running: o banco de dados está em execução. Deleting: o banco de dados está sendo excluído. Not Exists: a base de dados não existe.

Exemplo de resposta normal

{
    "databases": [
        {
            "name": "master",
            "character_set": "Chinese_PRC_CI_AS",
            "state": "Running"
        },
        {
            "name": "msdb",
            "character_set": "Chinese_PRC_CI_AS",
            "state": "Running"
        },
        {
            "name": "model",
            "character_set": "Chinese_PRC_CI_AS",
            "state": "Running"
        },
        {
            "name": "tempdb",
            "character_set": "Chinese_PRC_CI_AS",
            "state": "Running"
        },
        {
            "name": "rdsadmin",
            "character_set": "Chinese_PRC_CI_AS",
            "state": "Running"
        },
        {
            "name": "rds-test",
            "character_set": "Chinese_PRC_CI_AS",
            "state": "Running"
        }
    ],
    "total_count": 6
}