ModifyInstanceDeployment
修改ECS实例的部署集,或迁移ECS实例至专有宿主机。支持在迁移ECS实例的同时变更实例规格
服务地址:
华东1 金融云
输入参数
只看必填
RegionId实例所在的地域ID
InstanceId实例ID
DedicatedHostId专有宿主机ID
DeploymentSetId部署集ID
DeploymentSetGroupNo当ECS实例要加入或调整的部署集策略为...
Force实例在调整部署集时
请选择布尔值
Affinity实例是否与专有宿主机关联
Tenancy实例是否在专有宿主机上部署
MigrationType是否先停止实例
InstanceTypeECS实例要变更的目标实例规格
DedicatedHostClusterId专有宿主机集群ID
RemoveFromDeploymentSet是否将所选实例移出所选部署集
请选择布尔值
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

迁移 ECS 实例至专有宿主机,或在迁移实例同时变更 ECS 实例规格时,必须满足以下条件:

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

请求参数

字段名称字段详情
RegionIdstring

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

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
InstanceIdstring

实例 ID。

示例值:i-bp67acfmxazb4ph***参考取值来源:
    RunInstances
    StopInstances
    StartInstances
    CreateInstance
    RebootInstances
    DescribeInstances
    ModifyManagedInstance
    RenewReservedInstances
    AttachInstanceRamRole
    DetachInstanceRamRole
    DeregisterManagedInstance
    PurchaseReservedInstancesOffering
DedicatedHostIdstring

专有宿主机 ID。调用 DescribeDedicatedHosts 查看可以使用的专有宿主机。展开详情

示例值:dh-bp67acfmxazb4ph****参考取值来源:
    DescribeDedicatedHosts
    AllocateDedicatedHosts
DeploymentSetIdstring

部署集 ID。展开详情

示例值:ds-bp67acfmxazb4ph****参考取值来源:
    CreateDeploymentSet
    DescribeDeploymentSets
DeploymentSetGroupNointeger<int32>

当 ECS 实例要加入或调整的部署集策略为部署集组高可用策略(AvailabilityGroup)时,可以通过该参数指定实例在部署集中的分组号。取值范围:1~7。展开详情

示例值:3
Forceboolean

实例在调整部署集时,是否强制更换实例宿主机。取值范围:展开详情

示例值:false
Affinitystring

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

示例值:host
Tenancystring

实例是否在专有宿主机上部署。取值:host,仅支持实例在专有宿主机上部署。

示例值:host
MigrationTypestring

是否先停止实例,再迁移到目标专有宿主机。取值范围:展开详情

示例值:live
InstanceTypestring

ECS 实例要变更的目标实例规格。调用 DescribeInstanceTypes 接口可获取最新实例规格列表。展开详情

示例值:ecs.c6.large参考取值来源:
    DescribeInstanceTypes
    CreateInstance
DedicatedHostClusterIdstring

专有宿主机集群 ID。

示例值:dc-bp67acfmxazb4ph****参考取值来源:
    CreateDedicatedHostCluster
    DescribeDedicatedHostClusters
RemoveFromDeploymentSetboolean

是否将所选实例移出所选部署集。取值范围:展开详情

示例值:false

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:04F0F334-1335-436C-A1D7-6C044FE7****
变更历史
变更时间变更内容概要操作
2024-01-30
变更错误码403
2023-06-20
变更错误码400
2022-06-10
新增请求参数RemoveFromDeploymentSet
2022-04-12
变更错误码404