Modifique una plantilla de parámetros - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación ModifyParameterGroup para modificar una plantilla de parámetros en ApsaraDB RDS.

Mediante una plantilla de parámetros, puede configurar varios parámetros simultáneamente y luego aplicar dicha plantilla a las instancias. Para obtener más información, consulte Usar una plantilla de parámetros para configurar los parámetros de instancias de ApsaraDB RDS for MySQL o Usar una plantilla de parámetros para configurar los parámetros de instancias de ApsaraDB RDS for PostgreSQL.

Nota

Las plantillas de parámetros solo se pueden aplicar a instancias de ApsaraDB RDS for MySQL y de ApsaraDB RDS for PostgreSQL.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyParameterGroup	La operación que desea ejecutar. Establezca el valor en ModifyParameterGroup.
ParameterGroupId	String	Sí	rpg-13ppdh****	El ID de la plantilla de parámetros. Puede llamar a la operación DescribeParameterGroups para consultar los ID de las plantillas de parámetros.
ParameterGroupName	String	No	testgroup1	El nombre de la plantilla de parámetros. El nombre puede contener letras, dígitos, puntos (.) y guiones bajos (_), y debe comenzar con una letra. El nombre debe tener entre 8 y 64 caracteres. Nota Si no especifica este parámetro, se conserva el nombre original de la plantilla de parámetros.
ParameterGroupDesc	String	No	test	La descripción de la plantilla de parámetros. La descripción puede tener hasta 200 caracteres. Nota Si no especifica este parámetro, se conserva la descripción original de la plantilla de parámetros.
Parameters	String	No	{"back_log":"3000"}	Cadena JSON con los parámetros y sus valores para modificar en la plantilla de parámetros. Formato: {"Parámetro 1":"Valor del parámetro 1","Parámetro 2":"Valor del parámetro 2 "......}. Para obtener más información sobre los parámetros modificables, consulte Modificar los parámetros de una instancia de ApsaraDB RDS for MySQL o Modificar los parámetros de una instancia de ApsaraDB RDS for PostgreSQL. Nota Si establece el parámetro ModifyMode en Individual y especifica este parámetro, los nuevos parámetros sobrescriben los de la plantilla original. Si establece el parámetro ModifyMode en Collectivity y especifica este parámetro, los nuevos parámetros se agregan a la plantilla original o se modifican los existentes. Si no especifica este parámetro, los parámetros de la plantilla original permanecen sin cambios.
RegionId	String	Sí	cn-hangzhou	El ID de la región. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente. Nota La región de una plantilla de parámetros no se puede cambiar. Puede llamar a la operación CloneParameterGroup para replicar una plantilla de parámetros en una región específica.
ModifyMode	String	No	Collectivity	El modo de modificación de la plantilla de parámetros. Valores válidos: Collectivity: agrega nuevos parámetros o modifica los de la plantilla original. Este es el valor predeterminado. Nota Si establece el parámetro ModifyMode en Collectivity, el sistema agrega el valor del parámetro Parameters a la plantilla original o modifica los parámetros correspondientes. Los demás parámetros de la plantilla original no se ven afectados. Individual: sobrescribe los parámetros originales. Nota Si establece el parámetro ModifyMode en Individual, el sistema utiliza el valor del parámetro Parameters para sobrescribir la configuración de la plantilla original.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
ParameterGroupId	String	rpg-13ppdh****	El ID de la plantilla de parámetros.
RequestId	String	857DC00B-7B85-4853-8B27-AD65EB618BC6	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=ModifyParameterGroup
&ParameterGroupId=rpg-13ppdh****
&Parameters={"back_log":"3000"}
&ModifyMode=Collectivity
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyParameterGroupResponse>
    <ParameterGroupId>rpg-13ppdh****</ParameterGroupId>
    <RequestId>857DC00B-7B85-4853-8B27-AD65EB618BC6</RequestId>
</ModifyParameterGroupResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ParameterGroupId" : "rpg-13ppdh****",
  "RequestId" : "857DC00B-7B85-4853-8B27-AD65EB618BC6"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	ParamGroupsNameInvalid	The parameter group name is invalid.	Mensaje de error devuelto cuando el nombre de la plantilla de parámetros no es válido. El nombre debe tener entre 8 y 64 caracteres y puede contener letras, dígitos, puntos (.) y guiones bajos (_). Debe comenzar con una letra.

Para obtener una lista de códigos de error, visite el Centro de errores de API.