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/ Document Database Service/ Referência de API/ APIs V3.0 (recomendada)/ Gerenciamento de bancos de dados e usuários/ Consulta de detalhes sobre usuários do banco de dados

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

Ver PDF

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.