Modificación de las observaciones de la base de datos de una instancia de base de datos especificada

Función

Esta API se utiliza para modificar los comentarios de base de datos de una instancia de base de datos especificada.

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

Restricciones

• Para utilizar esta función, póngase en contacto con el servicio de atención al cliente para solicitar los permisos necesarios.
• 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.
• Esta operación se puede realizar sin importar si existe la base de datos.
  • Las observaciones se actualizarán o crearán cuando se realice esta operación, dependiendo de si las observaciones ya existen.
  • Las observaciones se eliminarán si su valor se cambia a una cadena vacía o nulo.
  • Si la base de datos no existe o se elimina cuando se crean comentarios, los comentarios se guardarán.

• Esta operación solo se admite para las versiones del núcleo especificadas. Si su versión del kernel no cumple con los requisitos, actualice el kernel a la última versión haciendo referencia a Actualización de versión secundaria.
  • RDS for MySQL 5.6: 5.6.51.3 o posterior.
  • RDS for MySQL 5.7: 5.7.33.1 o posterior.
  • RDS for MySQL 8.0: 8.0.25.1 o posterior.
• 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}/database/update

• 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 la base de datos.
  comment	No	String	Especifica las observaciones de la base de datos. El valor puede contener de 0 a 512 caracteres.

Solicitud de ejemplo

Modificación de las observaciones de base de datos de una instancia de base de datos

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

{
    "name": "rds",
    "comment": "this is a comment"
}

Respuesta

• Respuesta normal

  Tabla 3 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.