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-06 GMT+08:00

Consulta de detalhes sobre usuários do banco de dados

Descrição

Esta API é usada para consultar detalhes sobre os usuários do banco de dados.

Restrições

  • Esta API aplica-se apenas ao DDS Community Edition.
  • Esta operação não é permitida se a instância de banco de dados estiver em qualquer um dos seguintes status: criando, alterando a classe da instância, alterando a porta, reiniciando ou anormal.

Depuração

Você pode depurar essa API no API Explorer.

URI

  • Formato de URI

    GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-user/detail?offset ={offset}&limit={limit}&user_name={user_name }&db_name={db_name}

  • Exemplo de URI
    • Consulta da lista de todos os usuários:

      https://dds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/3527b6b16e7639b88930a360d2c4in02/db-user/detail

    • Consulta da lista de usuários com base em condições especificadas.

      https://dds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/3527b6b16e7639b88930a360d2c4in02/db-user/detail?offset=0&limit=100&user_name=test&db_name=testDb

Tabela 1 Descrição do parâmetro

Nome

Tipo

Obrigatório

Descrição

x-auth-token

String

Sim

Token do usuário

project_id

String

Sim

O ID do projeto de um locatário em uma região. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.

instance_id

String

Sim

O ID da instância, que pode ser obtido ao chamar a API para consultar instâncias. Se você não tiver uma instância, poderá chamar a API usada para criar uma instância.

user_name

String

Não

O nome de usuário.

O valor deve conter de 1 a 64 caracteres e pode conter apenas letras (de A a Z ou de a a z), dígitos (de 0 a 9), hífens (-) e pontos (.).

db_name

String

Não

O nome do banco de dados onde o usuário está localizado. O valor padrão é "admin".

O valor deve ter de 1 a 64 caracteres e pode conter apenas letras (de A a Z ou de a a z), dígitos (de 0 a 9) e sublinhados (_).

offset

Integer

Não

A posição do índice.

O valor deve ser superior ou igual a 0. Se este parâmetro não for transferido, o valor é 0 por padrão.

limit

Integer

Não

O limite superior do número de registros consultados.

O valor varia de 1 a 100. Se esse parâmetro não for transferido, as primeiras 100 instâncias de banco de dados serão consultadas por padrão.

Solicitações

Nenhuma

Respostas

  • Descrição do parâmetro
    Tabela 2 Descrição do parâmetro

    Nome

    Tipo

    Obrigatório

    Descrição

    users

    String

    Sim

    As informações sobre os usuários do banco de dados.

    CUIDADO:

    O valor de retorno está no formato nativo do banco de dados e precisa ser analisado pelo usuário.

    total_count

    Integer

    Sim

    O número total de usuários do banco de dados.

  • Exemplo de resposta
    {
      "total_count": 1,
      "users": "[{\"inheritedPrivileges\":[{\"resource\":{\"collection\":\"temproles\",\"db\":\"admin\"},\"actions\":[\"find\"]}],\"roles\":[{\"role\":\"root\",\"db\":\"admin\"}],\"inheritedRoles\":[{\"role\":\"root\",\"db\":\"admin\"}],\"_id\":\"admin.rwuser\",\"user\":\"rwuser\",\"db\":\"admin\"}]"
    }

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.

Código de status

Para obter mais informações, consulte Código de status.

Código de erro

Para obter mais informações, consulte Código de erro.