Todos os produtos
Search
Central de documentação

:ModifyInstanceDeployment

Última atualização: Jul 04, 2026

Altera o conjunto de implantação de uma instância do Elastic Compute Service (ECS) ou migra uma instância do ECS para um host dedicado. É possível alterar o tipo da instância do ECS durante a migração.

Descrição

Ao chamar esta operação para uma instância do ECS, observe os seguintes itens:

  • A instância do ECS deve estar no estado Stopped. A instância é reiniciada automaticamente após a migração.

  • O tipo de rede da instância do ECS deve ser Virtual Private Cloud (VPC).

  • A instância do ECS e o host dedicado de destino devem pertencer à mesma conta e residir na mesma região e zona.

  • Instâncias do ECS com pagamento conforme o uso podem ser migradas para um host dedicado por assinatura. Instâncias do ECS por assinatura só podem ser migradas entre hosts dedicados por assinatura. A data de expiração da instância do ECS por assinatura não pode ser posterior à do host dedicado de destino.

  • Apenas instâncias do ECS com pagamento conforme o uso podem ser migradas de um host compartilhado para um host dedicado. Não é possível migrar instâncias por assinatura ou preemptíveis de um host compartilhado para um host dedicado.

  • É possível reimplantar uma instância do ECS em um cluster de hosts dedicados específico.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ModifyInstanceDeployment

A operação a ser executada. Defina o valor como ModifyInstanceDeployment.

RegionId String Sim cn-hangzhou

O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

InstanceId String Sim i-bp67acfmxazb4ph***

Os IDs das instâncias.

DedicatedHostId String Não dh-bp67acfmxazb4ph****

O ID do host dedicado de destino. Chame a operação DescribeDedicatedHosts para consultar a lista mais recente de hosts dedicados.

Ao migrar uma instância de um host compartilhado para um host dedicado ou entre hosts dedicados, observe os seguintes itens:

  • Para migrar a instância para um host dedicado específico, especifique um valor para este parâmetro.
  • Para migrar a instância para um host dedicado selecionado pelo sistema, deixe este parâmetro vazio e defina Tenancy como host.

Para obter informações sobre o recurso de implantação automática, consulte Recursos de hosts dedicados.

DeploymentSetId String Não ds-bp67acfmxazb4ph****

O ID do conjunto de implantação de destino.

Este parâmetro é obrigatório ao adicionar uma instância do ECS a um conjunto de implantação ou ao alterar o conjunto de implantação de uma instância.

Nota Não é possível alterar o conjunto de implantação ao modificar as configurações de hosts dedicados, incluindo parâmetros como Tenancy, Affinity e DedicatedHostId.
DeploymentSetGroupNo Integer Não 3

O número do grupo do conjunto de implantação no qual a instância será implantada no conjunto de implantação de destino. Este parâmetro é válido apenas quando o conjunto de implantação de destino usa a estratégia de grupo de alta disponibilidade (AvailabilityGroup). Valores válidos: 1 a 7.

Nota Se você chamar esta operação para implantar uma instância em um conjunto de implantação que usa a estratégia de grupo de alta disponibilidade (AvailabilityGroup) e deixar este parâmetro vazio, o sistema distribuirá uniformemente as instâncias do ECS entre os grupos do conjunto de implantação. Se você chamar esta operação para alterar o conjunto de implantação de uma instância e especificar o conjunto de implantação atual da instância como destino, o sistema redistribuirá uniformemente as instâncias do ECS entre os grupos do conjunto de implantação.
Force Boolean Não false

Especifica se o host da instância deve ser alterado forçadamente quando o conjunto de implantação da instância for modificado. Valores válidos:

  • true: altera forçadamente o host da instância quando o conjunto de implantação da instância é modificado. Os hosts só podem ser alterados forçadamente para instâncias no estado Running ou Stopped. As instâncias no estado Stopped não incluem instâncias com pagamento conforme o uso paradas no modo econômico.
    Nota Se a instância do ECS especificada tiver discos locais anexados, os discos locais serão alterados forçadamente quando o host da instância for alterado forçadamente. Isso pode causar perda de dados nos discos locais. Proceda com cautela.
  • false: não altera forçadamente o host da instância quando o conjunto de implantação da instância é modificado. Você só pode adicionar a instância a um conjunto de implantação se ela permanecer no host atual. Quando o parâmetro Force é definido como false, a alteração do conjunto de implantação pode falhar.

Valor padrão: false.

Affinity String Não host

Especifica se a instância deve ser associada a um host dedicado. Valores válidos:

  • host: associa a instância a um host dedicado. Ao iniciar uma instância parada no modo econômico, a instância permanece em seu host dedicado original.
  • default: não associa a instância a um host dedicado. Ao iniciar uma instância parada no modo econômico, a instância pode ser implantada automaticamente em outro host dedicado no pool de recursos de implantação automática se os recursos do host dedicado original forem insuficientes.

Para migrar a instância de um host compartilhado para um host dedicado, use o valor padrão. Valor padrão: default.

Tenancy String Não host

Especifica se a instância deve ser implantada em um host dedicado. Defina o valor como host para implantar a instância em um host dedicado.

MigrationType String Não live

Especifica se a instância deve ser parada antes de ser migrada para o host dedicado de destino. Valores válidos:

  • reboot: para a instância antes da migração.
  • live: migra a instância sem pará-la. Se você definir o parâmetro MigrationType como live, deverá especificar o parâmetro DedicatedHostId. Nesse caso, não é possível alterar o tipo da instância do ECS durante a migração.

Valor padrão: reboot.

InstanceType String Não ecs.c6.large

O novo tipo da instância. Chame a operação DescribeInstanceTypes para consultar a lista mais recente de tipos de instância.

É possível alterar o tipo da instância do ECS ao migrar a instância para um host dedicado. O novo tipo de instância deve corresponder ao tipo do host dedicado especificado. Para obter mais informações, consulte Tipos de hosts dedicados.

  • Se você especificar este parâmetro, também deverá especificar o parâmetro DedicatedHostId.
  • Não é possível alterar o tipo da instância do ECS se você usar o recurso de implantação automática para migrar a instância.
DedicatedHostClusterId String Não dc-bp67acfmxazb4ph****

O ID do cluster de hosts dedicados.

RemoveFromDeploymentSet Boolean Não false

Especifica se a instância selecionada deve ser removida do conjunto de implantação selecionado. Valores válidos:

  • true.
  • false.

Valor padrão: false.

Nota Se você definir este parâmetro como true, deverá especificar o InstanceId da instância do ECS selecionada e o DeploymentSetId do conjunto de implantação ao qual a instância do ECS pertence.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

04F0F334-1335-436C-A1D7-6C044FE7****

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceDeployment
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph***
&DedicatedHostId=dh-bp67acfmxazb4ph****
&DeploymentSetId=ds-bp67acfmxazb4ph****
&Tenancy=host
&MigrationType=live
&DedicatedHostClusterId=dc-bp67acfmxazb4ph****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyInstanceDeploymentResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE7****</RequestId>
</ModifyInstanceDeploymentResponse>

Formato JSON

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE7****"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

OperationDenied.UnstoppedInstance

Operation denied due to unstopped instance.

Mensagem de erro retornada porque a operação atual é inválida. Verifique se a instância está no estado Stopped.

400

InvalidDedicatedHostStatus.NotSupport

Operation denied due to dedicated host status.

Mensagem de erro retornada porque a operação não é suportada enquanto o host dedicado está no estado atual.

400

InvalidPeriod.ExceededDedicatedHost

Instance expired date can't exceed dedicated host expired date.

Mensagem de erro retornada porque a data de expiração da instância é posterior à do host dedicado.

400

InvalidParam.Tenancy

The specified Tenancy is invalid.

Mensagem de erro retornada porque o parâmetro Tenancy especificado é inválido.

400

OperationDenied.InvalidInstance

The specified instance is not dedicated instance.

Mensagem de erro retornada porque a instância especificada não está implantada em um host dedicado.

400

ChargeTypeViolation.PostPaidDedicatedHost

Prepaid instance onto postpaid dedicated host is not allowed.

Mensagem de erro retornada porque instâncias por assinatura não podem ser implantadas em hosts dedicados com pagamento conforme o uso.

400

InvalidDedicatedHostId.NotFound

The specified DedicatedHostId does not exist.

Mensagem de erro retornada porque o parâmetro DedicatedHostId especificado não existe.

400

InvalidInstanceType.ValueNotSupported

The specified InstanceType does not exist or beyond the permitted range.

Mensagem de erro retornada porque o parâmetro InstanceType especificado não existe ou porque você não tem autorização para gerenciar instâncias do tipo de instância especificado.

403

IncorrectInstanceStatus

%s

Mensagem de erro retornada porque a operação não é suportada enquanto a instância está no estado atual.

403

OperationDenied.NoStock

The resource is out of usage.

Mensagem de erro retornada porque a instância não está no estado Running. Inicie a instância ou verifique se a operação é válida.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

Mensagem de erro retornada porque o ID da instância especificado não existe. Verifique se o ID da instância está correto.

404

InvalidInstanceNetworkType.NotSupport

The specified Instance network type not support.

Mensagem de erro retornada porque o tipo de rede da instância não suporta esta operação.

404

InvalidInstanceType.NotSupport

The Dedicated host not support the specified instance type.

Mensagem de erro retornada porque o host dedicado atual não suporta o tipo de instância especificado.

Para obter uma lista de códigos de erro, visite o API Error Center.