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 usuários de banco de dados

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

Ver PDF

Consulta de usuários de banco de dados

Função

Esta API é usada para consultar usuários de banco 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}/db_user/detail?page={page}&limit={limit}

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).

Solicitação

Parâmetros de solicitação
Nenhum

Exemplo de URI
GET https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db_user/detail?page=1&limit=10

Resposta

Resposta normal

**Tabela 2** Descrição do parâmetro
Nome	Tipo	Descrição
users	Array of objects	Cada elemento na lista indica uma conta de banco de dados. Para mais detalhes, consulte Tabela 3.
total_count	Integer	Indica o número total de usuários de banco de dados.

**Tabela 3** Descrição da estrutura do elemento users
Nome	Tipo	Descrição
name	String	Indica o nome da conta.
state	String	Indica o status do usuário de banco de dados. unavailable: o usuário de banco de dados não está disponível. available: o usuário de banco de dados está disponível.

Exemplo de resposta normal

{
 "users": [
    {
     "name": "rdsuser",
     "state": "available"
    },
   {
    "name": "login001",
    "state": "available"
    }
 ],
 "total_count": 2
 }