调用ModifyInstanceDeployment修改ECS实例的宿主机。ECS实例与目标宿主机必须位于同一地域。

接口说明

ModifyInstanceDeployment可以帮您完成以下任务:

  • 修改ECS实例的部署集。例如,将ECS实例加入一个部署集,或调整ECS实例的部署集。此时,请求参数DeploymentSetId为必填参数。
    说明 修改专有宿主机实例相关参数(TenancyAffinityDedicatedHostId)时,不可同时修改部署集。
  • 修改ECS实例的宿主机。具体场景如下:
    • 场景一:将ECS实例从共享宿主机迁移至专有宿主机
      • 若将ECS实例迁移至指定专有宿主机上,您需要指定专有宿主机ID,即设置参数DedicatedHostId
      • 若由系统自动为您选择专有宿主机部署ECS实例,您需要将参数DedicatedHostId设置为空且Tenancy设置为host。
    • 场景二:在两台专有宿主机之前迁移ECS实例
      • 若将ECS实例迁移至指定专有宿主机上,您需要指定专有宿主机ID,即设置参数DedicatedHostId
      • 若由系统自动为您选择专有宿主机部署ECS实例,您需要将参数DedicatedHostId设置为空且Tenancy设置为host。

迁移实例至专有宿主机时,请阅读以下注意事项:

  • ECS实例必须处于已停止(Stopped)状态,迁移后实例自动重启。
  • 只支持专有网络VPC类型的ECS实例。
  • 按量付费ECS实例可以迁移到包年包月专有宿主机上。包年包月ECS实例只能在包年包月专有宿主机之间迁移,且实例到期时间不能超过目标专有宿主机的到期时间。
  • 将ECS实例从共享宿主机迁移至专有宿主机时,实例的计费方式只能是按量付费,不支持包年包月实例和抢占式实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String i-instanceid1

实例ID。实例必须处于运行中(Running)或已停止(Stopped)状态。

RegionId String cn-hangzhou

实例所在的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

Action String ModifyInstanceDeployment

系统规定参数。取值:ModifyInstanceDeployment

Affinity String host

实例是否与专有宿主机关联。取值范围:

  • host:实例与专有宿主机关联。已开启停机不收费功能的实例停机后再次启动时,仍部署在原专有宿主机上。
  • default:实例不与专有宿主机关联。已开启停机不收费功能的实例停机后再次启动时,若原专有宿主机资源不足,可迁移至自动部署资源池中的其它专有宿主机上。

实例从共享宿主机迁移至专有宿主机时,默认值:default

DedicatedHostId String dh-2ze3lmtckdjw1pt8n***

专有宿主机ID。您可以调用DescribeDedicatedHosts查看可以使用的专有宿主机。

DeploymentSetId String ds-deploymentsetid1

部署集ID。

Force Boolean false

是否强制更换实例宿主机。

  • true:允许实例更换宿主机,允许重启运行中(Running)的实例、已停止(Stopped)状态的包年包月实例和已停止的停机收费的按量付费实例。
  • false(默认):不允许实例更换宿主机,只在当前宿主机上加入部署集。这可能导致更换部署集失败。
MigrationType String reboot

实例是否先停机再迁移到目标专有宿主机。取值范围:

  • reboot(默认):先停机再迁移实例。
  • live:不停机迁移实例。此时,您必须指定目标专有宿主机ID,即设置参数DedicatedHostId的值。
Tenancy String host

实例是否在专有宿主机上部署。取值范围:host(实例在专有宿主机上部署)。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例


http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceDeployment
&InstanceId=i-instanceid1
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. 指定的专有宿主机ID不存在。
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例不存在,请您检查实例ID是否正确。
400 OperationDenied.UnstoppedInstance Operation denied due to unstopped instance. 非停止实例不支持当前操作。
400 InvalidDedicatedHostStatus.NotSupport Operation denied due to dedicated host status. 资源状态不支持操作。
400 InvalidPeriod.ExceededDedicatedHost Instance expired date can't exceed dedicated host expired date. 实例的自动订阅时长不能晚于专有宿主机订阅时长。
404 InvalidInstanceNetworkType.NotSupport The specified Instance network type not support. 指定实例的网络类型不支持。
404 InvalidInstanceType.NotSupport The Dedicated host not support the specified instance type. 当前宿主机不支持当前实例的规格。
400 OperationDenied.LocalDiskInstance Operation denied due to instance has local disk 实例有本地盘不支持当前操作。
403 IncorrectInstanceStatus %s 实例当前的状态不支持该操作。
400 InvalidParam.Tenancy The specified Tenancy is invalid. 您指定的Tenancy参数值无效。

访问错误中心查看更多错误码。