Todos los productos
Search
Centro de documentos

Elastic Compute Service:ModifyInstanceDeployment

Última actualización: Sep 01, 2026

Cambia el conjunto de despliegue de una instancia de Elastic Compute Service (ECS) o migra una instancia de ECS a un host dedicado. Puede cambiar el tipo de instancia de una instancia de ECS cuando la migra.

Descripción de la operación

Tome en cuenta los siguientes puntos:

  • La instancia debe estar en estado Stopped (Detenida). La instancia se reinicia automáticamente después de la migración.

  • El tipo de red de la instancia debe ser Virtual Private Cloud (VPC).

  • La instancia y el host dedicado de destino al que se migrará la instancia deben pertenecer a la misma cuenta y residir en la misma región y zona.

  • Una instancia de pago por uso se puede migrar a un host dedicado de suscripción. Una instancia de suscripción solo se puede migrar entre hosts dedicados de suscripción. La fecha de vencimiento de la instancia de suscripción no puede ser posterior a la del host dedicado de destino.

  • Solo puede migrar instancias de pago por uso de un host compartido a un host dedicado. No puede migrar instancias de suscripción ni instancias spot de un host compartido a un host dedicado.

  • Puede redesplegar una instancia en un clúster de hosts dedicados específico.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:ModifyInstanceDeployment

update

DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

RegionId

string

Sí

El ID de la región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.

cn-hangzhou

InstanceId

string

Sí

El ID de la instancia.

i-bp67acfmxazb4ph***

DedicatedHostId

string

No

El ID del host dedicado de destino. Puede llamar a la operación DescribeDedicatedHosts para consultar la lista más reciente de hosts dedicados.

Cuando migra una instancia de un host compartido a un host dedicado o entre hosts dedicados, tome en cuenta los siguientes puntos:

  • Para migrar la instancia a un host dedicado específico, especifique 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 y características.

dh-bp67acfmxazb4ph****

DeploymentSetId

string

No

El ID del conjunto de despliegue de destino.

Este parámetro es obligatorio cuando agrega una instancia a un conjunto de despliegue o cambia el conjunto de despliegue de una instancia.

Nota

No puede cambiar el conjunto de despliegue cuando modifica configuraciones de host dedicado, incluidos los parámetros Tenancy, Affinity y DedicatedHostId.

ds-bp67acfmxazb4ph****

DeploymentSetGroupNo

integer

No

El número del grupo de conjunto de despliegue en el que 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: 1 a 7.

Nota

Si llama a esta operación para desplegar una instancia en un conjunto de despliegue que utiliza la estrategia de grupo de alta disponibilidad (AvailablilityGroup) y deja este parámetro vacío, el sistema distribuye las instancias uniformemente entre los grupos de conjunto de despliegue del conjunto. Si llama a esta operación para cambiar el conjunto de despliegue de una instancia y especifica el conjunto de despliegue actual de la instancia como conjunto de despliegue de destino, el sistema vuelve a distribuir las instancias uniformemente entre los grupos de conjunto de despliegue del conjunto.

3

Force

boolean

No

Especifica si se debe cambiar forzosamente el host de la instancia cuando se cambia su conjunto de despliegue. Valores válidos:

  • true: cambia forzosamente el host de la instancia cuando se cambia su conjunto de despliegue. Los hosts solo se pueden cambiar forzosamente para instancias en estado Running (En ejecución) o Stopped (Detenida). Las instancias en estado Stopped (Detenida) no incluyen instancias de pago por uso detenidas en modo económico.

    **

    Nota Si la instancia especificada tiene discos locales conectados, los discos locales se cambian forzosamente cuando se cambia forzosamente el host de la instancia. Esto puede provocar pérdida de datos en los discos locales. Proceda con precaución.

  • false: no cambia forzosamente el host de la instancia cuando se cambia su conjunto de despliegue. Puede agregar la instancia a un conjunto de despliegue solo si la instancia permanece en el host actual. Cuando el parámetro Force se establece en false, es posible que no se pueda cambiar el conjunto de despliegue.

Valor predeterminado: false.

false

Affinity

string

No

Especifica si se debe asociar la instancia con un host dedicado. Valores válidos:

  • host: asocia la instancia con un host dedicado. Cuando inicia una instancia detenida en modo económico, la instancia permanece en su host dedicado original.

  • default: no asocia la instancia con un host dedicado. Cuando inicia una instancia detenida en modo económico, la instancia se puede desplegar automáticamente en otro host dedicado del pool de recursos de despliegue automático si los recursos del host dedicado original son insuficientes.

Si desea migrar la instancia de un host compartido a un host dedicado, utilice el valor predeterminado. Valor predeterminado: default.

host

Tenancy

string

No

Especifica si se debe desplegar la instancia en un host dedicado. Establezca el valor en host, lo que indica que la instancia se despliega en un host dedicado.

host

MigrationType

string

No

Especifica si se debe detener la instancia antes de migrarla al host dedicado de destino. Valores válidos:

  • reboot: detiene la instancia antes de migrarla.

  • live: migra la instancia sin detenerla. Si establece MigrationType en live, debe especificar DedicatedHostId. En este caso, no puede cambiar el tipo de instancia cuando se migra la instancia.

Valor predeterminado: reboot.

live

InstanceType

string

No

El tipo de instancia al que se cambia la instancia. Puede llamar a la operación DescribeInstanceTypes para consultar la lista más reciente de tipos de instancia.

Puede cambiar el tipo de instancia de una instancia cuando la migra 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 host dedicado.

  • Si especifica este parámetro, también debe especificar DedicatedHostId.

  • No puede cambiar el tipo de instancia de una instancia si utiliza la función de despliegue automático para migrar la instancia.

ecs.c6.large

DedicatedHostClusterId

string

No

El ID del clúster de hosts dedicados.

dc-bp67acfmxazb4ph****

RemoveFromDeploymentSet

boolean

No

Especifica si se debe eliminar la instancia especificada del conjunto de despliegue especificado. Valores válidos:

  • true

  • false

Valor predeterminado: false.

Nota

Si establece este parámetro en true, debe especificar InstanceId y DeploymentSetId, y asegurarse de que la instancia especificada pertenezca al conjunto de despliegue especificado.

false

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

RequestId

string

El ID de la solicitud.

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

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 OperationDenied.UnstoppedInstance Operation denied due to unstopped instance. The operation is invalid. Check whether the instance is stopped.
400 InvalidDedicatedHostStatus.NotSupport Operation denied due to dedicated host status.
400 InvalidPeriod.ExceededDedicatedHost Instance expired date can't exceed dedicated host expired date.
400 NoAvaliableDedicatedHost There's no enough resource on the specified dedicated host.
400 OperationDenied.LocalDiskInstance Operation denied due to instance has local disk.
400 InvalidParameter.Param Requested param is invalid.
400 InvalidParam.Tenancy The specified Tenancy is invalid. The specified Tenancy parameter is invalid.
400 InvalidParam.DedicatedHostId The specified dedicated host id is the same with present host id!
400 InvalidDedicatedHost.NotEnoughResource There's no available dedicated host to perform the operation.
400 OperationDenied.InvalidInstance The specified instance is not dedicated instance. The specified instance is not deployed on a dedicated host.
400 ChargeTypeViolation.PostPaidDedicatedHost Prepaid instance onto postpaid dedicated host is not allowed.
400 OperationDenied.NotSupport Ecs on dedicatedHost has been migrated.
400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist.
400 OperationDenied.CannotPerform Live migration cannot be performed. Hot migration cannot be performed.
400 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range. The specified instance type does not exist or you are not authorized to manage instances of this instance type.
400 InvalidParameter.Tenancy The specified Tenancy is invalid.
400 InvalidParameter.Affinity The specified Affinity is invalid.
400 InvalidInstanceType.NotSupport The parameter EcsMigrationType conflict with InstanceType, live migration do not support InstanceType alter on ddh.
400 InvalidParam.InstanceId The specified InstanceId should be on dedicatedHost.
400 InvalidDedicatedHostClusterId.NotFound The specified DedicatedHostClusterId does not exist.
400 InvalidDedicatedHostClusterId.Invalid The specified Dedicated Host Cluster is invalid.
400 InvalidDestinationZone.DeploymentSetMismatch Error happened, %s.
403 IncorrectInstanceStatus %s The instance is in a state that does not support the current operation.
403 OperationDenied.NoStock The resource is out of usage.
403 InvalidDeploymentSetId.NoAvailableResources There are no available resources for the specified deployment, you can set the parameter force to true to retry, or wait for additional resource to become available. There are no available resources for the specified deployment, you can set the parameter force to true to retry, or wait for additional resource to become available.
403 InvalidInstanceType.ValueNotSupported The specified InstanceType does not support the current category of data disk. The specified InstanceType does not support the current category of data disk.
404 InvalidDeploymentSetId.NotFound The specified deployment set does not exist.
404 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. The specified instanceId is invalid.
404 OperationDenied.UnstoppedInstance Operation denied due to unstopped instance.
404 InvalidInstanceNetworkType.NotSupport The specified Instance network type not support. The operation is not supported while the instance is of the current network type.
404 InvalidInstanceChargeType.NotSupport The Dedicated host not support the specified instance charge type.
404 InvalidInstanceType.NotSupport The Dedicated host not support the specified instance type. The dedicated host does not support the specified instance type.
404 InvalidParameter.DeploymentSetGroupNo Parameter DeploymentSetGroupNo is invalid.
404 InvalidDedicatedHostId.NotSupport Cannot choose instance present host as destination host.
404 InvalidDedicatedHost.NotFound No available host.
404 InvalidParam.DedicatedHostId Parameter dedicated host id must been provided in such operation.
404 InvalidDedicatedHost.ZoneNotMatch The specify dedicated host zone location not match the instance zone location.
404 InvalidOperation.NotSupport The specified DedicatedHost operation not supported on MPS.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.