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

Modifica os atributos de uma tarefa de migração.

Descrição da operação

Antes de modificar uma tarefa de migração, leia as seguintes precauçõ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 modificados antes da execução da tarefa de migração ou quando o status da tarefa for Waiting.
Outros parâmetros só podem ser modificados antes da execução da tarefa de migraçã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:ModifyReplicationJobAttribute

update

*Tarefa de replicação.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
JobId	string	Sim	O ID da tarefa de migração.	j-bp19vlwm0tyigbmj****
Name	string	Não	O nome da tarefa de migração. O nome deve atender aos seguintes requisitos: O nome da tarefa deve ser exclusivo. 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 de meia largura (:), sublinhados (_) e hifens (-).	testMigrationTaskName
Description	string	Não	A descrição da tarefa de migração. A descrição 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 de meia largura (:), sublinhados (_) e hifens (-).	This_is_my_migration_task
TargetType	string	Não	O tipo de destino para a entrega da migração. Este parâmetro só pode ser modificado antes do início da tarefa de migração. Valores válidos: Image: Após a migração ser bem-sucedida, o SMC gera uma imagem do Alibaba Cloud para o seu servidor de origem. Você pode usar esta imagem para criar uma instância ECS e concluir a migração para o Alibaba Cloud. ContainerImage: Após a migração ser bem-sucedida, o SMC gera uma imagem de contêiner para o seu servidor de origem. Você pode usar esta imagem no Container Registry. TargetInstance: Após a migração ser bem-sucedida, o SMC migra sua origem de migração diretamente para a instância de destino. Ao definir este parâmetro, você também deve especificar o parâmetro InstanceId. Nota O valor deste parâmetro não diferencia maiúsculas de minúsculas. Os sistemas operacionais Windows e os sistemas operacionais baseados em ARM não suportam migração para imagens de contêiner.	Image
ScheduledStartTime	string	Não	O horário de execução agendado da tarefa de migração. O SMC inicia automaticamente a tarefa de migração no horário especificado. O horário de execução deve seguir o padrão ISO 8601 e usar o horário UTC no 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). Nota Se o horário de execução estiver vazio, o SMC não inicia automaticamente a tarefa de migração. Você deve chamar StartReplicationJob para iniciá-la.	2019-06-04T13:35:00Z
ImageName	string	Não	O nome da imagem de destino entregue pela tarefa de migração. O nome deve atender aos seguintes requisitos: O nome da imagem deve ser exclusivo 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 de meia largura (:), sublinhados (_) e hifens (-). Nota Se já existir uma imagem com o mesmo nome na região atual durante a tarefa de migração, o sistema acrescenta automaticamente o ID da tarefa de migração (JobId) ao nome da imagem como sufixo, como ImageName-JobId.	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 do servidor Elastic Computing Service de destino. Unidade: GiB. Valores válidos: 20 a 500. Nota O valor deste parâmetro deve ser maior que o espaço realmente utilizado do disco em nuvem do sistema do servidor de origem. Por exemplo, se o disco em nuvem do sistema de origem tiver 500 GiB de tamanho e 100 GiB forem realmente utilizados, o valor deste parâmetro deve ser maior que 100 GiB.	50
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 o parâmetro RunOnce é definido como false.	10
MaxNumberOfImageToKeep	integer	Não	O número máximo de imagens retidas por padrão para a tarefa de migração incremental. Valores válidos: 1 a 10. Este parâmetro é obrigatório quando o parâmetro RunOnce é definido como false.	5
InstanceType	string	Não	O tipo de instância da instância intermediária. Você pode invocar DescribeInstanceTypes para consultar os tipos de instância fornecidos pelo servidor Elastic Computing Service (ECS). Se você especificar este parâmetro, o sistema usará este tipo de instância para criar a instância intermediária. Se o estoque deste tipo de instância for insuficiente, a criação do nó de migração falhará. Se você não especificar este parâmetro, o sistema selecionará por padrão um tipo de instância em uma ordem específica para criar a instância intermediária. Para mais detalhes, consulte Quais são os tipos de instância das instâncias intermediárias nas perguntas frequentes do SMC.	ecs.c5.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.	Latest
InstanceRamRole	string	Não	O nome da função RAM da instância.	SMCAdmin
ContainerNamespace	string	Não	O namespace do 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
ValidTime	string	Não	O horário de expiração da tarefa de migração. Valores válidos: 7 dias a 90 dias após a criação da tarefa de migração. O horário de expiração só pode ser modificado quando a tarefa de migração estiver no estado Ready, Running, Stopped, InError ou Waiting. O horário de expiração deve seguir o padrão ISO 8601 e usar o horário UTC no 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). Se o horário de expiração estiver vazio, a tarefa será válida por tempo indeterminado. Após a expiração de uma tarefa, ela é marcada como expirada e retida por 7 dias. O sistema a limpa automaticamente após 7 dias. Valor padrão: 30 dias após a criação da tarefa de migração, o que significa que o período de validade padrão da tarefa de migração é de 30 dias após a criação.	2019-06-04T13:35:00Z
SystemDiskPart	array<object>	Não	A lista de partições 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 de destino. Unidade: bytes. Valor padrão: o tamanho da partição do disco em nuvem do sistema de origem. Nota O tamanho da partição não pode exceder o tamanho do disco em nuvem do sistema, e a soma de todos os tamanhos de partição no disco em nuvem do sistema não pode exceder o tamanho do disco em nuvem do sistema.	254803968
Block	boolean	Não	Especifica se a replicação de blocos deve ser ativada para a partição N do disco em nuvem do sistema de destino. Valores válidos: true false	true
Device	string	Não	O identificador de dispositivo da partição N do disco em nuvem do sistema de destino. Nota Para o valor real de N, consulte o identificador de dispositivo da partição da origem da migração.	0_1
DataDisk	array<object>	Não	A lista de discos em nuvem de dados.
	array<object>	Não	A lista de discos em nuvem de dados.
Index	integer	Não	O número de sequência do disco em nuvem de dados do servidor Elastic Computing Service de destino. Valores válidos: 1 a 16. Valor padrão: 1. Nota Você só pode criar discos em nuvem de dados de destino para discos em nuvem de dados que existam no servidor de origem.	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 do disco em nuvem de dados de destino. Unidade: bytes. Valor padrão: o tamanho da partição do disco em nuvem de dados de origem. Nota O tamanho da partição não pode exceder o tamanho do disco em nuvem de dados, e a soma de todos os tamanhos de partição no mesmo disco em nuvem de dados não pode exceder o tamanho do disco em nuvem de dados.	254803968
Block	boolean	Não	Especifica se a replicação de blocos deve ser ativada para a partição N do disco em nuvem de dados de destino. Valores válidos: true false	true
Device	string	Não	O identificador de dispositivo da partição N do disco em nuvem de dados de destino. Nota Para o valor real de N, consulte o identificador de dispositivo da partição da origem da migração.	0_1
Size	integer	Não	O tamanho do disco em nuvem de dados do servidor Elastic Computing Service de destino. Unidade: GiB. Valores válidos: 20 a 32768. Nota O valor deste parâmetro deve ser maior que o espaço realmente utilizado do disco em nuvem de dados do servidor de origem. Por exemplo, se o disco em nuvem de dados de origem tiver 500 GiB de tamanho e 100 GiB forem realmente utilizados, o valor deste parâmetro deve ser maior que 100 GiB.	100
NetMode	integer	Não	O modo de rede para transmissão de dados. Valores válidos: 0: Modo de transmissão pela Internet. Este modo exige que seu servidor de origem possa acessar a Internet. 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. O parâmetro VpcId é opcional porque o serviço pode consultá-lo internamente por meio de uma operação de API.	0
VSwitchId	string	Não	O ID do vSwitch na VPC especificada.	vsw-bp1ddbrxdlrcbim46****
VpcId	string	Não	O ID da VPC que está configurada com o Express Connect ou um gateway de VPN.	vpc-bp1vwnn14rqpyiczj****
ReplicationParameters	string	Não	As informações de parâmetro do driver de replicação. As informações de parâmetro são um par chave-valor formatado em JSON com chaves fixas. Comprimento máximo: 2048 caracteres. Um driver de replicação é uma ferramenta usada para replicar dados do servidor de origem para a instância intermediária. Diferentes drivers de replicação podem suportar diferentes parâmetros. O driver de replicação SMT atualmente suporta os seguintes parâmetros: bandwidth_limit: o limite de largura de banda para a velocidade de transmissão. compress_level: a taxa de compressão de transmissão. checksum: se a verificação de soma de verificação deve ser ativada. Para os valores do driver de replicação, consulte o parâmetro de resposta SourceServers.ReplicationDriver em DescribeSourceServers.	{"bandwidth_limit":0,"compress_level":1,"checksum":true}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	1C488B66-B819-4D14-8711-C4EAAA13AC01

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	DataDisk.DuplicateIndex	The source server data disk cannot contain the same index.
400	ReplicationJobDataDiskIndex.Invalid	The specified replication job contains data disk index not found in source server.
400	ReplicationJobName.Duplicate	The specified replication job name already exists.
400	ReplicationJob.InvalidStatus	The specified replication job status: %s is invalid. This operation can only be performed in the following status: %s.
400	ReplicationJob.InvalidBusinessStatus	The specified business status: %s of the replication job 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.
500	InternalError	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.