更新时间:2026-05-15 GMT+08:00
分享

修改实例参数

功能介绍

修改DDM实例参数。

接口约束

修改的参数必须在控制台“参数管理”页面内,具体可配置范围请参见《分布式数据库中间件DDM 用户指南》中“修改DDM实例参数”的内容。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

PUT /v3.1/{project_id}/instances/{instance_id}/configurations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。

获取方法请参见获取项目ID

instance_id

String

DDM实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务的“获取用户Token”接口来获取。

表3 请求Body参数

参数

是否必选

参数类型

描述

values

Map<String,String>

参数值对象,用户基于默认参数模板自定义的参数值。

  • key:参数名称。为空时不修改该参数值。
  • value:参数值。

请求示例

修改慢查询的参数值为2,表示如果SQL执行大于等于2秒就定义为慢SQL。

PUT https://{endpoint}/v3.1/{project_id}/instances/{instance_id}/configurations

{
  "values" : {
    "long_query_time" : "2"
  }
}

响应消息

  • 正常响应参数说明
    表4 响应Body参数

    参数

    参数类型

    描述

    need_restart

    Boolean

    是否需要重启实例。

  • 正常响应示例
    {
      "need_restart": false
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码

相关文档