調用DescribeDBInstanceHAConfig介面查詢RDS執行個體高可用模式和資料複製方式。

調試

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

請求參數

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxx

執行個體ID。
AccessKeyId String 否 LTAIfCxxxxxx

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

返回資料

名稱 類型 樣本值 描述
DBInstanceId String rm-uf6wjk5xxxxxx

執行個體ID。
HAMode String RPO

高可用模式，取值：

  • RPO：資料一致性優先，執行個體會儘可能保障資料的可靠性，即資料丟失量最少。對於資料一致性要求比較高的使用者應該使用RPO模式；
  • RTO：執行個體可用性優先，執行個體會儘快恢複服務，即可用時間最長。對於資料庫線上時間要求比較高的使用者應該使用RTO模式。
SyncMode String Sync

資料複製方式，取值：

  • Sync：強同步；
  • Semi-sync：半同步；
  • Async：非同步。
说明
  • 對於SQL Server 2012/2016雙機高可用版，值為Sync或Async；
  • 對於SQL Server 2017叢集版，值為Semi-sync。
HostInstanceInfos

主備執行個體資訊列表。
NodeId String 3397027

執行個體的唯一標識。
NodeType String Master

節點類型，取值：

  • Master：主節點；
  • Slave：備節點。
RegionId String cn-hangzhou

地區ID。
ZoneId String cn-hangzhou-b

可用性區域ID。
SyncStatus String NotAvailable

同步狀態，取值：

  • NotAvailable：不可用，即發生故障；
  • Syncing：同步中，切換可能會發生資料丟失；
  • Synchronized：完成同步；
  • NotSupport：引擎類型或者版本不涉及主備同步。
LogSyncTime String 2018-05-05T15:15:00Z

備執行個體收到主執行個體日誌的時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

DataSyncTime String 2018-05-05T15:15:00Z

備執行個體執行日誌完成資料同步的時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

請求ID。

樣本

請求樣本


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

正常返回樣本

XML 格式 

<DescribeDBInstanceHAConfigResponse>
	  <dBInstanceId>rm-uf6wjk5xxxxxx</dBInstanceId>
	  <hAMode>RPO</hAMode>
	  <hostInstanceInfos>
		    <logSyncTime>2018-01-19T12:33:06Z</logSyncTime>
		    <nodeId>3397027</nodeId>
		    <nodeType>Slave</nodeType>
		    <regionId>cn-shenzhen</regionId>
		    <syncStatus>Syncing</syncStatus>
		    <zoneId>cn-shenzhen-b</zoneId>
	  </hostInstanceInfos>
	  <hostInstanceInfos>
		    <logSyncTime>2018-01-19T12:33:06Z</logSyncTime>
		    <nodeId>3397029</nodeId>
		    <nodeType>Master</nodeType>
		    <regionId>cn-shenzhen</regionId>
		    <syncStatus>Syncing</syncStatus>
		    <zoneId>cn-shenzhen-a</zoneId>
	  </hostInstanceInfos>
	  <requestId>F051AEB2-7655-4F0A-BC46-7E0C18A7910C</requestId>
	  <syncMode>Semi-sync</syncMode></DescribeDBInstanceHAConfigResponse>

JSON 格式 

{
	"hostInstanceInfos":[
		{
			"nodeId":"3397027",
			"syncStatus":"Syncing",
			"logSyncTime":"2018-01-19T12:33:06Z",
			"nodeType":"Slave",
			"zoneId":"cn-shenzhen-b",
			"regionId":"cn-shenzhen"
		},
		{
			"nodeId":"3397029",
			"syncStatus":"Syncing",
			"logSyncTime":"2018-01-19T12:33:06Z",
			"nodeType":"Master",
			"zoneId":"cn-shenzhen-a",
			"regionId":"cn-shenzhen"
		}
	],
	"requestId":"F051AEB2-7655-4F0A-BC46-7E0C18A7910C",
	"syncMode":"Semi-sync",
	"hAMode":"RPO",
	"dBInstanceId":"rm-uf6wjk5xxxxxx"
}

錯誤碼

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