调用ModifyInstanceDeployment修改ECS实例的部署集,或迁移ECS实例至专有宿主机。支持在迁移ECS实例的同时变更实例规格。
接口说明
迁移 ECS 实例至专有宿主机,或在迁移实例同时变更 ECS 实例规格时,必须满足以下条件:
- ECS 实例必须处于已停止(Stopped)状态,迁移后实例自动重启。
- 只支持专有网络 VPC 类型的 ECS 实例。
- ECS 实例与专有宿主机必须属于同一账号、同一地域和可用区。
- 按量付费 ECS 实例可以迁移到包年包月专有宿主机上。包年包月 ECS 实例只能在包年包月专有宿主机之间迁移,且实例到期时间不能超过目标专有宿主机的到期时间。
- 将 ECS 实例从共享宿主机迁移至专有宿主机时,实例的计费方式只能是按量付费,不支持包年包月实例和抢占式实例。
- ECS 实例可以指定专有宿主机集群重新部署。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ecs:ModifyInstanceDeployment | update | *DedicatedHost acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId} *Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 实例所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
InstanceId | string | 是 | 实例 ID。 | i-bp67acfmxazb4ph*** |
DedicatedHostId | string | 否 | 专有宿主机 ID。调用 DescribeDedicatedHosts 查看可以使用的专有宿主机。 修改 ECS 实例宿主机(即将 ECS 实例从共享宿主机迁移至专有宿主机,或在不同专有宿主机间迁移 ECS 实例)时:
自动部署功能详情,请参见专有宿主机功能特性。 | dh-bp67acfmxazb4ph**** |
DeploymentSetId | string | 否 | 部署集 ID。 将 ECS 实例加入一个部署集,或调整 ECS 实例的部署集时,该参数为必填参数。 说明
修改专有宿主机的相关参数( Tenancy 、Affinity 和DedicatedHostId )时,不可同时修改部署集。
| ds-bp67acfmxazb4ph**** |
DeploymentSetGroupNo | integer | 否 | 当 ECS 实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号。取值范围:1~7。 说明
如果您为 ECS 实例调整部署集,且部署集策略为部署集组高可用策略( AvailablilityGroup ),当不指定该参数时,系统会自动在各组之间均衡分配 ECS 实例。如果您为 ECS 实例指定的仍是当前实例所属的部署集,系统也会重新在各组之间均衡分配 ECS 实例。
| 3 |
Force | boolean | 否 | 实例在调整部署集时,是否强制更换实例宿主机。取值范围:
默认值:false。 | false |
Affinity | string | 否 | 实例是否与专有宿主机关联。取值范围:
实例从共享宿主机迁移至专有宿主机时,默认值为 default。 | host |
Tenancy | string | 否 | 实例是否在专有宿主机上部署。取值:host,仅支持实例在专有宿主机上部署。 | host |
MigrationType | string | 否 | 是否先停止实例,再迁移到目标专有宿主机。取值范围:
默认值:reboot。 | live |
InstanceType | string | 否 | ECS 实例要变更的目标实例规格。调用 DescribeInstanceTypes 接口可获取最新实例规格列表。 修改 ECS 实例宿主机时,可同时变更 ECS 实例规格。目标实例规格必须与指定专有宿主机的规格相匹配,详情请参见宿主机规格。
| ecs.c6.large |
DedicatedHostClusterId | string | 否 | 专有宿主机集群 ID。 | dc-bp67acfmxazb4ph**** |
RemoveFromDeploymentSet | boolean | 否 | 是否将所选实例移出所选部署集。取值范围:
默认值:false。 说明
当该参数为 true 时,必须指定具有所属关系的 InstanceId 和 DeploymentSetId。
| false |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE7****"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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. | - |
400 | NoAvaliableDedicatedHost | There's no enough resource on the specified dedicated host. | 指定的专属主机上没有足够的资源 |
400 | OperationDenied.LocalDiskInstance | Operation denied due to instance has local disk. | - |
400 | NoAvaliableDedicatedHost | There's no enough dedicated host resource. | 没有可用资源的专有宿主机 |
400 | InvalidParameter.Param | Requested param is invalid. | - |
400 | InvalidParam.Tenancy | The specified Tenancy is invalid. | 您指定的参数 Tenancy 无效。 |
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. | 指定的实例不是部署在专有宿主机的实例。 |
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 | InvalidParam.DedicatedHostId | Parameter dedicated host id must been provided in such operation. | - |
400 | OperationDenied.CannotPerform | Live migration cannot be performed. | 热迁移无法执行。 |
400 | InvalidInstanceType.ValueNotSupported | The specified InstanceType does not exist or beyond the permitted range. | 您指定的实例规格不存在,或者您没有权限操作此规格的实例。 |
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. | 如果实例加入的部署集是Lowlatency策略,且此部署集已有实例加入,此实例必须在已有实例所在可用区 |
403 | IncorrectInstanceStatus | %s | 当前实例的状态不支持此操作。 |
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. | 没有足够的资源进行此部署,可以将参数force设置为true或者等待更多资源变为可用状态。 |
404 | InvalidDeploymentSetId.NotFound | The specified deployment set does not exist. | - |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的InstanceId不存在。 |
404 | InvalidInstanceNetworkType.NotSupport | The specified Instance network type not support. | 当前实例的网络类型不支持此操作。 |
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. | 当前宿主机不支持指定的实例规格。 |
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 | 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. | - |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-01-30 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-06-20 | OpenAPI 错误码发生变更 | 查看变更详情 |
2022-06-10 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |