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 base de datos especificada.

• Antes de invocar a una API, debe entender la API de Autenticación.

Restricciones

• Esta operación no se puede realizar cuando la instancia de base de datos se encuentra en cualquiera de los siguientes estados: creación, cambio de clase de instancia, cambio de puerto, congelado, o anormal.
• Si desea invocar a esta API repetidamente para crear cuentas de base de datos para su instancia de base de datos, invóquela en serie.
• Para cualquier base de datos y cuenta creada con métodos distintos de la consola RDS y las API, si el nombre de la base de datos y el nombre de la cuenta no cumplen con las reglas de nomenclatura de la base de datos (consulte Tabla 2) y reglas de nomenclatura de cuentas (consulte Tabla 2), y por ejemplo, que contienen caracteres chinos o caracteres especiales no admitidos, la base de datos y la cuenta no se pueden gestionar a través de la consola de RDS o las API.
• En escenarios de migración, si el nombre de la base de datos y el nombre de cuenta de la base de datos de origen no cumplen las reglas de nomenclatura de la base de datos (consulte Tabla 2) y las reglas de nomenclatura de cuentas (consulte Tabla 2), la base de datos y la cuenta no se pueden gestionar a través de la consola de RDS o las API después de migrar a la base de datos de RDS for MySQL de destino.

URI

• Formato de URI

  POST /v3/{project_id}/instances/{instance_id}/db_user

• Descripción de parámetro

  Tabla 1 Descripción de parámetro

  Nombre	Obligatorio	Descripción
  project_id	Sí	Especifica el ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
  instance_id	Sí	Especifica el ID de instancia de base de datos.

Solicitud

• Descripción de parámetro

  Tabla 2 Descripción de parámetro

  Nombre	Obligatorio	Tipo	Descripción
  name	Sí	String	Especifica el nombre de usuario de la cuenta de base de datos. El nombre de usuario consta de 1 a 32 caracteres. Solo se permiten minúsculas, dígitos, guiones (-) y guiones bajos (_). Si la versión de la base de datos es MySQL 5.6, el nombre de usuario consta de 1 a 16 caracteres. Si la versión de la base de datos es MySQL 5.7 o 8.0, el nombre de usuario consta de 1 a 32 caracteres.
  password	Sí	String	Especifica la contraseña de la cuenta de base de datos. Valores válidos: El parámetro debe tener entre 8 y 32 caracteres y contener solo letras (sensible a mayúsculas y minúsculas), dígitos y caracteres especiales (~!@#$%^*-_=+?,()&). El valor debe ser diferente del name o name escrito al revés. Se recomienda introducir una contraseña segura para mejorar la seguridad, evitando riesgos de seguridad como el agrietamiento por fuerza bruta.
  comment	No	String	Especifica los comentarios de la cuenta de base de datos. El parámetro debe tener entre 1 y 512 caracteres y solo es compatible con MySQL 8.0.25 y versiones posteriores.
  hosts	No	Array of strings	Direcciones IP que tienen permitido acceder a su instancia de base de datos. Si la dirección IP está establecida en %, todas las direcciones IP pueden acceder a su instancia. Si la dirección IP está establecida en 10.10.10.%, todas las direcciones IP de la subred 10.10.10.X pueden acceder a su instancia. Se pueden agregar varias direcciones IP.
  databases	No	Array of objects	Bases de datos que puede iniciar sesión con la cuenta. Para obtener más información, consulte Tabla 3.

  Tabla 3 descripción de la estructura del elemento de bases de datos

  Parámetro	Obligatorio	Tipo	Descripción
  name	Sí	String	Nombre de la base de datos.
  readonly	No	Boolean	Si la base de datos es de sólo lectura. true: indica que la base de datos es de solo lectura. false: indica que la base de datos es legible y escribible.

Solicitud de ejemplo

Creación de una cuenta de base de datos denominada rds

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db_user

{
    "name": "rds",
    "password": "************",
    "comment": "mysql",
    "hosts": [
        "%"  
    ],
    "databases" : [
       {
           "name" : "***",
            "readonly" : false
       }
    ]
}

Respuesta

• Respuesta normal

  Tabla 4 Descripción de parámetro

  Nombre	Tipo	Descripción
  resp	String	Devuelve successful si la invocación es correcta.

• Ejemplo de respuesta normal

  {
      "resp": "successful"
  }

• Respuesta anormal

  Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

• normal

  202

• Anormal

  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.