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:
- Aprender cómo autorizar y autenticarla.
- Obtenga la región y el punto de conexión requeridos.
URI
GET /v3/{project_id}/instances/{instance_id}/starrocks/users
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. |
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
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:
|
Parámetros de respuesta
Código de estado: 200
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. |
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.
|
ddl |
Integer |
Si se conceden permisos de DDL.
|
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
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.