Modificación de parámetros de una instancia de base de datos especificada

Función

Esta API se utiliza para modificar parámetros en la plantilla de parámetros de una instancia de base de datos especificada.

Esta API no estará disponible el 31 de marzo de 2024. Se recomienda cambiar las cargas de trabajo a la nueva API (Modificación de parámetros de una instancia especificada) antes de esa fecha.

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

Restricciones

• Los siguientes motores de base de datos son compatibles: MySQL, PostgreSQL y Microsoft SQL Server.

• Los nuevos valores de parámetros deben estar dentro de los rangos predeterminados para las versiones del motor de base de datos especificadas. Para obtener más información, consulte "Modificación de parámetros de instancia" en la Guía de usuario del Relational Database Service.
• La modificación de parámetros sensibles, por ejemplo lower_case_table_names es arriesgada. Para obtener más información, consulte "Sugerencias sobre ajuste de parámetros de RDS for MySQL" en la Guía de usuario de Relational Database Service.

URI

• Formato de URI

  PUT /v3/{project_id}/instances/{instance_id}/configurations

• Ejemplo

  https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/configurations

• 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
  values	Sí	Map<String,String>	Especifica los valores de parámetros definidos por los usuarios en función de las plantillas de parámetros predeterminadas. key: nombre de parámetro, por ejemplo, div_precision_increment o connect_timeout. Si no se especifica este parámetro, no se cambiará ningún valor de parámetro. value: valor de parámetro, por ejemplo, 6 o 20. Si key no está vacío, el parámetro value tampoco puede estar vacío.

• Ejemplo de solicitud
• RDS for MySQL

  {
    "values" : { 
      "max_connections" : "10", 
      "autocommit" : "OFF",
      "binlog_checksum" : "CRC32",
      "innodb_purge_threads" : "4"
    } 
  }

• RDS for PostgreSQL

  {
    "values" : { 
      "max_connections" : "10", 
      "autovacuum" : "on",
      "bytea_output" : "escape",
      "client_encoding" : "UTF8",
      "cpu_tuple_cost" : "0.01"
    } 
  }

Respuesta

• Respuesta normal

  Tabla 3 Descripción de parámetro

  Nombre	Tipo	Descripción
  job_id	String	ID de tarea.
  restart_required	Boolean	Indica si se requiere un reinicio. true: Se requiere un reinicio. false: No es necesario reiniciar.
  ignored_params	List	Todos los parámetros que se ignoran y no se pueden modificar en el parámetro de solicitud values. Si no existe un parámetro, la modificación fallará. ignored_params devuelve los nombres de todos los parámetros ignorados.

• Ejemplo de respuesta normal

  { 
    "job_id" : "e7a7535b-eb9b-45ac-a83a-020dc5016d94",
    "restart_required" : "false",
    "ignored_params": []
  }

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