All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::RDS::MigrateTask

Last Updated:Jun 17, 2026

Memulihkan file backup dari Object Storage Service (OSS) ke instans ApsaraDB RDS for SQL Server untuk migrasi data ke cloud.

Sintaks

{
  "Type": "ALIYUN::RDS::MigrateTask",
  "Properties": {
    "IsOnlineDB": Boolean,
    "DBInstanceId": String,
    "OssObjectPositions": String,
    "CheckDBMode": String,
    "BackupMode": String,
    "DBName": String,
    "OSSUrls": String
  }
}

Properti

Properti Tipe Wajib Dapat Diperbarui Deskripsi Batasan
IsOnlineDB Boolean Ya Tidak Menentukan apakah database yang dipulihkan akan dibawa online. Nilai yang valid:
  • true: Membawa database online.
  • false: Tidak membawa database online.
Catatan Jika database adalah SQL Server 2008 R2, parameter ini selalu diatur ke true.
DBInstanceId String Ya Tidak ID instans. Tidak ada
OssObjectPositions String Tidak Tidak Lokasi file backup di OSS. Nilainya terdiri dari tiga bagian yang dipisahkan oleh titik dua (:).
  • Titik akhir OSS: oss-ap-southeast-1.aliyuncs.com.
  • Nama bucket OSS: rdsmssqlsingapore.
  • Kunci file backup di OSS: autotest_2008R2_TestMigration_FULL.bak.
Catatan
  • Parameter ini opsional jika database adalah SQL Server 2008 R2.
  • Parameter ini wajib jika database menggunakan versi yang lebih baru dari SQL Server 2008 R2.

Contoh: oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak

CheckDBMode String Tidak Tidak Metode pemeriksaan konsistensi yang digunakan setelah database dibawa online. Nilai yang valid:
  • SyncExecuteDBCheck: Melakukan pemeriksaan DB secara sinkron.
  • AsyncExecuteDBCheck (Default): Melakukan pemeriksaan DB secara asinkron.

    Kompatibel dengan SQL Server 2008 R2.

Catatan Parameter ini hanya berlaku ketika parameter IsOnlineDB diatur ke true.
BackupMode String Ya Tidak Mode backup untuk task migrasi. Nilai yang valid:
  • FULL: Memulihkan data dari file cadangan penuh.
  • UPDF: Memulihkan data inkremental dari file inkremental atau log.
DBName String Ya Tidak Nama database tujuan. Tidak ada
OSSUrls String Tidak Tidak URL bersama file backup di OSS. URL harus di-encode dalam format URL. Jika Anda memiliki beberapa URL, pisahkan dengan tanda pipa vertikal (|), lalu encode seluruh string tersebut dalam format URL.
Catatan Parameter ini wajib jika database adalah SQL Server 2008 R2.

Nilai kembalian

Fn::GetAtt

MigrateTaskId: ID task migrasi.

DBName: Nama database tujuan.

Contoh

  • YAML format

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      RdsId:
        Type: String
        AssociationProperty: ALIYUN::RDS::Instance::InstanceId
      DBName:
        Type: String
        Description: The name of the database that you want to restore.
    Resources:
      MigrateTask:
        Type: ALIYUN::RDS::MigrateTask
        Properties:
          IsOnlineDB: true
          DBInstanceId:
            Ref: RdsId
          BackupMode: FULL
          DBName:
            Ref: DBName
    Outputs:
      MigrateTaskId:
        Description: The ID of the migrate task.
        Value:
          Fn::GetAtt:
            - MigrateTask
            - MigrateTaskId                    
  • JSON format

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "RdsId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::RDS::Instance::InstanceId"
        },
        "DBName": {
          "Type": "String",
          "Description": "The name of the database that you want to restore."
        }
      },
      "Resources": {
        "MigrateTask": {
          "Type": "ALIYUN::RDS::MigrateTask",
          "Properties": {
            "IsOnlineDB": true,
            "DBInstanceId": {
              "Ref": "RdsId"
            },
            "BackupMode": "FULL",
            "DBName": {
              "Ref": "DBName"
            }
          }
        }
      },
      "Outputs": {
        "MigrateTaskId": {
          "Description": "The ID of the migrate task.",
          "Value": {
            "Fn::GetAtt": [
              "MigrateTask",
              "MigrateTaskId"
            ]
          }
        }
      }
    }