調用SwitchDBInstanceNetType介面切換內外網地址。

為了節約地址資源，您可以使用該介面進行內外網切換，即原來是內網，則會切換到外網，反之亦然。切換後串連地址會發生變化，需要您修改代碼中的串連地址並重啟應用。

必須滿足以下條件，否則將修改失敗：

  • 執行個體只有內網地址和外網地址其中一個；
  • 執行個體狀態為運行中；
  • 24小時內切換次數低於20次；
  • 執行個體的網路類型為傳統網路；
  • 執行個體的設定訪問模式和執行個體規格表對串連地址的選擇有如下限制：
    • 執行個體系列為單機基礎版，執行個體版本為MySQL 5.7、SQL Server 2016 web 基礎系列、2012 web 基礎系列、2012 企業版 基礎系列、PostgreSQL 10.0，訪問模式為標準模式，串連地址可切換為內網地址、外網地址、內網地址和外網地址；
    • 執行個體系列為雙機高可用版，執行個體版本為MySQL 5.5/5.6/5.7、SQL Server 2008 R2、2016標準版 高可用系列、2012標準版 高可用系列、2016企業版 高可用系列、2012企業版 高可用系列、PostgreSQL 9.4、PPAS 9.3、10.0，訪問模式為標準模式，串連地址可切換為內網地址、外網地址；
    • 執行個體系列為雙機高可用版，執行個體版本為MySQL 5.5/5.6/5.7、SQL Server 2008 R2、2016標準版 高可用系列、2012標準版 高可用系列、2016企業版 高可用系列、2012企業版 高可用系列、PostgreSQL 9.4、PPAS 9.3、10.0，訪問模式為高安全模式，串連地址可切換為內網地址、外網地址、內網地址和外網地址；
    • 執行個體系列為三節點企業版，執行個體版本為MySQL 5.6，訪問模式為標準模式，串連地址可切換為內網地址、外網地址；
    • 執行個體系列為三節點企業版，執行個體版本為MySQL 5.6，訪問模式為高安全模式，串連地址可切換為內網地址、外網地址、內網地址和外網地址。

調試

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

請求參數

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

執行個體ID。
ConnectionStringPrefix String 是 rm-xxxxxx

自訂串連地址的前輟。由字母，數字組成，小寫字母開頭，8~64個字元。
ClientToken String 否 ETnLKlblzczshOTUbOCzxxxxxx

用於保證請求的等冪性，防止重複提交請求。由用戶端產生該參數值，要保證在不同請求間唯一，最大值不超過64個ASCII字元，且該參數值中不能包含非ASCII字元。
Port String 否 3306

連接埠號碼，取值：3001~3999。

ConnectionStringType String 否 Normal

查詢串連地址類型，取值：

  • Normal：查詢普通串連；
  • ReadWriteSplitting：查詢讀寫分離串連；

預設返回所有串連。
AccessKeyId String 否 LTAIfCxxxxxxx

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

返回資料

名稱 類型 樣本值 描述
RequestId String 65BDA532-28AF-4122-AA39-B382721EEE64

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceNetType
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConnectionStringPrefix=rm-xxxxxx
&<公用請求參數>

正常返回樣本

XML 格式 

<SwitchDBInstanceNetTypeResponse>
	  <RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId></SwitchDBInstanceNetTypeResponse>

JSON 格式 

{
	"RequestId":" 65BDA532-28AF-4122-AA39-B382721EEE64"
}

錯誤碼

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