Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::RDS::MigrateTask

Última atualização: Jun 27, 2026

Restaura arquivos de backup do Object Storage Service (OSS) em uma instância do ApsaraDB RDS for SQL Server para migrar dados para a nuvem.

Sintaxe

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

Propriedades

Propriedade Tipo Obrigatório Atualizável Descrição Restrições
IsOnlineDB Boolean Sim Não Defina se o banco de dados restaurado ficará online. Valores válidos:
  • true: coloca o banco de dados online.
  • false: não coloca o banco de dados online.
Nota Para bancos de dados SQL Server 2008 R2, esse parâmetro é sempre definido como true.
DBInstanceId String Sim Não ID da instância. Nenhuma
OssObjectPositions String Não Não Localização do arquivo de backup no OSS. O valor contém três partes separadas por dois pontos (:):
  • Endpoint do OSS: oss-ap-southeast-1.aliyuncs.com.
  • Nome do bucket do OSS: rdsmssqlsingapore.
  • Chave do arquivo de backup no OSS: autotest_2008R2_TestMigration_FULL.bak.
Nota
  • Parâmetro opcional para bancos de dados SQL Server 2008 R2.
  • Parâmetro obrigatório para versões posteriores ao SQL Server 2008 R2.

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

CheckDBMode String Não Não Método de verificação de consistência após o banco de dados ficar online. Valores válidos:
  • SyncExecuteDBCheck: executa verificação síncrona do banco de dados.
  • AsyncExecuteDBCheck (padrão): executa verificação assíncrona do banco de dados.

    Compatível com SQL Server 2008 R2.

Nota Válido apenas quando IsOnlineDB está definido como true.
BackupMode String Sim Não Modo de backup da tarefa de migração. Valores válidos:
  • FULL: restaura dados de um arquivo de backup completo.
  • UPDF: restaura dados incrementais de um arquivo incremental ou de log.
DBName String Sim Não Nome do banco de dados de destino. Nenhuma
OSSUrls String Não Não URL compartilhada do arquivo de backup no OSS. A URL deve estar codificada. Para múltiplas URLs, separe-as com barras verticais (|) e codifique toda a string resultante.
Nota Parâmetro obrigatório para bancos de dados SQL Server 2008 R2.

Valores de retorno

Fn::GetAtt

MigrateTaskId: ID da tarefa de migração.

DBName: nome do banco de dados de destino.

Exemplos

  • Formato YAML

    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                    
  • Formato JSON

    {
      "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"
            ]
          }
        }
      }
    }