CreateReplicationJob - : Central de Documentação do Alibaba Cloud

Observações de uso

É possível criar tarefas de migração apenas para servidores de origem no estado Available.
Cada servidor de origem pode ter apenas uma tarefa de migração associada nos estados Ready, Running, Stopped, Waiting, InError ou Expired.
Cada conta Alibaba Cloud permite criar no máximo 1.000 tarefas de migração.
Ao migrar um servidor de origem para uma imagem, especifique os parâmetros ImageName, SystemDiskSize e DataDisk.
Para migrações via virtual private cloud (VPC), o parâmetro VSwitchId é obrigatório, enquanto VpcId é opcional.
O Server Migration Center (SMC) permite migrar servidores de origem para imagens de contêiner Docker, facilitando a migração econômica de aplicações conteinerizadas.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateReplicationJob	Operação a ser executada. Defina o valor como CreateReplicationJob.
RegionId	String	Sim	cn-hangzhou	ID da região da Alibaba Cloud para onde migrar o servidor de origem. Por exemplo, para migrar o servidor de origem para a região China (Hangzhou), defina este parâmetro como `cn-hangzhou`. Chame a operação DescribeRegions para consultar as regiões mais recentes.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	Token do cliente usado para garantir a idempotência da solicitação. Gere o token no cliente e garanta que seja único entre solicitações diferentes. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.
Name	String	Não	testMigrationTaskName	Nome da tarefa de migração. Requisitos: Deve ser único. Deve ter entre 2 e 128 caracteres, podendo conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-). Deve começar com uma letra, mas não pode iniciar com `http://` ou `https://`.
Description	String	Não	This_is_a_migration_task	Descrição da tarefa de migração. Deve ter entre 2 e 128 caracteres, podendo conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-). Deve começar com uma letra, mas não pode iniciar com `http://` ou `https://`.
SourceId	String	Sim	s-bp1e2fsl57knvuug****	ID do servidor de origem.
TargetType	String	Não	Image	Tipo de destino para a migração do servidor de origem. Valores válidos: Image: Após a conclusão da tarefa, o SMC gera uma imagem do Elastic Compute Service (ECS) para o servidor de origem. ContainerImage: Após a conclusão da tarefa, o SMC gera uma imagem de contêiner Docker para o servidor de origem. TargetInstance: Após a conclusão da tarefa, o SMC migra o servidor de origem para a instância de destino. Se definir este parâmetro como TargetInstance, defina também o parâmetro `InstanceId`.
ScheduledStartTime	String	Não	2019-06-04T13:35:00Z	Horário programado para executar a tarefa de migração. Requisitos: Especificado no padrão ISO 8601, no formato AAAA-MM-DDThh:mm:ssZ. Por exemplo, 2018-01-01T12:00:00Z representa 20:00:00 em 1º de janeiro de 2018 (UTC+8). O valor deve estar dentro de 30 dias após o horário atual. Nota Se você não especificar este parâmetro, inicie manualmente a tarefa de migração após a criação. Chame a operação StartReplicationJob para iniciar a tarefa.
ValidTime	String	Não	2019-06-04T13:35:00Z	Horário de expiração da tarefa de migração. É possível agendar a expiração entre 7 e 90 dias após a criação da tarefa. Especificado no padrão ISO 8601, no formato AAAA-MM-DDThh:mm:ssZ. Por exemplo, 2018-01-01T12:00:00Z representa 20:00:00 em 1º de janeiro de 2018 (UTC+8). Se este parâmetro não for especificado, a tarefa de migração não expirará. Quando a tarefa expira, seu estado muda para Expired. O SMC retém a tarefa por sete dias após a expiração e, em seguida, a exclui. Por padrão, a tarefa de migração permanece válida por 30 dias após a criação.
ImageName	String	Não	testAliCloudImageName	Nome da imagem de destino. Requisitos: Deve ser único dentro de uma região da Alibaba Cloud. Deve ter entre 2 e 128 caracteres, podendo conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-). Deve começar com uma letra, mas não pode iniciar com `http://` ou `https://`. Nota Se você especificar um nome de imagem já existente na região de destino, o ID da tarefa de migração será anexado ao nome da imagem como sufixo. Exemplo: ImageName_j-2zexxxxxxxxxxxxx.
InstanceId	String	Não	i-bp1f1dvfto1sigz5****	ID da instância ECS de destino.
SystemDiskSize	Integer	Não	80	Tamanho do disco do sistema da instância ECS de destino. Unidade: GiB. Valores válidos: 20 a 2048. Nota O valor deve ser maior que o espaço utilizado no disco do sistema do servidor de origem. Por exemplo, se o tamanho total do disco de origem for 500 GiB e o espaço utilizado for 100 GiB, o valor deste parâmetro deve ser superior a 100 GiB.
VpcId	String	Não	vpc-bp1vwnn14rqpyiczj****	ID de uma VPC configurada com um circuito Express Connect ou um gateway VPN.
VSwitchId	String	Não	vsw-bp1ddbrxdlrcbim46****	ID do vSwitch na VPC especificada. Este parâmetro é obrigatório ao usar uma VPC para migrar dados.
ReplicationParameters	String	Não	{"bandwidth_limit":0,"compress_level":1,"checksum":true}	Parâmetros do driver de replicação. Especifique-os como pares chave-valor no formato JSON. As chaves são fixas para cada tipo de driver. A string JSON pode ter até 2.048 caracteres. O driver de replicação é a ferramenta usada para migrar o servidor de origem para uma instância intermediária. Os parâmetros variam conforme o tipo de driver. Ao usar o driver Server Migration Tool (SMT), você pode especificar os seguintes parâmetros: bandwidth_limit: largura de banda máxima para transmissão de dados. compress_level: taxa de compressão dos dados a serem transmitidos. checksum: indica se a verificação de checksum deve ser ativada. Para mais detalhes sobre drivers de replicação, consulte o parâmetro de resposta `SourceServers.ReplicationDriver` da operação DescribeSourceServers.
NetMode	Integer	Não	0	Modo de rede para transmissão de dados. Valores válidos: 0: Transmissão pela Internet. Certifique-se de que o servidor de origem tenha acesso à Internet. 2: Transmissão via VPC. Ao escolher este valor, especifique o parâmetro VSwitchId. Não é necessário especificar VpcId, pois seu valor é obtido automaticamente a partir do VSwitchId. Valor padrão: 0
RunOnce	Boolean	Não	true	Indica se a migração incremental deve ser desativada para o servidor de origem. Valores válidos: true: cria uma tarefa de migração executada apenas uma vez. Este é o valor padrão. Dados incrementais do servidor de origem não são sincronizados. false: cria uma tarefa de migração incremental. Neste caso, especifique o parâmetro `Frequency`. O SMC sincroniza os dados incrementais do servidor de origem para a Alibaba Cloud na frequência definida. Essa modalidade permite sincronizar dados sem interromper seus negócios, gerando uma imagem completa dos dados durante a execução da tarefa. Nota Este parâmetro só pode ser definido no momento da criação da tarefa. Não é possível alterá-lo posteriormente.
Frequency	Integer	Não	12	Intervalo em que o SMC sincroniza dados incrementais para a Alibaba Cloud. Unidade: horas. Valores válidos: 1 a 168. Parâmetro obrigatório quando `RunOnce` for definido como false. Vazio por padrão.
MaxNumberOfImageToKeep	Integer	Não	10	Número máximo de imagens retidas para a tarefa de migração incremental. Valores válidos: 1 a 10. Parâmetro obrigatório quando `RunOnce` for definido como false. Vazio por padrão.
InstanceType	String	Não	ecs.c6.large	Tipo da instância intermediária. Chame a operação DescribeInstanceTypes para consultar os tipos de instância ECS disponíveis. Se especificado, o SMC cria uma instância intermediária com o tipo indicado. Caso o tipo esteja indisponível, a criação da tarefa falhará. Se omitido, o SMC seleciona automaticamente um tipo disponível seguindo uma ordem específica para criar a instância intermediária. Para mais informações, consulte as Perguntas frequentes do SMC.
LaunchTemplateId	String	Não	lt-bp16jovvln1cgaaq****	ID do modelo de inicialização.
LaunchTemplateVersion	String	Não	1	Número da versão do modelo de inicialização.
InstanceRamRole	String	Não	SMCAdmin	Nome da função RAM atribuída à instância.
ContainerNamespace	String	Não	testNamespace	Namespace da imagem de contêiner Docker de destino. Para mais informações sobre imagens de contêiner Docker, consulte Termos.
ContainerRepository	String	Não	testRepository	Repositório que armazena a imagem de contêiner Docker de destino. Para mais informações sobre imagens de contêiner Docker, consulte Termos.
ContainerTag	String	Não	CentOS:v1	Tag da imagem de contêiner Docker de destino. Para mais informações sobre imagens de contêiner Docker, consulte Termos.
LicenseType	String	Não	BYOL	Tipo de licença. Valores válidos: Valor vazio indica ausência de licença. BYOL indica Bring Your Own License (Traga Sua Própria Licença). Para mais informações, consulte as Perguntas frequentes do SMC.
DataDisk.N.Index	Integer	Não	1	Índice do disco de dados N na instância ECS de destino. Os discos de dados seguem uma ordem sequencial iniciando em 1. Valores válidos: 1 a 16. Nota Para criar um disco de dados de destino, certifique-se de que o servidor de origem possua discos de dados.
DataDisk.N.Part.N.SizeBytes	Long	Não	254803968	Tamanho da partição N no disco de dados de destino. Unidade: bytes. O valor padrão corresponde ao tamanho da partição equivalente no disco de dados de origem. Nota A soma dos tamanhos de todas as partições não pode exceder o tamanho total do disco de dados de destino. Defina ambos os parâmetros `DataDisk.N.Part.N.Device` e DataDisk.N.Part.N.SizeBytes ou deixe ambos vazios.
DataDisk.N.Part.N.Block	Boolean	Não	true	Indica se a replicação em bloco deve ser ativada para a partição N no disco de dados de destino. Valores válidos: true false Valor padrão: true.
DataDisk.N.Part.N.Device	String	Não	0_1	ID do dispositivo da partição N no disco de dados de destino. As partições seguem a mesma ordem sequencial do disco de origem. Nota Defina ambos os parâmetros DataDisk.N.Part.N.Device e `DataDisk.N.Part.N.SizeBytes` ou deixe ambos vazios.
DataDisk.N.Size	Integer	Não	100	Tamanho do disco de dados na instância ECS de destino. Unidade: GiB. Valores válidos: 20 a 32768. Nota O tamanho do disco de destino deve ser maior que o volume de dados ocupado no disco de origem. Por exemplo, se o disco de origem tiver 500 GiB e 100 GiB estiverem em uso, defina este parâmetro com um valor superior a 100.
Tag.N.Key	String	Não	TestKey	Chave da tag da tarefa de migração. Valores válidos para N: 1 a 20. A chave não pode ser uma string vazia. Pode ter até 128 caracteres e não pode começar com `aliyun`, `acs:`, `http://` ou `https://`.
Tag.N.Value	String	Não	TestValue	Valor da tag da tarefa de migração. Valores válidos para N: 1 a 20. O valor pode ser uma string vazia. Pode ter até 128 caracteres e não pode começar com `aliyun`, `acs:`, `http://` ou `https://`.
SystemDiskPart.N.SizeBytes	Long	Não	254803968	Tamanho da partição N no disco do sistema de destino. Unidade: bytes. O valor padrão corresponde ao tamanho da partição no disco do sistema de origem. Nota A soma dos tamanhos de todas as partições não pode exceder o tamanho total do disco do sistema de destino. Defina ambos os parâmetros `SystemDiskPart.N.Device` e SystemDiskPart.N.SizeBytes ou deixe ambos vazios.
SystemDiskPart.N.Block	Boolean	Não	true	Indica se a replicação em bloco deve ser ativada para a partição N no disco do sistema de destino. Valores válidos: true false Valor padrão: true.
SystemDiskPart.N.Device	String	Não	0_1	ID da partição N no disco do sistema de destino. As partições seguem a mesma ordem sequencial do disco do sistema de origem. Nota Defina ambos os parâmetros SystemDiskPart.N.Device e `SystemDiskPart.N.SizeBytes` ou deixe ambos vazios.
JobType	Integer	Não	0	Tipo da tarefa de migração. Valores válidos: 0: migração de servidor 1: migração de sistema operacional 2: migração entre zonas 3: migração sem agente para VM VMware
ResourceGroupId	String	Não	rg-acfmw3ty5y7****	ID do grupo de recursos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	C8B26B44-0189-443E-9816-D951F59623A9	ID da solicitação.
JobId	String	j-bp17bclvg344jlyt****	ID da tarefa de migração.

Exemplos

Exemplos de solicitações

http(s)://smc.aliyuncs.com/?Action=CreateReplicationJob
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Name=testMigrationTaskName
&Description=This_is_a_migration_task
&SourceId=s-bp1e2fsl57knvuug****
&TargetType=Image
&ScheduledStartTime=2019-06-04T13:35:00Z
&ValidTime=2019-06-04T13:35:00Z
&ImageName=testAliCloudImageName
&InstanceId=i-bp1f1dvfto1sigz5****
&SystemDiskSize=80
&VpcId=vpc-bp1vwnn14rqpyiczj****
&VSwitchId=vsw-bp1ddbrxdlrcbim46****
&ReplicationParameters={"bandwidth_limit":0,"compress_level":1,"checksum":true}
&NetMode=0
&RunOnce=true
&Frequency=12
&MaxNumberOfImageToKeep=10
&InstanceType=ecs.c6.large
&LaunchTemplateId=lt-bp16jovvln1cgaaq****
&LaunchTemplateVersion=1
&InstanceRamRole=SMCAdmin
&ContainerNamespace=testNamespace
&ContainerRepository=testRepository
&ContainerTag=CentOS:v1
&LicenseType=BYOL
&DataDisk=[{"Index":1,"Part":[{"SizeBytes":254803968,"Block":true,"Device":"0_1"}],"Size":100}]
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&SystemDiskPart=[{"SizeBytes":254803968,"Block":true,"Device":"0_1"}]
&JobType=0
&ResourceGroupId=rg-acfmw3ty5y7****
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateReplicationJobResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <JobId>j-bp17bclvg344jlyt****</JobId>
</CreateReplicationJobResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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	SourceServerState.Invalid	The specified source server status is invalid.	Erro retornado porque a origem da migração está em um estado inválido e a operação não é suportada.
400	ReplicationJobDataDiskIndex.Invalid	The specified replication job contains data disk index not found in source server.	Erro retornado porque a tarefa de migração especifica um ou mais índices de disco de dados inexistentes no servidor de origem.
400	VSwitchIdVpcId.Mismatch	The specified VSwitchId and VpcId does not match.	Erro retornado porque os valores especificados para VSwitchId e VpcId não correspondem.
400	InvalidSecurityGroupId.IncorrectNetworkType	The network type of the specified security group does not support this action.	Erro retornado porque o tipo de rede do grupo de segurança não suporta esta operação.
400	InvalidSecurityGroupId.VPCMismatch	The specified security group and the specified virtual switch are not in the same VPC.	Erro retornado porque o grupo de segurança e o vSwitch especificados não pertencem à mesma VPC.
400	QuotaExceeded.ReplicationJob	The maximum number of replication jobs is exceeded. Please submit a ticket to raise the quota.	Erro retornado porque o número máximo de tarefas de migração foi atingido. Abra um ticket para solicitar aumento de cota.
400	ReplicationJobName.Duplicate	The specified replication job name already exists.	Erro retornado porque o nome da tarefa de migração já existe. Escolha outro nome.
500	InternalError	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.	Erro interno ocorrido. Tente novamente mais tarde. Se o problema persistir, abra um ticket.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.