調用SwitchDBInstanceHA介面切換RDS執行個體的主備執行個體。

本介面可用於切換高可用版RDS執行個體的主備執行個體，切換主備執行個體後，原來的備執行個體成為主執行個體並承擔業務流量。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 SwitchDBInstanceHA

系統規定參數，取值：SwitchDBInstanceHA。

DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

執行個體ID。
NodeId String 是 349054

備執行個體的唯一標識，通過介面DescribeDBInstanceHAConfig可查詢該值。

Force String 否 No

切換方式，取值：

  • Yes：強制；
  • No：非強制。

預設值：No。

EffectiveTime String 否 Immediate

生效時間，取值：

  • Immediate：立即執行；
  • MaintainTime：可維護時間內執行。

預設值：Immediate。

AccessKeyId String 否 LTAIfCxxxxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。

返回資料

名稱 類型 樣本值 描述
RequestId String 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceHA
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&NodeId=349054
&<公用請求參數>

正常返回樣本

XML 格式 

<SwitchDBInstanceHAResponse>
	  <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId></SwitchDBInstanceHAResponse>

JSON 格式 

{
	"RequestId":"1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。