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 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:
Valor padrão: false. |
| Affinity | String | Não | host |
Especifica se a instância deve ser associada a um host dedicado. Valores válidos:
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:
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.
|
| 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:
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.