文档首页> 云数据库 RDS> API参考 (阿布扎比区域) > API v3（推荐）> 实例管理> 单机转主备实例
更新时间：2022-02-22 GMT+08:00
查看PDF

单机转主备实例

功能介绍

单机实例转主备实例。

接口约束

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

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/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数据库实例进行单机转主备时可选，指定时会验证密码有效性。
  • 请求样例

    MySQL、PostgreSQL按需实例单机转主备：

    {
	"single_to_ha": {
		"az_code_new_node": "az2xahz"
	}
}

    SQL Server按需实例单机转主备：

    {
	"single_to_ha": {
		"az_code_new_node": "az2xahz",
		"password": "Test@1234567"
	}
}

响应消息

  • 按需实例
    • 正常响应要素说明
      表4 要素说明

      名称

      参数类型

      说明

      job_id

      String

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

      请参见异常请求结果。

  • 包周期实例
    • 正常响应要素说明
      表5 要素说明

      名称

      参数类型

      说明

      order_id

      String

      订单ID。
    • 正常响应样例
      {
	"order_id": "CS2009151216NO2U2"
}
    • 异常响应

      请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 实例管理