更新时间：2023-11-21 GMT+08:00
容灾实例备升主
功能介绍
该接口用于对已经搭建容灾关系的实例，将备实例升级为主实例。
接口约束
该接口支持GeminiDB Redis数据库实例。
正常备实例升主，需要先调用主降备接口，将主实例降为备实例，再下发备升主。
强制备实例升主，用于在主实例异常的状态下，快速恢复服务的场景，不需要操作原主实例。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/switchover-master
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
租户在某一region下的project ID。获取方法请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
force |
否 |
Boolean |
是否强制备实例升主。 若为true，则强制备实例升主，用于在主实例异常的状态下，快速恢复服务的场景：允许备实例强制升为特殊主实例，独立提供读写服务。 默认为false，用于正常状态下备实例平缓升主。 |
响应参数
状态码： 202
参数 |
参数类型 |
描述 |
|---|---|---|
job_id |
String |
容灾实例备升主的工作ID。 |
请求示例
- URI样例
POST https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein12/switchover-master { "force": true }
响应示例
状态码： 202
Accepted
{
"job_id" : "20f793fd-2703-4339-bfb5-f1c9065b15c8"
}
状态码
请参见状态码。
错误码
请参见错误码。
父主题： 容灾管理
