调用ModifyParameterGroup接口修改RDS参数模板。

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

说明 当前仅支持MySQL实例。

调试

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

请求参数

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

系统规定参数。取值:ModifyParameterGroup

ParameterGroupId String rpg-xxxxxxx

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

ParameterGroupName String testgroup1

参数模板名称。

  • 以英文字母开头,由英文字母、数字、小数点(.)或下划线(_)组成。
  • 长度为8~64个字符。
说明 不传入该参数,则保持原参数模板名称。
ParameterGroupDesc String test

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

说明 不传入该参数,则保持原参数模板描述。
Parameters String {"back_log":"3000"}

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

说明
  • 如果ModifyMode参数为Individual,则传入该参数会覆盖原来的参数模板。
  • 如果ModifyMode参数为collectivity,则传入该参数会在原有参数模板的基础上进行新增或更改。
  • 不传入该参数,则保持原参数信息。
RegionId String cn-hangzhou

地域ID。可以通过接口DescribeRegions查看地域ID。

说明 参数模板的地域不支持修改,您可以使用接口CloneParameterGroup复制参数模板到其他地域。
ModifyMode String collectivity

参数模板的修改模式。取值:

  • collectivity(默认值):新增或变更。
    说明parameters参数中传入的内容新增到当前参数模板,或变更当前参数模板中已有参数,当前参数模板中的其他参数不受影响。
  • Individual:覆盖。
    说明 将当前参数模板中的内容替换成parameters参数中传入的内容。

返回数据

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

参数模板ID。

RequestId String 857DC00B-7B85-4853-8B27-AD65EB618BC6

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=ModifyParameterGroup
&RegionId=cn-hangzhou
&ParameterGroupId=rpg-13ppdhxxxxxxx
&Parameters={"back_log":"3000"}
&<公共请求参数>

正常返回示例

XML格式

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

<ModifyParameterGroupResponse>
    <ParameterGroupId>rpg-13ppdh**********</ParameterGroupId>
    <RequestId>857DC00B-7B85-4853-8B27-AD65EB618BC6</RequestId>
</ModifyParameterGroupResponse>

JSON格式

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

{
  "ParameterGroupId" : "rpg-13ppdh**********",
  "RequestId" : "857DC00B-7B85-4853-8B27-AD65EB618BC6"
}

错误码

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

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