Modificación de una plantilla de parámetro

Función

Esta API se utiliza para modificar una plantilla de parámetros especificada, incluidos el nombre, la descripción y los valores de los parámetros especificados en la plantilla de parámetros.

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

• El nombre de la nueva plantilla de parámetros debe ser diferente del nombre de una plantilla de parámetros existente o predeterminada. Las plantillas de parámetros predeterminadas no se pueden modificar.
• 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.
• Los valores de los parámetros que se van a cambiar no se pueden dejar en blanco al mismo tiempo.

URI

• Formato de URI

  PUT /v3/{project_id}/configurations/{config_id}

• 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.
  config_id	Sí	Especifica el ID de plantilla de parámetro.

Solicitud

• Descripción de parámetro
  

  Debe especificarse al menos un parámetro en el cuerpo de la solicitud. De lo contrario, la solicitud no se entrega.

  Tabla 2 Descripción de parámetro

  Nombre	Obligatorio	Tipo	Descripción
  name	No	String	Especifica el nombre de la plantilla de parámetro. Contiene un máximo de 64 caracteres y puede contener solo letras mayúsculas, minúsculas, dígitos, guiones (-), guiones bajos (_), y puntos (.).
  description	No	String	Especifica la descripción de la plantilla de parámetro. Contiene un máximo de 256 caracteres y no admite los siguientes caracteres especiales: !<>='&" Su valor se deja en blanco por defecto.
  values	No	Map<String,String>	Especifica los valores de parámetros definidos por los usuarios en función de las plantillas de parámetros predeterminadas. Si no se especifica este parámetro, no se cambiará ningún valor de parámetro. 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

Modificación de parámetros en una plantilla de parámetros

PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations/463b4b58-d0e8-4e2b-9560-5dea4552fde9

{ 
    "name": "configuration_test", 
    "description": "configuration_test", 
    "values": { 
       "div_precision_increment": "6",
       "connect_timeout": "20"
    } 
}

Respuesta

• Respuesta normal

  Tabla 3 Parámetros

  Parámetro	Tipo	Descripción
  configuration	Object	Información de la plantilla de parámetros. Para obtener más información, consulte Tabla 4.

  Tabla 4 descripción de la estructura de datos del campo de configuración

  Parámetro	Tipo	Descripción
  id	String	ID de plantilla de parámetro.
  name	String	Nombre de la plantilla del parámetro.
  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

  {
      "configuration": {
          "id": "463b4b58-d0e8-4e2b-9560-5dea4552fde9",
          "name": "configuration_test",
          "ignored_params": {}
      }
  }

• Respuesta anormal

  Para obtener más información, véase 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.