文档首页> 云数据库 RDS> API参考> API v3(推荐)> 实例管理> 切换主备实例的倒换策略
更新时间:2024-03-28 GMT+08:00

切换主备实例的倒换策略

功能介绍

云数据库 RDS服务支持切换主备实例的可用性策略,以满足不同业务需求。可选择 “可靠性优先”或者“可用性优先”两种策略。

接口约束

  • 该接口仅支持MySQL引擎。
  • 仅支持主备实例,即HA实例。
  • 实例在创建、数据库升级、创建用户、删除用户状态下不能进行此操作。

URI

  • URI格式

    PUT /v3/{project_id}/instances/{instance_id}/failover/strategy

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一Region下的项目ID。

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

    instance_id

    实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

repairStrategy

String

可用性策略,可选择如下方式:

  • reliability:可靠性优先,数据库应该尽可能保障数据的可靠性,即数据丢失量最少。对于数据一致性要求较高的业务,建议选择该策略
  • availability:可用性优先,数据库应该可快恢复服务,即可用时间最长。对于数据库在线时间要求较高的业务,建议选择该策略

请求示例

切换主备实例的倒换策略为可用性优先(availability)。

PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/failover/strategy
{
     "repairStrategy": "availability"
}

响应消息

  • 正常响应要素说明

    无。

状态码

错误码

请参见错误码