Modificación de parámetros de una instancia especificada

Función

Esta API se utiliza para modificar parámetros de una instancia especificada.

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

Restricciones

• Se admiten los siguientes motores de base de datos: 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" en la Guía de usuario de 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 el ajuste de parámetros de RDS for MySQL en la Guía de usuario de Relational Database Service.

URI

• Formato de URI

  PUT https://{Endpoint}/v3.1/{project_id}/instances/{instance_id}/configurations

• Descripción de parámetro

  Tabla 1 Descripción de parámetro

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

Solicitud

• Parámetros de solicitud

  Tabla 2 Descripción del parámetro del cuerpo de solicitud

  Nombre	Obligatorio	Tipo	Descripción
  values	Sí	Map<String,String>	Valores de parámetros definidos por los usuarios basados en la plantilla de parámetros predeterminada. 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.

Solicitud de ejemplo

• Cambiar los valores de parámetros de una instancia de RDS for MySQL

  PUT https://{endpoint}/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/configurations
  
  {
    "values" : { 
      "div_precision_increment": "6",
      "connect_timeout": "20",
      "binlog_checksum" : "CRC32",
      "innodb_purge_threads" : "4"
    } 
  }

• Cambio de los valores de parámetro de una instancia de RDS for PostgreSQL

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

• Changing parameter values of an RDS for SQL Server instance

  {
     "values":{
       "max server memory (MB)":"26317",
       "max degree of parallelism":"4"
     }
  }

Respuesta

• Respuesta normal

  Tabla 3 Descripción de parámetro

  Nombre	Tipo	Descripción
  job_id	String	ID de trabajo.
  restart_required	Boolean	Si se requiere un reinicio. true: Se requiere un reinicio. false: No es necesario reiniciar.

• Ejemplo de respuesta normal

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

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