SwitchInstanceHA - 切换实例HA_云原生内存数据库Tair-阿里云帮助中心

执行主从切换（即切换节点角色），可应用于容灾演练、多可用区场景下的应用就近连接等需求。

接口说明

说明关于多可用区场景下的应用就近连接的详细说明，请参见场景示例。

调用本接口时，Redis实例需为本地盘实例，且需为社区版或Tair内存型。

调用本接口将产生下述影响：

当前API暂无授权信息透出。

名称	类型	必填	描述	示例值
InstanceId	string	是	实例ID，可调用DescribeInstances获取。	r-bp1zxszhcgatnx****
NodeId	string	否	数据分片节点ID，您可以调用DescribeRoleZoneInfo获取CustinsId参数，多个数据分片节点ID之间使用英文逗号（,）分隔，如需指定所有节点请输入`all`。说明当Redis实例为集群或读写分离架构时，本参数才可用，且必填。	56**19,56**20
SwitchMode	integer	否	执行时间，取值： 0：立即执行，默认值。 1：在可维护时间段执行。说明您可以调用ModifyInstanceMaintainTime修改Redis实例的可维护时间段。	0
SwitchType	string	是	切换模式，取值： AvailablePriority：可用性优先，不考虑主从延迟，立即执行主从切换，可能会丢失少量数据。 ReliabilityPriority：可靠性优先，确保主从同步无延迟时才执行主从切换，不会丢失数据。该模式在写入量较大且持续存在同步延迟的场景下，可能会造成主从切换失败。说明您需要根据业务场景对数据、服务等方面的需求进行衡量，然后选取切换模式。	AvailablePriority

名称	类型	描述	示例值
	object
RequestId	string	请求ID。	5D622714-AEDD-4609-9167-F5DDD3D1****

正常返回示例

JSON格式

{
  "RequestId": "5D622714-AEDD-4609-9167-F5DDD3D1****"
}

访问错误中心查看更多错误码。