Autorización de una cuenta de base de datos

Función

Esta API se utiliza para establecer permisos de una cuenta de base de datos en 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.

• 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_privilege

• 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
  db_name	Sí	String	Especifica el nombre de la base de datos.
  users	Sí	Array of objects	Especifica la cuenta asociada a la base de datos. Una sola solicitud admite un máximo de 50 elementos. Para obtener más información sobre la estructura del elemento, consulte Tabla 3.

  Tabla 3 descripción de la estructura de datos de campo de usuarios

  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.
  readonly	Sí	Boolean	Especifica el permiso de sólo lectura. true: indica el permiso de solo lectura. false: indica el permiso de lectura y escritura.

Solicitud de ejemplo

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

{
    "db_name": "rds-test",
    "users": [
        {
            "name": "rds",
            "readonly": false
        },
        {
            "name": "rds001",
            "readonly": true
        }
    ]
}

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

  200

• 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.