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

Puede llamar a la operación CreateParameterGroup para crear una plantilla de parámetros.

Con una plantilla de parámetros, puede configurar varios parámetros simultáneamente y luego aplicar dicha plantilla a una instancia. 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 y 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 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í	CreateParameterGroup	La operación que desea ejecutar. Establezca el valor en CreateParameterGroup.
RegionId	String	Sí	cn-hangzhou	El ID de región de la plantilla de parámetros. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ParameterGroupName	String	Sí	test1234	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.
Engine	String	Sí	mysql	El motor de base de datos. Valores válidos: mysql PostgreSQL
EngineVersion	String	Sí	5.7	La versión del motor de base de datos que ejecuta la instancia. Valores válidos: Si la instancia ejecuta MySQL, debe usar una de las siguientes versiones: 5.6 5.7 8.0 Si la instancia ejecuta PostgreSQL, debe usar una de las siguientes versiones: 10.0 11.0 12.0 13.0 14.0 15.0
Parameters	String	Sí	{"back_log":"3000","wait_timeout":"86400"}	Una cadena JSON que contiene los parámetros y sus valores 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.
ParameterGroupDesc	String	No	test	La descripción de la plantilla de parámetros. La longitud máxima es de 200 caracteres.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
ParameterGroupId	String	rpg-q488w14xvsk****	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.
RequestId	String	7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=CreateParameterGroup
&RegionId=cn-hangzhou
&ParameterGroupName=test1234
&Engine=mysql
&EngineVersion=5.7
&Parameters={"back_log":"3000","wait_timeout":"86400"}
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<CreateParameterGroupResponse>
    <ParameterGroupId>rpg-q488w14xvsk****</ParameterGroupId>
    <RequestId>7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1</RequestId>
</CreateParameterGroupResponse>

Formato JSON

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

{
  "ParameterGroupId" : "rpg-q488w14xvsk****",
  "RequestId" : "7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameters.Malformed	The specified parameter "Parameters" is not valid.	Error devuelto porque el valor del parámetro Parameters no es válido. Especifique un valor válido.
400	ParamGroupsNameInvalid	The specified parameter group name is invalid.	Error devuelto porque 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.
400	InvalidEngine.Malformed	Specified engine is not valid.	Error devuelto porque el motor de base de datos no es válido. Especifique un motor de base de datos válido.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	Error devuelto porque la versión del motor de base de datos especificada no es válida. Compruebe la versión del motor de base de datos e inténtelo de nuevo.
400	ParamGroupsDbTypeNotSupport	The parameter group does not support the specified database type.	Error devuelto porque la plantilla de parámetros solo es compatible con instancias que ejecutan MySQL.
400	ParamGroupsDbVersionNotSupport	The parameter group does not support the database version.	Error devuelto porque la plantilla de parámetros solo es compatible con instancias que ejecutan MySQL 5.6, MySQL 5.7 o MySQL 8.0.
400	ParamNotExist	This param Not Exist	Error devuelto porque el parámetro no existe. Compruebe la configuración del parámetro Parameters.
400	ParamTypeError	The parameter type error.	Error devuelto porque el tipo de parámetro no es válido.
400	ParamGroupsNotExistOrTypeNotSupport	The parameter group does not exist or its type is not supported.	Error devuelto porque la plantilla de parámetros no existe o su tipo no es compatible.
400	InvalidRegion.Format	Specified Region is not valid.	Error devuelto porque la región especificada no es válida.
400	InvalidParameters.Format	Specified parameter is not valid	Error devuelto porque el formato de un parámetro especificado no es válido.
400	ParamGroupsDescInvalid	The maximum length of parameter group description is exceeded.	Error devuelto porque la descripción de la plantilla de parámetros supera los 200 caracteres.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.