Consulta de usuários de banco de dados
Função
Esta API é usada para consultar usuários de banco de dados para 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á em qualquer um dos seguintes status: criação, alteração da classe da instância, alteração da porta, congelada ou anormal.
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 em 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
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 do banco de dados.
Tabela 3 Descrição da estrutura do elemento users Nome
Tipo
Descrição
name
String
Indica o nome da conta.
attributes
Object
Indica atributos de permissão de um usuário.
Para mais detalhes, consulte Tabela 4.
memberof
Array of strings
Indica os direitos padrão de um usuário.
Tabela 4 Descrição da estrutura do elemento attributes Nome
Tipo
Descrição
rolsuper
Boolean
Indica se um usuário tem a permissão de superusuário. O valor é false.
rolinherit
Boolean
Indica se um usuário herda automaticamente as permissões da função à qual o usuário pertence. O valor pode ser true ou false.
rolcreaterole
Boolean
Indica se um usuário pode criar outros subusuários. O valor pode ser true ou false.
rolcreatedb
Boolean
Indica se um usuário pode criar um banco de dados. O valor pode ser true ou false.
rolcanlogin
Boolean
Indica se um usuário pode efetuar logon no banco de dados. O valor pode ser true ou false.
rolconnlimit
Integer
Indica o número máximo de conexões simultâneas a uma instância de banco de dados. O valor -1 indica que não há limitações no número de conexões simultâneas.
rolreplication
Boolean
Indica se o usuário é uma função de replicação. O valor pode ser true ou false.
rolbypassrls
Boolean
Indica se um usuário ignora cada política de segurança ao nível de linha. O valor pode ser true ou false.
- Exemplo de resposta normal
{ "users": [ { "name": "rdsuser", "attributes": { "rolsuper": false, "rolinherit": true, "rolcreaterole": true, "rolcreatedb": true, "rolcanlogin": true, "rolconnlimit": -1, "rolreplication": true, "rolbypassrls": false }, "memberof": ["pg_monitor", "pg_read_all_stats", "pg_stat_scan_tables", "pg_signal_backend"] }, { "name": "rdsuser1", "attributes": { "rolsuper": false, "rolinherit": true, "rolcreaterole": true, "rolcreatedb": true, "rolcanlogin": true, "rolconnlimit": -1, "rolreplication": true, "rolbypassrls": false }, "memberof": [] }], "total_count": 2 }
- 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.