Creación de una cuenta de base de datos
Función
Esta API se utiliza para crear una cuenta de base de datos para 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
POST /v3/{project_id}/instances/{instance_id}/db-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. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
X-Auth-Token |
Sí |
String |
Token de usuario. |
X-Language |
No |
String |
Idioma. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
users |
Sí |
Array of CreateDatabaseUserList objects |
Lista de usuarios de la base de datos. La lista contiene hasta 50 usuarios de base de datos. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
name |
Sí |
String |
Nombre de usuario de base de datos. El valor puede contener de 1 a 32 caracteres, incluidos letras, dígitos y guiones bajos (_). |
password |
Sí |
String |
Contraseña del usuario de la base de datos. El valor puede constar de 8 a 32 caracteres y contener al menos tres tipos de los siguientes caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales (~!@#$%^*-_=+?,()&). Se recomienda introducir una contraseña segura para mejorar la seguridad y evitar riesgos de seguridad, como el agrietamiento por fuerza bruta. |
hosts |
No |
Array of strings |
Dirección IP del host. El valor predeterminado es %, que indica que todas las direcciones IP pueden acceder a su instancia de GaussDB(for MySQL). Si su valor es de 10.10.10. %, todos 10.10.10. Las direcciones IP de X pueden acceder a su instancia de GaussDB(for MySQL). Puede agregar hasta 50 direcciones IP y separarlas con comas (,), por ejemplo, 192.168.0.1,172.16.213.9 (sin espacios antes y después de la coma). |
databases |
No |
Array of CreateDatabaseList objects |
Lista de las bases de datos. La lista contiene hasta 50 bases de datos. Cuando crea un usuario de base de datos, puede autorizar al usuario los permisos de las bases de datos de la lista. Si no hay ninguna base de datos en la lista, puede invocar una API para autorizar permisos de base de datos para el usuario de la base de datos. |
Parámetros de respuesta
Código de estado: 201
Parámetro |
Tipo |
Descripción |
|---|---|---|
job_id |
String |
ID de la tarea para crear una cuenta de base de datos. |
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. |
Solicitud de ejemplo
Creación de una cuenta de base de datos
POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users
{
"users" : [ {
"name" : "gaussdb_mysql_user1",
"password" : "Rds_1234",
"hosts" : [ "127.0.0.1" ],
"databases" : [ {
"name" : "test",
"readonly" : false
} ]
} ]
}
Ejemplo de respuesta
Código de estado: 201
Success.
{
"job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
}
Código de estado
Para obtener más información, consulte Códigos de estado.
Código de error
Para obtener más información, consulte Códigos de error.
