调用ModifyParameter接口修改RDS实例参数。

您可以直接修改RDS实例的参数值,也可以通过参数模板修改。提交修改请求后,RDS将下发任务,将新修改的参数应用到实例,如果所提交的参数中有需要重启数据库的,RDS将重启数据库。可以修改的参数请参见使用控制台设置参数

说明 RDS会在执行任务前检查参数是否存在、是否可修改以及是否合法。

调试

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

请求参数

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

系统规定参数,取值:ModifyParameter

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

Parameters String {"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}

参数及其值的JSON串,参数的值都是字符串类型。格式:{"参数名称1":"参数值1","参数名称2":"参数值2"...}

说明 传入该参数,则无需传入参数ParameterGroupId
ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

Forcerestart Boolean false

修改参数是否重启数据库,取值:

  • true:强制重启(若修改的参数当中,有需要重启的参数,则必须传入true,否则修改将不生效)。
  • false:不强制重启。

默认值:false

ParameterGroupId String rpg-xxxxxxxxx

参数模板ID。

说明
  • 传入该参数,则无需传入参数Parameters
  • 如果应用参数模板需要重启实例,需要传入参数Forcerestart

返回数据

名称 类型 示例值 描述
RequestId String 542BB8D6-4268-45CC-A557-B03EFD7AB30A

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=ModifyParameter
&DBInstanceId=rm-uf6wjk5xxxxxxx
&Parameters={"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}
&<公共请求参数>

正常返回示例

XML 格式

<ModifyParameterResponse>
         <RequestId>542BB8D6-4268-45CC-A557-B03EFD7AB30A</RequestId>
</ModifyParameterResponse>

JSON 格式

{
       "RequestId":"542BB8D6-4268-45CC-A557-B03EFD7AB30A"
}

错误码

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