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

Observações de uso

Antes de modificar os parâmetros de uma tarefa de migração, observe as seguintes informações:

Os parâmetros Name e Description podem ser modificados durante todo o ciclo de vida da tarefa de migração.
Os parâmetros Frequency e MaxNumberOfImageToKeep só podem ser alterados antes da execução da tarefa ou quando ela estiver no estado Waiting.
Demais parâmetros aceitam modificações apenas antes do início da tarefa de migração.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Não	ModifyReplicationJobAttribute	A operação a ser executada. Defina o valor como ModifyReplicationJobAttribute.
JobId	String	Não	j-bp19vlwm0tyigbmj****	O ID da tarefa de migração.
Name	String	Não	testMigrationTaskName	O nome da tarefa de migração. O nome deve atender aos seguintes requisitos: O nome deve ser único. O nome deve ter entre 2 e 128 caracteres e pode conter letras, 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_my_migration_task	A descrição da tarefa de migração. A descrição deve ter entre 2 e 128 caracteres e pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-). Deve começar com uma letra, mas não pode iniciar com `http://` ou `https://`.
TargetType	String	Não	Image	O tipo de destino para o qual o servidor de origem será migrado. Este valor só pode ser modificado antes do início da tarefa de migração. Valores válidos: Image: Após a conclusão da tarefa, o Server Migration Center (SMC) gera uma imagem de destino do Elastic Compute Service (ECS) para o servidor de origem. Use essa imagem para criar uma instância ECS. ContainerImage: Ao finalizar a migração, o SMC produz uma imagem de contêiner para o servidor de origem. Essa imagem fica disponível no Container Registry. TargetInstance: Quando a tarefa termina, o SMC migra o servidor de origem diretamente para a instância de destino. Caso selecione TargetInstance, defina o parâmetro `InstanceId`. Nota Este parâmetro não diferencia maiúsculas de minúsculas. O SMC não permite migrar servidores Windows ou sistemas operacionais baseados na arquitetura ARM para o Container Registry.
ScheduledStartTime	String	Não	2019-06-04T13:35:00Z	O horário programado para execução da tarefa de migração. O SMC iniciará o processo no momento especificado. Especifique o horário no padrão ISO 8601, no formato AAAA-MM-DDThh:mm:ssZ. O tempo deve estar em UTC. Por exemplo, 2018-01-01T12:00:00Z corresponde às 20:00:00 de 1º de janeiro de 2018 (UTC+8). Nota Se este parâmetro não for definido, o SMC não iniciará a tarefa automaticamente. Chame a operação StartReplicationJob para iniciá-la manualmente.
ImageName	String	Não	testAliCloudImageName	O nome da imagem de destino. O nome deve atender aos seguintes requisitos: Deve ser exclusivo dentro de uma região da Alibaba Cloud. Deve ter entre 2 e 128 caracteres, podendo incluir letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-). É obrigatório começar com uma letra e não pode iniciar com `http://` ou `https://`. Nota Caso já exista uma imagem com o mesmo nome na região onde a tarefa está sendo executada, o ID da tarefa será adicionado como sufixo ao nome da imagem. Exemplo: ImageName-JobId.
InstanceId	String	Não	i-bp1f1dvfto1sigz5****	O ID da instância ECS de destino.
SystemDiskSize	Integer	Não	50	O tamanho do disco do sistema da instância ECS de destino. Unidade: GiB. Valores válidos: 20 a 500. Nota O valor informado deve ser superior ao espaço utilizado no disco do sistema do servidor de origem. Por exemplo, se o disco de origem possui 500 GiB de capacidade total e 100 GiB de dados ocupados, defina este parâmetro com um valor maior que 100 GiB.
Frequency	Integer	Não	10	O intervalo de execução para tarefas de migração incremental. Unidade: horas. Valores válidos: 1 a 168. Este parâmetro é obrigatório quando o parâmetro `RunOnce` estiver definido como false.
MaxNumberOfImageToKeep	Integer	Não	5	Quantidade máxima de imagens retidas em uma migração incremental. Valores válidos: 1 a 10. Configuração necessária caso o parâmetro `RunOnce` seja false.
InstanceType	String	Não	ecs.c5.large	O tipo da instância intermediária. Chame a operação DescribeInstanceTypes para consultar os tipos de instância disponíveis no ECS. Ao especificar este parâmetro, o SMC cria uma instância intermediária do tipo indicado. Se o tipo escolhido não estiver disponível, a criação da tarefa de migração falhará. Sem essa especificação, o SMC seleciona automaticamente um tipo disponível seguindo uma ordem predefinida. Para mais detalhes sobre os tipos de instância intermediária suportados, consulte o Perguntas frequentes do SMC.
LaunchTemplateId	String	Não	lt-bp16jovvln1cgaaq****	O ID do modelo de inicialização.
LaunchTemplateVersion	String	Não	Latest	O número da versão do modelo de inicialização.
InstanceRamRole	String	Não	SMCAdmin	A função RAM anexada à instância intermediária.
ContainerNamespace	String	Não	testNamespace	O 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	O 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	A tag da imagem de contêiner Docker de destino. Para mais informações sobre imagens de contêiner Docker, consulte Termos.
ValidTime	String	Não	2019-06-04T13:35:00Z	O momento em que a tarefa de migração expira. É possível agendar a expiração entre 7 e 90 dias após a criação da tarefa. Esta configuração só é permitida quando a tarefa estiver nos estados Ready, Running, Stopped, InError ou Waiting. Informe o horário no padrão ISO 8601, formato `AAAA-MM-DDThh:mm:ssZ`, obrigatoriamente em UTC. Como exemplo, 2018-01-01T12:00:00Z representa 20:00:00 em 1º de janeiro de 2018 (UTC+8). A ausência deste parâmetro implica que a tarefa não terá data de expiração. Ao expirar, o status da tarefa muda para Expired. O SMC mantém a tarefa por sete dias após a expiração e, passado esse período, a exclui definitivamente. Por padrão, a validade da tarefa de migração é de 30 dias a partir da criação.
SystemDiskPart.N.SizeBytes	Long	Não	254803968	O 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 do tamanho de todas as partições não pode ultrapassar a capacidade total do disco do sistema de destino.
SystemDiskPart.N.Block	Boolean	Não	true	Define se a replicação em bloco estará ativada para a partição N do disco do sistema de destino. Valores válidos: true false
SystemDiskPart.N.Device	String	Não	0_1	O ID do dispositivo da partição N no disco do sistema de destino. Nota As partições do disco de sistema de destino seguem a mesma ordem sequencial das partições do disco de origem.
DataDisk.N.Index	Integer	Não	1	O índice do disco de dados N na instância ECS de destino. Valores válidos: 1 a 16. Os discos de dados na instância ECS de destino são organizados em ordem sequencial iniciando em 1. 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	O tamanho da partição N no disco de dados de destino. Unidade: bytes. O valor padrão equivale ao tamanho da partição correspondente no disco de origem. Nota O tamanho total das partições não pode exceder a capacidade do disco de dados de destino.
DataDisk.N.Part.N.Block	Boolean	Não	true	Indica se a replicação em bloco deve ser habilitada na partição N do disco de dados de destino. Valores válidos: true false
DataDisk.N.Part.N.Device	String	Não	0_1	O ID do dispositivo referente à partição N no disco de dados de destino. Nota A ordenação das partições no disco de dados de destino respeita a sequência original do disco de origem.
DataDisk.N.Size	Integer	Não	100	A capacidade do disco de dados da instância ECS de destino. Unidade: GiB. Valores válidos: 20 a 32768. Nota O tamanho do disco de destino precisa ser maior que o volume de dados existente no disco de origem. Por exemplo, se houver 100 GiB de dados em um disco de 500 GiB, configure este parâmetro com um valor superior a 100 GiB.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	1C488B66-B819-4D14-8711-C4EAAA13AC01	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://smc.aliyuncs.com/?Action=ModifyReplicationJobAttribute
&JobId=j-bp19vlwm0tyigbmj****
&Name=testMigrationTaskName
&Description=This_is_my_migration_task
&TargetType=Image
&ScheduledStartTime=2019-06-04T13:35:00Z
&ImageName=testAliCloudImageName
&InstanceId=i-bp1f1dvfto1sigz5****
&SystemDiskSize=50
&Frequency=10
&MaxNumberOfImageToKeep=5
&InstanceType=ecs.c5.large
&LaunchTemplateId=lt-bp16jovvln1cgaaq****
&LaunchTemplateVersion=Latest
&InstanceRamRole=SMCAdmin
&ContainerNamespace=testNamespace
&ContainerRepository=testRepository
&ContainerTag=CentOS:v1
&ValidTime=2019-06-04T13:35:00Z
&SystemDiskPart=[{"SizeBytes":254803968,"Block":true,"Device":"0_1"}]
&DataDisk=[{"Index":1,"Part":[{"SizeBytes":254803968,"Block":true,"Device":"0_1"}],"Size":100}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<ModifyReplicationJobAttributeResponse>
    <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</ModifyReplicationJobAttributeResponse>

Formato JSON

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

{
  "RequestId" : "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	DataDisk.DuplicateIndex	The source server data disk cannot contain the same index.	Mensagem retornada porque os discos de dados da origem da migração possuem índices duplicados.
400	ReplicationJob.InvalidStatus	The specified replication job status is invalid.	Mensagem retornada porque a tarefa de migração está em um status 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.	Mensagem retornada porque a tarefa especifica um ou mais índices de disco de dados inexistentes no servidor de origem.
400	ReplicationJobName.Duplicate	The specified replication job name already exists.	Mensagem retornada porque o nome da tarefa de migração já existe. Escolha outro nome para a tarefa.
500	InternalError	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.	Mensagem retornada devido a um erro interno. Tente novamente mais tarde. Se o erro persistir, abra um ticket.

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