Creates a parameter template.

You can batch configure parameters in a parameter template and then apply it to your ApsaraDB for RDS instance. For more information, see Operate parameter templates.

Note This API operation is only available to ApsaraDB for RDS instances running MySQL.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateParameterGroup

The operation that you want to perform. Set the value to CreateParameterGroup.

RegionId String Yes cn-hangzhou

The region ID of the parameter template. You can call the DescribeRegions operation to query the most recent region list.

ParameterGroupName String Yes test1234

The name of the parameter template.

  • The name must be 8 to 64 characters in length. The name must start with a letter and can contain letters, digits, dots (.),
  • and underscores (_).
Engine String Yes mysql

The database engine with which the parameter template is used. Set the value to mysql.

EngineVersion String Yes 5.7

The database engine version with which the parameter template is used. Valid values:

  • 5.6
  • 5.7
  • 8.0
Parameters String Yes {"back_log":"3000","wait_timeout":"86400"}

A JSON string that consists of parameters and their values to be included in the parameter template. Format: {"Parameter 1":"Value of Parameter 1","Parameter 2":"Value of Parameter 2 "......}. For more information about configurable parameters, see Reconfigure parameters for an RDS for MySQL instance.

AccessKeyId String No LTAIfCxxxxxxx

The AccessKey ID provided to you by Alibaba Cloud.

ParameterGroupDesc String No test

The description of the parameter template. The description can be up to 200 characters in length.

Response parameters

Parameter Type Example Description
RequestId String 7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1

The ID of the request.

Examples

Sample requests


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>

Sample success responses

XML format

<CreateParameterGroupResponse>
  <RequestId>7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1</RequestId>
</CreateParameterGroupResponse>

JSON format

{
	"RequestId":"7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1"
}

Error codes

For a list of error codes, visit the API Error Center.