ModifyInstanceDeployment - - Centro de documentación de Alibaba Cloud

Cambia el conjunto de despliegue de una instancia de Elastic Compute Service (ECS) o migra una instancia de ECS a un host dedicado. También puede cambiar el tipo de instancia durante la migración.

Descripción

Al invocar esta operación para una instancia de ECS, tenga en cuenta lo siguiente:

La instancia de ECS debe encontrarse en estado Stopped. La instancia se reinicia automáticamente después de la migración.
El tipo de red de la instancia de ECS debe ser Virtual Private Cloud (VPC).
Tanto la instancia de ECS como el host dedicado de destino deben pertenecer a la misma cuenta y residir en la misma región y zona.
Una instancia de ECS pay-as-you-go se puede migrar a un host dedicado subscription. Las instancias de ECS subscription solo se pueden migrar entre hosts dedicados subscription. La fecha de vencimiento de la instancia de ECS subscription no puede ser posterior a la del host dedicado de destino.
Solo es posible migrar instancias de ECS pay-as-you-go de un host compartido a un host dedicado. No se admite la migración de instancias subscription ni preemptible instances de un host compartido a un host dedicado.
Es posible redesplegar una instancia de ECS en un clúster de hosts dedicados específico.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyInstanceDeployment	La operación que desea ejecutar. Establezca el valor en ModifyInstanceDeployment.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede invocar la operación DescribeRegions para consultar la lista más reciente de regiones.
InstanceId	String	Sí	i-bp67acfmxazb4ph***	Los ID de las instancias.
DedicatedHostId	String	No	dh-bp67acfmxazb4ph****	El ID del host dedicado de destino. Puede invocar la operación DescribeDedicatedHosts para consultar la lista más reciente de hosts dedicados. Al migrar una instancia de un host compartido a un host dedicado, o entre hosts dedicados, considere lo siguiente: Para migrar la instancia a un host dedicado específico, especifique un valor para este parámetro. Para migrar la instancia a un host dedicado seleccionado por el sistema, deje este parámetro vacío y establezca `Tenancy` en host. Para obtener información sobre la función de despliegue automático, consulte Funciones de los hosts dedicados.
DeploymentSetId	String	No	ds-bp67acfmxazb4ph****	El ID del conjunto de despliegue de destino. Este parámetro es obligatorio cuando agrega una instancia de ECS a un conjunto de despliegue o cambia el conjunto de despliegue de una instancia. Nota No es posible cambiar el conjunto de despliegue mientras modifica las configuraciones de los hosts dedicados, incluidos parámetros como `Tenancy`, `Affinity` y `DedicatedHostId`.
DeploymentSetGroupNo	Integer	No	3	El número del grupo de conjunto de despliegue donde se desplegará la instancia dentro del conjunto de despliegue de destino. Este parámetro solo es válido cuando el conjunto de despliegue de destino utiliza la estrategia de grupo de alta disponibilidad (AvailabilityGroup). Valores válidos: del 1 al 7. Nota Si invoca esta operación para desplegar una instancia en un conjunto de despliegue con estrategia de grupo de alta disponibilidad (`AvailabilityGroup`) y deja este parámetro vacío, el sistema distribuye uniformemente las instancias de ECS entre los grupos del conjunto de despliegue. Si invoca esta operación para cambiar el conjunto de despliegue de una instancia y especifica su conjunto de despliegue actual como destino, el sistema redistribuye uniformemente las instancias de ECS entre los grupos del conjunto de despliegue.
Force	Boolean	No	false	Especifica si se debe cambiar forzosamente el host de la instancia al modificar su conjunto de despliegue. Valores válidos: true: cambia forzosamente el host de la instancia al modificar su conjunto de despliegue. El cambio forzoso de host solo aplica a instancias en estado Running o Stopped. Las instancias en estado Stopped no incluyen aquellas pay-as-you-go detenidas en modo económico. Nota Si la instancia de ECS especificada tiene discos locales conectados, estos se cambian forzosamente junto con el host. Esto podría provocar pérdida de datos en los discos locales. Proceda con precaución. false: no cambia forzosamente el host de la instancia al modificar su conjunto de despliegue. Solo es posible agregar la instancia a un conjunto de despliegue si permanece en el host actual. Cuando el parámetro Force se establece en false, es posible que el cambio del conjunto de despliegue falle. Valor predeterminado: false.
Affinity	String	No	host	Especifica si se debe asociar la instancia con un host dedicado. Valores válidos: host: asocia la instancia con un host dedicado. Al iniciar una instancia detenida en modo económico, esta permanece en su host dedicado original. default: no asocia la instancia con un host dedicado. Al iniciar una instancia detenida en modo económico, esta se puede desplegar automáticamente en otro host dedicado dentro del pool de recursos de despliegue automático, siempre que los recursos del host original sean insuficientes. Si desea migrar la instancia de un host compartido a un host dedicado, utilice el valor predeterminado. Valor predeterminado: default.
Tenancy	String	No	host	Especifica si se debe desplegar la instancia en un host dedicado. Establezca el valor en host para desplegar la instancia en un host dedicado.
MigrationType	String	No	live	Especifica si se debe detener la instancia antes de migrarla al host dedicado de destino. Valores válidos: reboot: detiene la instancia antes de la migración. live: migra la instancia sin detenerla. Si establece el parámetro MigrationType en live, debe especificar el parámetro DedicatedHostId. En este caso, no es posible cambiar el tipo de instancia de ECS durante la migración. Valor predeterminado: reboot.
InstanceType	String	No	ecs.c6.large	El tipo de instancia al que se cambiará la instancia actual. Puede invocar la operación DescribeInstanceTypes para consultar la lista más reciente de tipos de instancia. Es posible cambiar el tipo de instancia de ECS al migrarla a un host dedicado. El nuevo tipo de instancia debe coincidir con el tipo del host dedicado especificado. Para obtener más información, consulte Tipos de hosts dedicados. Si especifica este parámetro, también debe especificar el parámetro `DedicatedHostId`. No es posible cambiar el tipo de instancia de ECS si utiliza la función de despliegue automático para migrar la instancia.
DedicatedHostClusterId	String	No	dc-bp67acfmxazb4ph****	El ID del clúster de hosts dedicados.
RemoveFromDeploymentSet	Boolean	No	false	Especifica si se debe eliminar la instancia seleccionada del conjunto de despliegue correspondiente. Valores válidos: true. false. Valor predeterminado: false. Nota Si establece este parámetro en true, debe especificar el InstanceId de la instancia de ECS seleccionada y el DeploymentSetId del conjunto de despliegue al que pertenece dicha instancia.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE7****	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

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 error

HttpCode	Código de error	Mensaje de error	Descripción
400	OperationDenied.UnstoppedInstance	Operation denied due to unstopped instance.	El mensaje de error indica que la operación actual no es válida. Compruebe si la instancia se encuentra en estado Stopped.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	El mensaje de error indica que la operación no es compatible con el estado actual del host dedicado.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.	El mensaje de error indica que la fecha de vencimiento de la instancia es posterior a la del host dedicado.
400	InvalidParam.Tenancy	The specified Tenancy is invalid.	El mensaje de error indica que el parámetro Tenancy especificado no es válido.
400	OperationDenied.InvalidInstance	The specified instance is not dedicated instance.	El mensaje de error indica que la instancia especificada no está desplegada en un host dedicado.
400	ChargeTypeViolation.PostPaidDedicatedHost	Prepaid instance onto postpaid dedicated host is not allowed.	El mensaje de error indica que no se pueden desplegar instancias subscription en hosts dedicados pay-as-you-go.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	El mensaje de error indica que el parámetro DedicatedHostId especificado no existe.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	El mensaje de error indica que el parámetro InstanceType especificado no existe o que no tiene autorización para gestionar instancias de ese tipo.
403	IncorrectInstanceStatus	%s	El mensaje de error indica que la operación no es compatible con el estado actual de la instancia.
403	OperationDenied.NoStock	The resource is out of usage.	El mensaje de error indica que la instancia no se encuentra en estado Running. Inicie la instancia o verifique si la operación es válida.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	El mensaje de error indica que el ID de instancia especificado no existe. Verifique que el ID de instancia sea correcto.
404	InvalidInstanceNetworkType.NotSupport	The specified Instance network type not support.	El mensaje de error indica que el tipo de red de la instancia no admite esta operación.
404	InvalidInstanceType.NotSupport	The Dedicated host not support the specified instance type.	El mensaje de error indica que el host dedicado actual no admite el tipo de instancia especificado.

Para obtener una lista de códigos de error, visite el Centro de errores de API.