調用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 入參發生變更 | 查看變更詳情 |