调用ModifyInstanceDeployment修改ECS实例的部署集,或迁移ECS实例至专有宿主机。支持在迁移ECS实例的同时变更实例规格。
接口说明
迁移ECS实例至专有宿主机,或在迁移实例同时变更ECS实例规格时,必须满足以下条件:
- ECS实例必须处于已停止(Stopped)状态,迁移后实例自动重启。
- 只支持专有网络VPC类型的ECS实例。
- ECS实例与专有宿主机必须属于同一账号、同一地域和可用区。
- 按量付费ECS实例可以迁移到包年包月专有宿主机上。包年包月ECS实例只能在包年包月专有宿主机之间迁移,且实例到期时间不能超过目标专有宿主机的到期时间。
- 将ECS实例从共享宿主机迁移至专有宿主机时,实例的计费方式只能是按量付费,不支持包年包月实例和抢占式实例。
- ECS实例可以指定专有宿主机集群重新部署。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyInstanceDeployment |
系统规定参数。取值:ModifyInstanceDeployment。 |
RegionId | String | 是 | cn-hangzhou |
实例所在的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
InstanceId | String | 是 | i-bp67acfmxazb4ph*** |
实例ID。 |
DedicatedHostId | String | 否 | dh-bp67acfmxazb4ph**** |
专有宿主机ID。调用DescribeDedicatedHosts查看可以使用的专有宿主机。 修改ECS实例宿主机(即将ECS实例从共享宿主机迁移至专有宿主机,或在不同专有宿主机间迁移ECS实例)时:
自动部署功能详情,请参见专有宿主机功能特性。 |
DeploymentSetId | String | 否 | ds-bp67acfmxazb4ph**** |
部署集ID。 将ECS实例加入一个部署集,或调整ECS实例的部署集时,该参数为必填参数。 |
DeploymentSetGroupNo | Integer | 否 | 3 |
当ECS实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号。取值范围:1~7。 |
Force | Boolean | 否 | false |
实例在调整部署集时,是否强制更换实例宿主机。取值范围:
默认值:false。 |
Affinity | String | 否 | host |
实例是否与专有宿主机关联。取值范围:
实例从共享宿主机迁移至专有宿主机时,默认值为default。 |
Tenancy | String | 否 | host |
实例是否在专有宿主机上部署。取值:host,仅支持实例在专有宿主机上部署。 |
MigrationType | String | 否 | live |
是否先停止实例,再迁移到目标专有宿主机。取值范围:
默认值:reboot。 |
InstanceType | String | 否 | ecs.c6.large |
ECS实例要变更的目标实例规格。调用DescribeInstanceTypes接口可获取最新实例规格列表。 修改ECS实例宿主机时,可同时变更ECS实例规格。目标实例规格必须与指定专有宿主机的规格相匹配,详情请参见宿主机规格。
|
DedicatedHostClusterId | String | 否 | dc-bp67acfmxazb4ph**** |
专有宿主机集群ID。 |
RemoveFromDeploymentSet | Boolean | 否 | false |
是否将所选实例移出所选部署集。取值范围:
默认值:false。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 04F0F334-1335-436C-A1D7-6C044FE7**** |
请求ID。 |
示例
请求示例
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****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
04F0F334-1335-436C-A1D7-6C044FE7****
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "04F0F334-1335-436C-A1D7-6C044FE7****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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 | InvalidParam.Tenancy | The specified Tenancy is invalid. | 您指定的参数Tenancy无效。 |
400 | OperationDenied.InvalidInstance | The specified instance is not dedicated instance. | 指定的实例不是部署在专有宿主机的实例。 |
400 | ChargeTypeViolation.PostPaidDedicatedHost | Prepaid instance onto postpaid dedicated host is not allowed. | 包年包月的实例无法添加到按量付费的专有宿主机上。 |
400 | InvalidDedicatedHostId.NotFound | The specified DedicatedHostId does not exist. | 指定的专有宿主机不存在。 |
400 | InvalidInstanceType.ValueNotSupported | The specified InstanceType does not exist or beyond the permitted range. | 您指定的实例规格不存在,或者您没有权限操作此规格的实例。 |
403 | IncorrectInstanceStatus | %s | 当前实例的状态不支持此操作。 |
403 | OperationDenied.NoStock | The resource is out of usage. | 该实例不在运行状态,请您启动实例或检查操作是否合理。 |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例不存在,请您检查实例ID是否正确。 |
404 | InvalidInstanceNetworkType.NotSupport | The specified Instance network type not support. | 当前实例的网络类型不支持此操作。 |
404 | InvalidInstanceType.NotSupport | The Dedicated host not support the specified instance type. | 当前宿主机不支持指定的实例规格。 |
访问错误中心查看更多错误码。
腾讯云1折,限时活动,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
转转请注明出处:https://www.yunxiaoer.com/153062.html