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/TaurusDB/Referencia de la API/Las API (recomendadas)/HTAP (Edición estándar)/Consulta de cuentas de base de datos
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Consulta de cuentas de base de datos

Función

Esta API se utiliza para consultar cuentas de base de datos de una instancia de StarRocks. Antes de invocar a esta API:

URI

GET /v3/{project_id}/instances/{instance_id}/starrocks/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 de StarRocks, que es compatible con el formato UUID.

Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

user_name

No

String

Cuenta de base de datos.

limit

Sí

Integer

Número de registros que se van a consultar. El valor no puede ser un número negativo. El valor mínimo es de 1 y el valor máximo es de 100.

offset

Sí

Integer

Desplazamiento de índice. Si offset se establece en N, la consulta de recursos comienza desde el dato N+1. Si el valor está establecido en 0, indica que la consulta comienza desde el primer dato. El valor debe ser un número pero no puede ser un número negativo.

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.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:

  • en-us
  • zh-cn

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

user_details

Array of user_details objects

Información de cuenta de base de datos.

total_count

Integer

Número de cuentas de base de datos.

Tabla 5 user_details

Parámetro

Tipo

Descripción

user_name

String

Nombre de usuario de la cuenta de base de datos.

data_bases

Array of strings

Bases de datos autorizadas.

dml

Integer

Permisos de DML.

  • 0: permisos de lectura/escritura
  • 1: permisos de solo lectura
  • 2: permisos de solo lectura y de configuración
  • 3: permisos de lectura/escritura y de configuración

ddl

Integer

Si se conceden permisos de DDL.

  • 0: No
  • 1: Sí

Código de estado: 400

Tabla 6 Parámetros del cuerpo 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 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Consulta de 10 cuentas de base de datos

GET https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/instances/54e42160670e48e789af7075e1efea1fin16/starrocks/users?limit=10

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "user_details" : [ {
    "user_name" : "root",
    "databases" : [ "*" ],
    "dml" : 2,
    "ddl" : 0
  }, {
    "user_name" : "user_test",
    "databases" : [ "*" ],
    "dml" : 2,
    "ddl" : 0
  } ],
  "total_count" : 2
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.