調用ModifyHASwitchConfig介面開啟或關閉RDS執行個體的主備切換功能。

主備執行個體切換後原來的主執行個體會變成備執行個體。詳情請參見切換主備執行個體

調用該介面時,執行個體版本必須為MySQL高可用版。

調試

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

請求參數

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

系統規定參數,取值:ModifyHASwitchConfig

RegionId String cn-hangzhou

地區ID,可以通過介面DescribeRegions查看地區ID。

DBInstanceId String rm-uf6wjk5xxxxxxxxxx

執行個體ID。

HAConfig String Manual

主備切換設定,取值:

  • Auto:出現故障時自動切換主備執行個體;
  • Manual:臨時關閉自動切換。

預設值:Auto

说明 取值為Manual時,必須傳入參數ManualHATime
ManualHATime String 2019-08-29T15:00:00Z

臨時關閉的截止時間。最晚可設定為7天后的23:59:59。格式:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。

说明 僅當參數HAConfig取值為Manual時,本參數有效。
AccessKeyId String LTAIfCxxxxxxx

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

返回資料

名稱 類型 樣本值 描述
RequestId String B6AE1448-D846-4831-B1C7-CFF3E99D5470

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=ModifyHASwitchConfig
&RegionId=cn-hangzhou
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&HAConfig=Manual
&ManualHATime=2019-08-28T15:00:00
&<公用請求參數>

正常返回樣本

XML 格式

<ModifyHASwitchConfigResponse>
  <RequestId>B6AE1448-D846-4831-B1C7-CFF3E99D5470</RequestId>
</ModifyHASwitchConfigResponse>

JSON 格式

{
	"RequestId":"B6AE1448-D846-4831-B1C7-CFF3E99D5470"
}

錯誤碼

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