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

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

说明 当前仅支持MySQL和PostgreSQL实例。

调试

您可以在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
  • PostgreSQL
EngineVersion String 5.7

数据库版本,取值:

  • MySQL:
    • 5.6
    • 5.7
    • 8.0
  • PostgreSQL:
    • 10.0
    • 11.0
    • 12.0
    • 13.0
    • 14.0
    • 15.0
Parameters String {"back_log":"3000","wait_timeout":"86400"}

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

ParameterGroupDesc String test

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

返回数据

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

参数模板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>
    <ParameterGroupId>rpg-q488w14xvsk****</ParameterGroupId>
    <RequestId>7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1</RequestId>
</CreateParameterGroupResponse>

JSON格式

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

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

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameters.Malformed The specified parameter "Parameters" is not valid. 当前Parameters参数无效,请重新设置。
400 ParamGroupsNameInvalid The specified parameter group name is invalid. 参数模板名称格式不正确,格式要求:以英文字母开头,由英文字母、数字、小数点(.)或下划线(_)组成,长度为8~64个字符。
400 InvalidEngine.Malformed Specified engine is not valid. 当前数据库引擎无效,请选择正确的数据库引擎。
400 InvalidEngineVersion.Malformed Specified engine version is not valid. 数据库引擎版本无效,请确认后重试。
400 ParamGroupsDbTypeNotSupport The parameter group does not support the specified database type. 参数模板当前仅支持MySQL实例。
400 ParamGroupsDbVersionNotSupport The parameter group does not support the database version. 参数模板当前仅支持5.6、5.7、8.0版本的MySQL实例。
400 ParamNotExist This param Not Exist 参数不存在,请检查 Parameters 参数配置。
400 ParamTypeError The parameter type error. 参数类型错误
400 ParamGroupsNotExistOrTypeNotSupport The parameter group does not exist or its type is not supported. 参数模板不存在或参数模板类型不支持
400 InvalidRegion.Format Specified Region is not valid. 指定的地域不合法,请检查该参数的正确性。
400 InvalidParameters.Format Specified parameter is not valid 操作失败,指定的参数格式不合法。
400 ParamGroupsDescInvalid The maximum length of parameter group description is exceeded. 参数模板描述长度应为0~200个字符。

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