调用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 | 模板的名称。
|
Engine | String | 是 | mysql | 数据库引擎,取值:
|
EngineVersion | String | 是 | 5.7 | 数据库版本,取值:
|
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个字符。 |
访问错误中心查看更多错误码。