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/ GaussDB(for MySQL)/ Referencia de la API/ Las API (recomendadas)/ Gestión de usuarios de bases de datos/ Consulta de usuarios de base de datos

Actualización más reciente 2023-12-14 GMT+08:00

Ver PDF

Consulta de usuarios de base de datos

Función

Esta API se utiliza para consultar a los usuarios de la base de datos de una instancia de GaussDB(for MySQL). Antes de invocar a esta API:

Aprender cómo autorizar y autenticarla.
Obtener los región y punto de conexión requeridos.

URI

GET /v3/{project_id}/instances/{instance_id}/db-users

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto.
instance_id	Sí	String	ID de instancia.

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
offset	No	Integer	Desplazamiento de índice. Si offset se establece en N, la consulta de recursos comienza desde el dato N+1. El valor es 0 de forma predeterminada, lo que indica que la consulta comienza desde el primer dato. El valor no puede ser un número negativo.
limit	No	Integer	Número de registros a consultar. El valor predeterminado es 100. El valor debe ser un número positivo entero. El valor mínimo es de 1 y el valor máximo de 100.

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario.
X-Language	No	String	Idioma.

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
users	Array of ListGaussMySqlDatabaseUser objects	Lista de usuarios de la base de datos.
total_count	Integer	Número total de usuarios de base de datos de una instancia de base de datos.

**Tabla 5** ListGaussMySqlDatabaseUser
Parámetro	Tipo	Descripción
name	String	Nombre de usuario de base de datos.
host	String	Dirección IP del host.
databases	Array of ListGaussMySqlDatabase objects	Lista de bases de datos.

**Tabla 6** ListGaussMySqlDatabase
Parámetro	Tipo	Descripción
name	String	Nombre de la base de datos.
readonly	Boolean	Si el permiso de la base de datos es de solo lectura. true: de solo lectura. false: de lectura/escritura.

Código de estado: 400

**Tabla 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 500

**Tabla 8** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Solicitud de ejemplo

Consulta de usuarios de base de datos

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users?offset=0&limit=100

Ejemplo de respuesta

Código de estado: 200

Success.

{
  "users" : [ {
    "name" : "gaussdb_mysql_user1",
    "host" : "127.0.0.1",
    "databases" : [ {
      "name" : "test",
      "readonly" : false
    } ]
  } ],
  "total_count" : 1
}