修改指定实例的参数

功能介绍

修改指定实例的参数模板参数。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

• 修改的参数必须在指定数据库版本的默认参数范围内，具体可配置范围请参见《关系型数据库用户指南》中“编辑参数模板”的内容。

URI

• URI格式

  PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/configurations

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	实例ID。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	说明
  values	是	Map<String,String>	参数值对象，用户基于默认参数模板自定义的参数值。 详情请参见表3。

  表3 values字段数据结构说明

  名称	是否必选	参数类型	说明
  key	是	String	参数名称，以参数名称作为key，如"max_connections":"10"。
  value	是	String	参数值，以参数对应的值作为value，如"max_connections":"10"。

• 请求样例

  { 
      "values": { 
         "xxx": "10", 
         "yyy": "OFF" 
      }
  }

响应消息

• 正常响应要素说明

  表4 要素说明

  名称	参数类型	说明
  restart_required	Boolean	实例是否需要重启。 “true”需要重启。 “false”不需要重启。

• 正常响应样例

  {
    "restart_required": false
  }

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。