文档首页> 云数据库 RDS> API参考（吉隆坡区域）> API v3（推荐）> 实例管理> 单机转主备实例
更新时间：2022-08-16 GMT+08:00
查看PDF

单机转主备实例

功能介绍

单机实例转主备实例。

接口约束

  • 有些实例规格不支持升级为主备实例，具体请以实际环境为准。

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/action

  • URI样例

    https://rds.my-kualalumpur-1.alphaedge.tmone.com.my/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    是

    租户在某一region下的project ID。

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

    instance_id

    是

    实例ID。

请求消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    说明

    single_to_ha

    是

    Object

    详情请参见表3。
    表3 single_to_ha字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    az_code_new_node

    是

    String

    实例节点可用区码（AZ）。

    password

    否

    String

    仅在支持SQL Server数据库实例进行单机转主备时必选，有效。
  • 请求样例
    {
	"single_to_ha": {
		"az_code_new_node": "az2xahz",
		"password": "Test@1234567"
	}
}

响应消息

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

    名称

    参数类型

    说明

    job_id

    String

    任务ID
  • 正常响应样例
    {
	"job_id": "2b414788a6004883a02390e2eb0ea227"
}
  • 异常响应

    请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 实例管理