更新时间:2023-11-21 GMT+08:00
容灾实例备升主
功能介绍
该接口用于对已经搭建容灾关系的实例,将备实例升级为主实例。
接口约束
该接口支持GeminiDB Redis数据库实例。
正常备实例升主,需要先调用主降备接口,将主实例降为备实例,再下发备升主。
强制备实例升主,用于在主实例异常的状态下,快速恢复服务的场景,不需要操作原主实例。
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.ap-southeast-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein12/switchover-master { "force": true }
响应示例
状态码: 202
Accepted
{ "job_id" : "20f793fd-2703-4339-bfb5-f1c9065b15c8" }
状态码
请参见状态码。
错误码
请参见错误码。
父主题: 容灾管理