Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Document Database Service/ Referencia de la API/ APIs V3.0 (recomendado)/ Gestión de bases de datos y usuarios/ Consulta de detalles acerca de los usuarios de la base de datos

Actualización más reciente 2022-11-07 GMT+08:00

Consulta de detalles acerca de los usuarios de la base de datos

Función

Esta API se utiliza para consultar detalles sobre los usuarios de la base de datos.

Restricciones

Esta API solo se aplica a DDS Edición de Comunidad.
Esta operación no está permitida si la instancia de base de datos se encuentra en cualquiera de los siguientes estados: creación, cambio de clase de instancia, cambio de puerto, reinicio o anormal.

Depuración

Puede depurar esta API en API Explorer.

URI

Formato 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}
Ejemplo
- Consulta de la lista de todos los usuarios:
  https://dds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/3527b6b16e7639b88930a360d2c4in02/db-user/detail
- Consulta de la lista de usuarios en función de las condiciones 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

Descripción del parámetro

Nombre	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica la ID de proyecto de un inquilino en una región.
instance_id	Sí	String	Especifica la ID de instancia, que se puede obtener llamando a la API para consultar instancias. Si no tiene una instancia, puede llamar a API utilizada para crear una instancia.
user_name	No	String	Especifica el nombre de usuario. El valor debe tener de 1 a 64 caracteres y solo puede contener letras (de A a Z o de a a z), dígitos (de 0 a 9), guiones (-) y puntos (.).
db_name	No	String	Especifica el nombre de la base de datos donde se encuentra el usuario. El valor predeterminado es "admin". El valor debe tener entre 1 y 64 caracteres y solo puede contener letras (de A a Z o de a a z), dígitos (de 0 a 9) y guiones bajos (_).
offset	No	Integer	Especifica la posición del índice. El valor debe ser superior o igual a 0. Si este parámetro no se transfiere, el valor es 0 de forma predeterminada.
limit	No	Integer	Especifica el límite superior del número de registros consultados. El valor está entre 1 y 100. Si este parámetro no se transfiere, las primeras 100 instancias de base de datos se consultan de forma predeterminada.

Solicitudes

Ninguna

Respuestas

Descripción del parámetro

**Tabla 1** Descripción del parámetro
Nombre	Tipo	Descripción
users	String	Indica la información sobre los usuarios de la base de datos. ATENCIÓN: El valor devuelto está en el formato nativo de la base de datos y debe ser analizado por el usuario.
total_count	Integer	Indica el número total de usuarios de la base de datos.

Ejemplo de respuesta

{
  "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\"}]"
}