文档中心

云数据库 MySQL 版

请输入

参数管理

ModifyDBInstanceParameters - 修改实例参数

调用 ModifyDBInstanceParameters 接口修改实例参数。

请求类型

异步请求。

注意事项

若修改 innodb_buffer_pool_size 参数，系统会对 ParamApplyScope 参数中设置的节点逐一校验其取值是否符合取值范围要求；若任一节点校验失败，则本次请求将被同步拒绝，且不会创建后续任务。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-h441603c****	实例 ID。
Parameters	Array of ParametersObject	是	无	参数值对象，用户基于默认参数模板自定义的参数值。
TemplateId	String	否	mysql-411668b4ab18****	通过参数模板修改实例的参数时，使用的参数模板的 ID。说明需使用和实例的引擎版本相同的参数模板。如传入了该字段，则参数设定以该字段指定的参数模板中的参数设定为准，忽略 Parameters 字段中的参数设定。通过参数模板修改实例的参数，可为 Parameters 字段传入空数组。
ParamApplyScope	String	否	AllNode	指定参数修改的应用范围。取值： AllNode：所有节点。默认值。 OnlyMasterSlaveNode：仅主节点和备节点。 OnlyReadOnlyNode：所有只读节点。 CustomNode：指定的只读节点。说明该参数仅在实例类型为双节点时生效。若不传该参数，默认取值为 AllNode。取值为 OnlyReadOnlyNode 或 CustomNode 时，实例需存在只读节点。若所修改的参数需要在全部节点生效，则该参数不能取非 AllNode的值。
CustomNodeIds	Array of String	否	["mysql-c7a79d83****-r417e"]	需要应用参数修改的只读节点的 ID。说明该参数仅在 ParamApplyScope 参数取值为 CustomNode 时生效，此时该参数必须非空。取值需为当前实例下有效的只读节点 ID。

ParametersObject

返回参数

null

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.10.16 15:31:04

这个页面对您有帮助吗？

有用

无用