Todos os produtos
Search

Este produto

    Server Migration Center:CreateReplicationJob

    Central de documentação

    Server Migration Center:CreateReplicationJob

    Última atualização: Aug 20, 2026

    Cria uma tarefa de migração para uma origem de migração chamando CreateReplicationJob.

    Descrição da operação

    Descrição da operação.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    smc:CreateReplicationJob

    create

    *ReplicationJob

    acs:smc:{#regionId}:{#accountId}:replicationjob/*

    *SourceServer

    acs:smc:{#regionId}:{#accountId}:sourceserver/{#SourceServerId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região de destino do Alibaba Cloud para a qual a origem de migração deve ser migrada.

    cn-hangzhou
    ClientToken

    string

    Não

    Garante a idempotência da solicitação. Você pode gerar um valor de parâmetro de até 64 caracteres ASCII no cliente e atribuir o valor a ClientToken para garantir a idempotência das solicitações de nova tentativa. Para mais informações, consulte Como garantir a idempotência.

    123e4567-e89b-12d3-a456-426655440000
    Name

    string

    Não

    O nome da tarefa de migração. O nome deve atender aos seguintes requisitos:

    • O nome da tarefa deve ser único.

    • O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra e não pode começar com http:// ou https://. Pode conter dígitos, dois pontos (:), sublinhados (_) ou hifens (-).

    testMigrationTaskName
    Description

    string

    Não

    A descrição da tarefa de migração.

    A descrição deve ter de 2 a 128 caracteres e deve começar com uma letra ou um caractere chinês. Não pode começar com http:// ou https://. Pode conter dígitos, dois pontos (:), sublinhados (_) ou hifens (-).

    This_is_a_migration_task
    SourceId

    string

    Sim

    O ID da origem de migração.

    s-bp1e2fsl57knvuug****
    TargetType

    string

    Não

    O tipo de destino da tarefa de migração. Valores válidos:

    • Image: Após uma migração bem-sucedida, o Server Migration Center (SMC) gera uma imagem do Alibaba Cloud para a sua origem de migração.

    • ContainerImage: Após uma migração bem-sucedida, o SMC gera uma imagem de contêiner Docker para a sua origem de migração.

    • TargetInstance: Após uma migração bem-sucedida, o SMC migra a sua origem de migração diretamente para a instância de destino. Se você definir este parâmetro como TargetInstance, também deverá especificar o parâmetro InstanceId.

    Image
    ScheduledStartTime

    string

    Não

    O horário de execução da tarefa de migração. O valor deste parâmetro deve atender aos seguintes requisitos:

    • O horário deve seguir o padrão ISO 8601 em UTC+0. O formato é AAAA-MM-DDThh:mm:ssZ. Por exemplo, 2018-01-01T12:00:00Z indica 20:00:00 em 1º de janeiro de 2018 (UTC+8).

    • O valor deve ser posterior ao horário atual e estar dentro de 30 dias a partir do horário atual.

    Nota

    Se este parâmetro for deixado vazio, o Server Migration Center (SMC) não iniciará a tarefa de migração. Você deve chamar StartReplicationJob para iniciar a tarefa.

    2019-06-04T13:35:00Z
    ValidTime

    string

    Não

    O horário de expiração da tarefa de migração. Valores válidos: hora de criação da tarefa de migração + 7 dias até hora de criação da tarefa de migração + 90 dias.

    2019-06-04T13:35:00Z
    ImageName

    string

    Não

    O nome da imagem de destino do Alibaba Cloud gerada pela tarefa de migração. O nome da imagem deve atender aos seguintes requisitos:

    • O nome da imagem deve ser único na mesma região do Alibaba Cloud.

    • O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois pontos (:), sublinhados (_) ou hifens (-).

    Nota

    Durante a tarefa de migração, se já existir uma imagem com o mesmo nome na região atual, o sistema adiciona o ID da tarefa de migração (JobId) como sufixo ao nome da imagem por padrão, como ImageName_j-2zexxxxxxxxxxxxx.

    testAliCloudImageName
    InstanceId

    string

    Não

    O ID da instância de destino.

    i-bp1f1dvfto1sigz5****
    SystemDiskSize

    integer

    Não

    O tamanho do disco em nuvem do sistema da instância ECS de destino do Alibaba Cloud. Unidade: GiB. Valores válidos: 20 a 2048.

    Nota

    O valor deste parâmetro deve ser maior que o espaço real utilizado do disco em nuvem do sistema de origem da migração. Por exemplo, se o tamanho do disco em nuvem do sistema de origem for 500 GiB, mas o espaço real utilizado for 100 GiB, o valor deste parâmetro deve ser maior que 100 GiB.

    80
    VpcId

    string

    Não

    O ID da VPC para a qual o Express Connect ou VPN Gateway está configurado.

    vpc-bp1vwnn14rqpyiczj****
    VSwitchId

    string

    Não

    O ID do vSwitch na VPC especificada.

    vsw-bp1ddbrxdlrcbim46****
    ReplicationParameters

    string

    Não

    As informações de parâmetro do driver de replicação. As informações de parâmetro estão no formato de par chave-valor JSON com chaves fixas. Comprimento máximo: 2048 caracteres.

    {"bandwidth_limit":0,"compress_level":1,"checksum":true}
    NetMode

    integer

    Não

    O modo de rede para transmissão de dados. Valores válidos:

    • 0: Modo de transmissão por rede pública. A origem da migração deve ter acesso à Internet, e os dados de migração são transmitidos pela Internet.

    • 2: Modo de transmissão por rede interna. Se você selecionar este modo, deverá definir o parâmetro VSwitchId. Não é necessário definir o parâmetro VpcId, pois o serviço pode obter automaticamente o ID da VPC por meio de chamadas de API internas.

    Valor padrão: 0.

    0
    RunOnce

    boolean

    Não

    Especifica se deve ser criada uma tarefa de migração única ou uma tarefa de migração incremental. Valores válidos:

    • true (padrão): tarefa de migração única. A tarefa é executada apenas uma vez após sua criação.

    • false: tarefa de migração incremental. Após a criação da tarefa, ela é executada automaticamente de forma periódica com base no valor do parâmetro Frequency. As tarefas de migração incremental permitem sincronizar dados incrementais da origem da migração para o Alibaba Cloud sem interromper seus negócios e gerar uma imagem de dados completos da origem da migração no momento em que a tarefa é executada.

    Nota

    Este parâmetro pode ser especificado apenas durante a criação de uma tarefa de migração. Após a definição do valor, ele não pode ser alterado.

    true
    Frequency

    integer

    Não

    O intervalo no qual a tarefa de migração incremental é executada. Unidade: horas. Valores válidos: 1 a 168.

    Este parâmetro é obrigatório quando RunOnce está definido como false.

    Valor padrão: null.

    12
    MaxNumberOfImageToKeep

    integer

    Não

    O número máximo de imagens retidas por padrão para uma tarefa de migração incremental. Valores válidos: 1 a 10.

    Este parâmetro é obrigatório quando RunOnce está definido como false.

    Valor padrão: null.

    10
    InstanceType

    string

    Não

    O tipo de instância da instância ECS intermediária.

    Chame DescribeInstanceTypes para consultar os tipos de instância fornecidos pelo Elastic Compute Service (ECS).

    ecs.c6.large
    LaunchTemplateId

    string

    Não

    O ID do modelo de inicialização da instância.

    lt-bp16jovvln1cgaaq****
    LaunchTemplateVersion

    string

    Não

    A versão do modelo de inicialização da instância.

    1
    InstanceRamRole

    string

    Não

    O nome da função RAM da instância.

    SMCAdmin
    ContainerNamespace

    string

    Não

    O namespace do contêiner Docker. Para mais informações sobre imagens de contêiner Docker, consulte Container Registry.

    testNamespace
    ContainerRepository

    string

    Não

    O repositório de imagens Docker. Para mais informações sobre imagens de contêiner Docker, consulte Container Registry.

    testRepository
    ContainerTag

    string

    Não

    A tag da imagem Docker. Para mais informações sobre imagens de contêiner Docker, consulte Container Registry.

    CentOS:v1
    LicenseType

    string

    Não

    O tipo de licença. Valores válidos:

    • Valor vazio: sem licença.

    • BYOL: Bring Your Own License (Traga sua própria licença).

    Para mais informações, consulte Perguntas frequentes sobre o SMC.

    BYOL
    DataDisk

    array<object>

    Não

    A lista de informações de discos de dados em nuvem.

    array<object>

    Não

    A lista de informações de discos de dados em nuvem.

    Index

    integer

    Não

    O índice do disco de dados em nuvem na instância ECS de destino do Alibaba Cloud. O valor inicial é 1. Valores válidos: 1 a 16.

    Nota

    Você pode criar discos de dados em nuvem de destino apenas para discos de dados que existem na origem da migração.

    1
    Part

    array<object>

    Não

    A lista de partições.

    object

    Não

    A lista de partições.

    SizeBytes

    integer

    Não

    O tamanho da partição N no disco de dados em nuvem de destino N. Unidade: bytes. Valor padrão: o tamanho da partição do disco de dados em nuvem de origem.

    Nota

    • O tamanho da partição não pode exceder o tamanho do disco de dados em nuvem, e o tamanho total de todas as partições no mesmo disco de dados em nuvem não pode exceder o tamanho do disco de dados em nuvem.

    • Se DataDisk.N.Part.N.Device não estiver vazio, este parâmetro também não poderá estar vazio.

    254803968
    Block

    boolean

    Não

    Especifica se a replicação em bloco deve ser ativada para a partição N no disco de dados em nuvem N. Valores válidos:

    true
    Device

    string

    Não

    O identificador de dispositivo da partição N no disco em nuvem de dados N. Para o valor real de N, consulte o identificador de dispositivo da partição da origem de migração.

    Nota

    Se DataDisk.N.Part.N.SizeBytes não estiver vazio, este parâmetro também não poderá estar vazio.

    0_1
    Size

    integer

    Não

    O tamanho do disco de dados em nuvem na instância ECS de destino do Alibaba Cloud. Unidade: GiB. Valores válidos: 20 a 32768.\n>O valor deste parâmetro deve ser maior que o espaço realmente utilizado no disco de dados em nuvem da origem da migração. Por exemplo, se o tamanho do disco de dados em nuvem de origem for 500 GiB com 100 GiB realmente utilizados, o valor deste parâmetro deve ser maior que 100 GiB.

    100
    Tag

    array<object>

    Não

    A lista de tags.

    object

    Não

    A lista de tags.

    Key

    string

    Não

    A chave da tag da tarefa de migração. Valores válidos de N: 1 a 20.

    TestKey
    Value

    string

    Não

    O valor da tag da tarefa de migração. Valores válidos de N: 1 a 20.

    TestValue
    SystemDiskPart

    array<object>

    Não

    As informações de partição do disco em nuvem do sistema.

    object

    Não

    A lista de partições do disco em nuvem do sistema.

    SizeBytes

    integer

    Não

    O tamanho da partição N do disco em nuvem do sistema. Unidade: bytes. Valor padrão: o tamanho da partição do disco em nuvem do sistema de origem.

    254803968
    Block

    boolean

    Não

    Especifica se a replicação em bloco deve ser ativada para a partição N do disco em nuvem do sistema. Valores válidos:

    true
    Device

    string

    Não

    O identificador de dispositivo da partição N do disco do sistema. Para o valor real de N, consulte o identificador de dispositivo da partição da origem de migração.\n> Se SystemDiskPart.N.SizeBytes não estiver vazio, este parâmetro também não poderá estar vazio.

    0_1
    JobType

    integer

    Não

    O tipo da tarefa de migração. Valores válidos:

    0
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos.

    rg-acfmw3ty5y7****
    Disks

    object

    Não

    As informações do disco.

    System

    object

    Não

    As informações do disco em nuvem do sistema.

    Size

    integer

    Não

    O tamanho do disco de sistema na origem da migração. Unidade: GiB. Valores válidos: 20 a 32768.

    Nota

    O valor deve ser maior que o espaço real utilizado do disco de sistema de origem. Por exemplo, se o disco de sistema de origem tiver 500 GiB, mas apenas 100 GiB estiverem em uso, defina este parâmetro com um valor superior a 100 GiB.

    100
    LVM

    boolean

    Não

    Especifica se deve ser usado o Logical Volume Manager (LVM). Valores válidos:

    • true: Usa LVM.

    • false: Não usa LVM.

    O LVM não pode ser ativado nos seguintes cenários:

    • A origem da migração executa um sistema operacional Windows.

    • O disco em nuvem do sistema não possui uma partição de inicialização.

    Após a ativação do LVM, o recurso não entra em vigor nos seguintes cenários:

    • A origem da migração não suporta lvm2 ou não tem o pacote lvm2 instalado.

    • A origem da migração executa um sistema Debian com versão de kernel 3.x ou anterior e possui um disco com um sistema de arquivos XFS montado.

    true
    Part

    array<object>

    Não

    As informações de partição do disco em nuvem do sistema.

    object

    Não

    As informações de partição do disco em nuvem do sistema.

    SizeBytes

    integer

    Não

    O tamanho da partição do disco em nuvem do sistema. Unidade: bytes.

    254803968
    Block

    boolean

    Não

    Especifica se a replicação em bloco deve ser ativada para a partição do disco em nuvem do sistema.

    true
    Path

    string

    Não

    O caminho da partição do disco em nuvem do sistema.

    /boot
    Data

    array<object>

    Não

    As informações de partição do disco de dados em nuvem.

    array<object>

    Não

    As informações de partição do disco de dados em nuvem.

    Size

    integer

    Não

    O tamanho do disco de dados em nuvem na origem de migração. Unidade: GiB.

    80
    LVM

    boolean

    Não

    Especifica se o LVM deve ser usado para o disco de dados em nuvem. Valores válidos:

    DiskId

    string

    Não

    O ID do disco de dados em nuvem.

    d-2ze8hyowhdgd6ou2m5z6
    Part

    array<object>

    Não

    As informações de partição do disco de dados em nuvem.

    object

    Não

    As informações de partição do disco de dados em nuvem.

    SizeBytes

    integer

    Não

    O tamanho da partição do disco de dados em nuvem. Unidade: bytes.

    21474836480
    Block

    boolean

    Não

    Especifica se a replicação de blocos está ativada para a partição do disco em nuvem de dados. Valores válidos:

    • true: A replicação de blocos está ativada para a partição do disco em nuvem de dados.

    • false: A replicação de blocos não está ativada para a partição do disco em nuvem de dados.

    true
    Path

    string

    Não

    O caminho da partição do disco de dados em nuvem.

    /home/date

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    RequestId

    string

    O ID da solicitação.

    C8B26B44-0189-443E-9816-D951F59623A9
    JobId

    string

    O ID da tarefa de migração.

    j-bp17bclvg344jlyt****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  "JobId": "j-bp17bclvg344jlyt****"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 ReplicationJobDataDiskIndex.Invalid The specified replication job contains data disk index not found in source server.
    400 VSwitchIdVpcId.Mismatch The specified VSwitchId and VpcId does not match.
    400 InvalidSecurityGroupId.IncorrectNetworkType The network type of the specified security group does not support this action.
    400 InvalidSecurityGroupId.VPCMismatch The specified security group and the specified virtual switch are not in the same VPC.
    400 QuotaExceeded.ReplicationJob The maximum number of replication jobs is exceeded. Please submit a ticket to raise the quota.
    400 ReplicationJobName.Duplicate The specified replication job name already exists.
    400 SourceServerState.Invalid The specified source server status: %s is invalid. This operation can only be performed in the following status: %s.
    400 ImageName.UsedByReplicationJob The specified imageName: "%s" was used by another replication job in the current region.
    400 InvalidOsMigrationType.NotMatched The SourceOsType: %s and TargetOsType: %s are not matched. The supported TargetOsType list is: %s.
    500 InternalError An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.
    403 EntityNotExist.Role The account is unauthorized. Please assign the role AliyunServiceRoleForSMC to your account.
    403 RealNameAuthenticationError You must perform real-name verification for your account.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.