调用CreateParameterGroup接口创建RDS参数模板。

参数模板可以批量管理实例的参数,您可以使用参数模板功能,快速应用模板到实例上。详情请参见使用参数模板

说明 当前仅支持MySQL实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateParameterGroup

系统规定参数。取值:CreateParameterGroup

RegionId String cn-hangzhou

创建参数模板的地域ID。可以通过接口DescribeRegions查看地域ID。

ParameterGroupName String test1234

模板的名称。

  • 以英文字母开头,由英文字母、数字、小数点(.)或下划线(_)组成。
  • 长度为8~64个字符。
Engine String mysql

数据库引擎,取值:mysql

EngineVersion String 5.7

数据库版本,取值:

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

参数和值的JSON串,格式:{"参数1":"参数1值","参数2":"参数2值"......}。可修改的参数请参见设置实例参数

ParameterGroupDesc String test

参数模板的描述。长度为0~200个字符。

返回数据

名称 类型 示例值 描述
ParameterGroupId String rpg-q488w14xvsk3o6un

参数模板ID。可以通过接口DescribeParameterGroups查看参数模板ID。

RequestId String 7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1

请求ID。

示例

请求示例

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

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

HttpCode 错误码 错误信息 描述
400 ParamGroupsNameInvalid The parameter group name is invalid. 参数模板名称格式不正确,格式要求:以英文字母开头,由英文字母、数字、小数点(.)或下划线(_)组成,长度为8~64个字符。
400 ParamGroupsNameInvalid The specified parameter group name is invalid. 参数模板名称格式不正确,格式要求:以英文字母开头,由英文字母、数字、小数点(.)或下划线(_)组成,长度为8~64个字符。

访问错误中心查看更多错误码。