灾备实例升主

功能介绍

实例间建立的跨云或跨Region容灾关系出现异常后，将灾备实例升级为主实例。

使用该功能前，必须要确保跨云或跨Region数据库实例之间VPC网段的网络打通，且配置安全组放通VPC网段间的数据库端口。仅打通网络未放通安全组也无法搭建容灾关系。

• 调用接口前，您需要了解API 认证鉴权。

调试

您可以在API Explorer中调试该接口。

接口约束

• 主实例和灾备实例状态正常，主实例和灾备实例在不同云或不同Region且灾备实例为单实例。
• 主实例和灾备实例的容灾关系建立完成。
• RDS for PostgreSQL 12及以上版本支持灾备实例升级为主实例。

URI

• URI格式

  POST /v3/{project_id}/instances/{instance_id}/action

• 参数说明

  表1 参数说明

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

请求消息

请求示例

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/24c6678f474241fe89ee9c42f768022ein03/action 

{
	"drreplica_to_master": {}
}

响应消息

• 正常响应要素说明

  表3 要素说明

  名称	参数类型	说明
  job_id	String	任务ID。

• 正常响应样例

  {
  	"job_id": "04efe8e2-9255-44ae-a98b-d87cae411890"
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。