更新时间:2024-03-28 GMT+08:00

应用参数模板

功能介绍

将参数模板应用到实例,可以指定一个或多个实例。

该接口计划于2025-03-31下线,建议及时切换到新接口应用参数模板

接口约束

  • 支持的数据库引擎:MySQL、PostgreSQL、Microsoft SQL Server。

URI

  • URI格式

    PUT /v3/{project_id}/configurations/{config_id}/apply

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一region下的project ID。

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

    config_id

    参数模板ID。

请求消息

参数说明
表2 参数说明

名称

是否必选

参数类型

说明

instance_ids

Array of strings

实例ID列表对象。

请求样例

https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations/463b4b58-d0e8-4e2b-9560-5dea4552fde9/apply
{
	"instance_ids": ["73ea2bf70c73497f89ee0ad4ee008aa2in01", "fe5f5a07539c431181fc78220713aebein01"]
}

响应消息

  • 正常响应要素说明
    表3 要素说明

    名称

    参数类型

    说明

    configuration_id

    String

    参数模板ID。

    configuration_name

    String

    参数模板名称

    apply_results

    Array of objects

    参数模板应用具体结果。

    详情请参见表4

    success

    Boolean

    参数模板是否都应用成功。

    • “true”表示参数模板都应用成功。
    • “false”表示存在应用失败的参数模板。

    job_id

    String

    任务流ID。

    表4 apply_results字段数据结构说明

    名称

    参数类型

    说明

    instance_id

    String

    实例ID。

    instance_name

    String

    实例名称。

    restart_required

    Boolean

    实例是否需要重启。

    • “true”需要重启。
    • “false”不需要重启。

    success

    Boolean

    参数模板是否应用成功。

    • “true”表示应用成功。
    • “false”表示应用失败。
  • 正常响应样例
    {
    	"configuration_id": "cf49bbd7d2384878bc3808733c9e9d8bpr01",
    	"configuration_name": "paramsGroup-bcf9",
            "job_id":"e4942c94-9d66-458e-beb7-90601664641e",
    	"apply_results": [{
    		"instance_id": "fe5f5a07539c431181fc78220713aebein01",
    		"instance_name": "zyy1",
    		"restart_required": false,
    		"success": false
    	}, {
    		"instance_id": "73ea2bf70c73497f89ee0ad4ee008aa2in01",
    		"instance_name": "zyy2",
    		"restart_required": false,
    		"success": false
    	}],
    	"success": false
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码