調(diào)用DescribeInstanceCrossBackupPolicy接口查詢跨地域備份設(shè)置。

僅適用于如下實(shí)例類型：

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeInstanceCrossBackupPolicy

系統(tǒng)規(guī)定參數(shù)，取值：DescribeInstanceCrossBackupPolicy。

DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

實(shí)例ID。
RegionId String 是 cn-hangzhou

地域ID，可以通過(guò)接口DescribeRegions查看地域ID。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
BackupEnabled String Enable

跨地域備份總開(kāi)關(guān)，取值：

  • Disable：關(guān)閉
  • Enable：開(kāi)啟
BackupEnabledTime String 2019-06-12T05:44:21Z

跨地域備份開(kāi)啟時(shí)間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時(shí)間）。

CrossBackupRegion String cn-shanghai

跨地域備份的目的地域ID。
CrossBackupType String 1

跨地域備份保存類型。默認(rèn)值：1，表示每個(gè)備份都保存。

DBInstanceDescription String 測(cè)試數(shù)據(jù)庫(kù)

實(shí)例名稱，長(zhǎng)度為2~256個(gè)字符。以中文、英文字母開(kāi)頭，可以包含數(shù)字、中文、英文、下劃線（_）、短橫線（-）。

說(shuō)明 不能以 http:// 和 https:// 開(kāi)頭。
DBInstanceId String rm-uf6wjk5xxxxxxxxxx

實(shí)例ID。
DBInstanceStatus String Running

實(shí)例狀態(tài)。詳情請(qǐng)參見(jiàn)實(shí)例狀態(tài)表。

Engine String mysql

數(shù)據(jù)庫(kù)類型。
EngineVersion String 5.6

數(shù)據(jù)庫(kù)版本。
LockMode String Unlock

實(shí)例鎖定狀態(tài)，取值：

  • Unlock：正常，沒(méi)有鎖定。
  • ManualLock：手動(dòng)觸發(fā)鎖定。
  • LockByExpiration：實(shí)例過(guò)期自動(dòng)鎖定。
  • LockByRestoration：實(shí)例回滾前的自動(dòng)鎖定。
  • LockByDiskQuota：實(shí)例空間滿自動(dòng)鎖定，不可訪問(wèn)實(shí)例。
LogBackupEnabled String Enable

跨地域日志備份開(kāi)關(guān)，取值：

  • Disable：關(guān)閉
  • Enable：開(kāi)啟
LogBackupEnabledTime String 2019-06-12T05:44:21Z

跨地域日志備份開(kāi)啟時(shí)間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時(shí)間）。

RegionId String cn-hangzhou

實(shí)例所在地域ID。
RequestId String CB7667B2-72C8-497B-9BD8-3B343CEF51AB

請(qǐng)求ID。
RetentType Integer 1

跨地域備份保留方式。默認(rèn)值：1，表示按時(shí)長(zhǎng)保留。

Retention Integer 15

跨地域備份保留天數(shù)，取值：7~1825。

示例

請(qǐng)求示例

http(s)://rds.aliyuncs.com/?Action=DescribeInstanceCrossBackupPolicy
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&RegionId=cn-hangzhou
&<公共請(qǐng)求參數(shù)>

正常返回示例

XML格式 

<DescribeInstanceCrossBackupPolicyResponse>
  <DBInstanceStatusDesc>ACTIVATION</DBInstanceStatusDesc>
	  <LockMode>Unlock</LockMode>
	  <BackupEnabledTime>2019-06-12T05:44:21Z</BackupEnabledTime>
	  <CrossBackupType>1</CrossBackupType>
	  <LogBackupEnabled>Enable</LogBackupEnabled>
	  <BackupEnabled>Enable</BackupEnabled>
	  <RetentType>1</RetentType>
	  <DBInstanceId>rm-bpxxxxx</DBInstanceId>
	  <DBInstanceDescription></DBInstanceDescription>
	  <Retention>15</Retention>
	  <Engine>mysql</Engine>
	  <LogBackupEnabledTime>2019-06-12T05:44:21Z</LogBackupEnabledTime>
	  <CrossBackupRegion>cn-shanghai</CrossBackupRegion>
	  <StorageOwner>rds</StorageOwner>
	  <RegionId>cn-hangzhou</RegionId>
	  <RequestId>CB7667B2-72C8-497B-9BD8-3B343CEF51AB</RequestId>
	  <EngineVersion>5.6</EngineVersion>
	  <StorageType>oss</StorageType>
	  <Endpoint></Endpoint>
	  <DBInstanceStatus>1</DBInstanceStatus>
</DescribeInstanceCrossBackupPolicyResponse>

JSON格式 

{
	"DBInstanceStatusDesc": "ACTIVATION",
	"LockMode": "Unlock",
	"BackupEnabledTime": "2019-06-12T05:44:21Z",
	"CrossBackupType": "1",
	"LogBackupEnabled": "Enable",
	"BackupEnabled": "Enable",
	"RetentType": 1,
	"DBInstanceId": "rm-bpxxxxx",
	"DBInstanceDescription": "",
	"Retention": 15,
	"Engine": "mysql",
	"LogBackupEnabledTime": "2019-06-12T05:44:21Z",
	"CrossBackupRegion": "cn-shanghai",
	"StorageOwner": "rds",
	"RegionId": "cn-hangzhou",
	"RequestId": "CB7667B2-72C8-497B-9BD8-3B343CEF51AB",
	"EngineVersion": "5.6",
	"StorageType": "oss",
	"Endpoint": "",
	"DBInstanceStatus": "1"
}

錯(cuò)誤碼

HttpCode 錯(cuò)誤碼 錯(cuò)誤信息 描述
400 InvalidRegion.Format Specified Region is not valid. 指定的region不合法

訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。