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

Función

Esta API se utiliza para modificar los comentarios de 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

• 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 asociada.
  • 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 asociada no existe o se elimina al crear 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 consultando Actualización de una versión secundaria.
  • RDS for MySQL 5.6: No soportado.
  • RDS for MySQL 5.7: No soportado.
  • RDS for MySQL 8.0: 8.0.25 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

  PUT /v3/{project_id}/instances/{instance_id}/db-users/{user_name}/comment

• Descripción de parámetro

  Tabla 1 Parámetros

  Parámetro	Obligatorio	Descripción
  project_id	Sí	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í	ID de instancia.
  user_name	Sí	Nombre de usuario de base de datos.

Solicitud

• Descripción de parámetro

  Tabla 2 Parámetros

  Parámetro	Obligatorio	Tipo	Descripción
  comment	No	String	Observaciones del nombre de usuario de la base de datos. Rango de valores: 1 a 512 caracteres.

Solicitud de ejemplo

Modificación de las observaciones de usuario root para una instancia de base de datos

PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db-users/root/comment

{
    "comment": "this is a comment"
}

Response

• Normal response

  Tabla 3 Parameters

  Parameter	Type	Description
  resp	String	Returns successful if the invoking is successful.

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