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.
Atualizado em 2023-05-05 GMT+08:00

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

  • 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 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

  • 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 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
    }

Código de status

Código de erro

Para mais detalhes, consulte Códigos de erro.