Todos os produtos
Search
Central de documentação

Server Migration Center:CreateCrossZoneMigrationJob

Última atualização: Jun 28, 2026

O Server Migration Center (SMC) permite migrar uma instância do Alibaba Cloud Elastic Compute Service (ECS) para uma zona diferente dentro da mesma região e alterar seu tipo de instância, incluindo vCPU e memória, dentro da mesma família de instâncias. Esse recurso ajuda a atender aos requisitos de negócios para migração de instâncias e alterações de especificações. Chame esta operação para criar um trabalho de migração entre zonas.

Descrição da operação

Para mais informações sobre os limites e efeitos da migração entre zonas, consulte Migração entre zonas.

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:CreateCrossZoneMigrationJob

create

*All Resource

*

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.

Por exemplo, se você deseja migrar um servidor de origem para a região China (Hangzhou), o ID da região é cn-hangzhou. Você pode chamar DescribeRegions para visualizar a lista mais recente de regiões do Alibaba Cloud.

cn-hangzhou

ClientToken

string

Não

Um token de cliente para garantir a idempotência da solicitação. Gere um valor exclusivo para este parâmetro a partir do seu cliente. `ClientToken` pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.

123e4567-e89b-12d3-a456-426655440000

InstanceId

string

Não

O ID da instância ECS.

i-bp1ff25rzvnul6kr****

TargetVSwitchId

string

Não

O ID do vSwitch de destino.

vsw-bp1mxqnssl8nafltc****

TargetZoneId

string

Não

O ID da zona de destino.

cn-hangzhou-i

TargetInstanceType

string

Não

O tipo de instância de destino.

ecs.g7.large

AutoPay

boolean

Não

Especifica se o pagamento automático deve ser ativado. Valores válidos:

  • true: (Padrão) Ativa o pagamento automático. Certifique-se de que sua conta tenha saldo suficiente.

  • false: Desativa o pagamento automático. Nesse caso, você deve concluir o pagamento manualmente. Para mais informações, consulte Renovar manualmente uma instância por assinatura.

false

Disk

array<object>

Não

As informações do disco.

object

Não

Um objeto de disco.

DiskId

string

Não

O ID do disco.

d-bp1eeplkn4j29wf7****

Category

string

Não

A categoria do disco. `cloud_essd` indica um Enhanced SSD (ESSD).

cloud_essd

PerformanceLevel

string

Não

O nível de desempenho do ESSD. Valores válidos:

  • PL0: Um único disco pode fornecer até 10.000 IOPS de leitura/gravação aleatória.

  • PL1: Um único disco pode fornecer até 50.000 IOPS de leitura/gravação aleatória.

  • PL2: Um único disco pode fornecer até 100.000 IOPS de leitura/gravação aleatória.

  • PL3: Um único disco pode fornecer até 1.000.000 IOPS de leitura/gravação aleatória.

PL0

ResourceGroupId

string

Não

O ID do grupo de recursos.

rg-acfmw3ty5y7****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

RequestId

string

O ID da solicitação.

A9DBD2F8-DE5A-5844-BA6F-957A996CBD78

JobId

string

O ID do trabalho de migração.

j-bp17bclvg344jlyt****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "A9DBD2F8-DE5A-5844-BA6F-957A996CBD78",
  "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. The specified replication job contains data disk indexes that do not exist in the source server.
400 VSwitchIdVpcId.Mismatch The specified VSwitchId and VpcId does not match. The specified VSwitchId and VpcId does not match.
400 InvalidSecurityGroupId.IncorrectNetworkType The network type of the specified security group does not support this action. 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. 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. 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. 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. The specified source server status: %s is invalid. This operation can only be performed in the following status: %s.
500 InternalError An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. 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. The account does not have the operation permission, please assign the account AliyunServiceRoleForSMC role.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.