ApsaraDB RDS：CheckCreateDdrDBInstance - 預檢查執行個體是否可以進行跨地區恢複

1、先調用 DescribeCrossRegionBackups 介面擷取全量備份組 ID

請求樣本

{
  "DBInstanceId": "rm-2ze07tklq********",  // 執行個體 ID
  "RegionId": "cn-beijing",                // 執行個體所在地區 ID
  "CrossBackupRegion": "cn-shenzhen",      // 跨地區備份組所在地區 ID
  "StartTime": "2025-04-18T02:47:00Z",     // 查詢開始時間
  "EndTime": "2025-04-25T02:47:00Z",       // 查詢結束時間
  "PageSize": 30,                          // 每頁記錄數
  "PageNumber": 1                          // 頁碼
}

返回樣本

在傳回值列表中找到 BackupType 為 F 且 CrossBackupSetFile 以.zip結尾的一個全量備份組，擷取 CrossBackupId 欄位值，本樣本 CrossBackupId 為 18371944。

{
  "TotalRecordCount": 100,
  "PageRecordCount": 30,
  "RequestId": "7960B6AD-715E-5F0C-AB09-F59B6E76450B",
  "PageNumber": 1,
  "Items": {
    "Item": [
      {
        "BackupMethod": "P",    // 跨地區備份方式的備份方式。L：邏輯備份；P：物理備份
        "Category": "Basic",
        "EngineVersion": "2022_web",
        "InstanceId": 35449901,
        "CrossBackupDownloadLink": "https://rdsddrbak-st.oss-cn-shenzhen.aliyuncs.com/cn-beijing_rm-***********",
        "CrossBackupRegion": "cn-shenzhen",
        "CrossBackupSetLocation": "oss",
        "DBInstanceStorageType": "ecs",
        "BackupSetScale": 0,
        "CrossBackupSetFile": "cn-beijing_rm-*******_hins35449901_2025042310032419855966.zip",
        "CrossBackupSetSize": 9179823,
        "HasBackupTableMeta": "1",
        "RestoreRegions": {
          "RestoreRegion": [
            "cn-shenzhen"
          ]
        },
        "BackupEndTime": "2025-04-23T02:03:36Z",
        "BackupStartTime": "2025-04-23T02:03:24Z",
        "BackupType": "F",    // 跨地區備份類型。F：全量備份；I：增量備份
        "CrossBackupId": 18371944,    // 跨地區備份檔案 ID
        "Engine": "mssql"
      }
    ]
  },
  "RegionId": "cn-beijing"
}

2、再調用 CheckCreateDdrDBInstance 判斷是否可以進行跨地區恢複

請求樣本

{
  "RegionId": "cn-shenzhen",      // 目的執行個體地區 ID
  "Engine": "SQLServer",          // 目標資料庫類型
  "EngineVersion": "2022_web",    // 目標資料庫版本，與原執行個體的版本一致
  "DBInstanceClass": "mssql.x2.medium.w1", // 目標執行個體規格
  "DBInstanceStorage": 100,       // 目標執行個體儲存空間（單位：GB）
  "RestoreType": "0",             // 恢複方式。0：備份組恢複；1：時間點恢複
  "BackupSetId": "18371944"       // 跨地區全備 ID，通過 DescribeCrossRegionBackups 介面擷取
}

返回樣本

IsValid 為 true 時表示可以進行跨地區備份執行個體的建立。

{
  "RequestId": "D55083BF-5328-50CA-8D85-40C8815D56AA",
  "IsValid": "true"
}

3、調用 CreateDdrInstance 介面按備份組恢複資料到新執行個體中

1、調用 CheckCreateDdrDBInstance 判斷是否可以進行跨地區恢複

請求樣本

{
  "RegionId": "cn-shenzhen",      // 目的執行個體地區 ID
  "Engine": "SQLServer",          // 目標資料庫類型
  "EngineVersion": "2022_web",    // 目標資料庫版本，與原執行個體的版本一致
  "DBInstanceClass": "mssql.x2.medium.w1", // 目標執行個體規格
  "DBInstanceStorage": 100,       // 目標執行個體儲存空間（單位：GB）
  "RestoreType": "1",             // 恢複方式。0：備份組恢複；1：時間點恢複
  "RestoreTime": "2025-04-26T06:40:00Z", // 基於時間點恢複的時間
  "SourceRegion": "cn-beijing",   // 源執行個體地區 ID
  "SourceDBInstanceName": "rm-2ze07tklq********" // 源執行個體 ID
}

返回樣本

IsValid 為 true 時表示可以進行跨地區備份執行個體的建立。

{
  "RequestId": "A1A20D0D-4113-56DC-838A-E211B45D6F36",
  "IsValid": "true"
}

2、調用 CreateDdrInstance 介面按時間點恢複資料到新執行個體中