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)/ Gestión de usuarios de bases de datos/ Creación de una cuenta de base de datos
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

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 TaurusDB. Antes de invocar a esta API:

URI

POST /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, que es compatible con el formato UUID.

Parámetros de solicitud

Tabla 2 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
Tabla 3 Parámetro del cuerpo de la solicitud

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.
Tabla 4 CreateDatabaseUserList

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. No puede ser igual al nombre de usuario. El valor es obligatorio y debe contener entre 8 y 32 caracteres y contener al menos tres tipos de los siguientes: 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.

comment

No

String

Notas de la base de datos. El valor puede contener hasta 512 caracteres y no puede contener los caracteres de retorno de carro ni los siguientes caracteres especiales: !<"='>&

Este campo solo es adecuado para las instancias 2.0.13.0 o posteriores. Para actualizar una instancia a la versión más reciente, véase Actualización de la versión del kernel de una instancia de base de datos.

hosts

No

Array of strings

Dirección IP del host. El valor predeterminado es % e indica que todas las direcciones IP pueden acceder a su instancia de TaurusDB. Si la dirección IP se establece en 10.10.10.% todas las direcciones IP del 10.10.10.X de subred pueden acceder a su instancia de TaurusDB. 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. Al crear un usuario de base de datos, puede conceder los permisos de las bases de datos de la lista al usuario. Si no hay ninguna base de datos en la lista, puede invocar una API para conceder permisos de base de datos al usuario de la base de datos.
Tabla 5 CreateDatabaseList

Parámetro

Obligatorio

Tipo

Descripción

name

Sí

String

Nombre de la base de datos.

readonly

Sí

Boolean

Si el permiso es de solo lectura.

  • true: de solo lectura
  • false: de lectura/escritura

Parámetros de respuesta

Código de estado: 201

Tabla 6 Parámetros de body de respuesta

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

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.

Ejemplo de la solicitud

Creación de un usuario de base de datos con permiso de lectura/escritura (la dirección IP del host es 127.0.0.1.)

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users
{
  "users" : [ {
    "name" : "gaussdb_mysql_user1",
    "password" : "Rds_1234",
    "hosts" : [ "127.0.0.1" ],
    "comment" : "database_user_comment", 
    "databases" : [ {
      "name" : "test",
      "readonly" : false
    } ]
  } ]
}

Ejemplo de respuesta

Código de estado: 201

Operación exitosa.

{
  "job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
}

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.