ModifyInstanceDeployment - 修改執行個體部署集

更新時間:
Copy as MD

修改ECS執行個體的部署集,或遷移ECS執行個體至Dedicated Host。支援在遷移ECS執行個體的同時變更執行個體規格。

介面說明

遷移 ECS 執行個體至Dedicated Host,或在遷移執行個體同時變更 ECS 執行個體規格時,必須滿足以下條件:

  • ECS 執行個體必須處於已停止(Stopped)狀態,遷移後執行個體自動重啟。

  • 只支援Virtual Private Cloud 類型的 ECS 執行個體。

  • ECS 執行個體與Dedicated Host必須屬於同一帳號、同一地區和可用性區域。

  • 隨用隨付 ECS 執行個體可以遷移到訂用帳戶Dedicated Host上。訂用帳戶 ECS 執行個體只能在訂用帳戶Dedicated Host之間遷移,且執行個體到期時間不能超過目標Dedicated Host的到期時間。

  • 將 ECS 執行個體從共用宿主機遷移至Dedicated Host時,執行個體的計費方式只能是隨用隨付,不支援訂用帳戶執行個體和搶佔式執行個體。

  • ECS 執行個體可以指定Dedicated Host叢集重新部署。

調試

您可以在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

Dedicated Host ID。調用 DescribeDedicatedHosts 查看可以使用的Dedicated Host。

修改 ECS 執行個體宿主機(即將 ECS 執行個體從共用宿主機遷移至Dedicated Host,或在不同Dedicated Host間遷移 ECS 執行個體)時:

  • 若將執行個體遷移至指定Dedicated Host上,必須設定該參數。

  • 若將執行個體遷移至系統自動為您選擇的Dedicated Host上,必須將該參數設定為空白,並將參數Tenancy設定為 host。

自動部署功能詳情,請參見Dedicated Host功能特性

dh-bp67acfmxazb4ph****

DeploymentSetId

string

部署集 ID。

將 ECS 執行個體加入一個部署集,或調整 ECS 執行個體的部署集時,該參數為必填參數。

說明

修改Dedicated Host的相關參數(TenancyAffinityDedicatedHostId)時,不可同時修改部署集。

ds-bp67acfmxazb4ph****

DeploymentSetGroupNo

integer

當 ECS 執行個體要加入或調整的部署集策略為部署集組高可用策略(AvailabilityGroup)時,可以通過該參數指定執行個體在部署集中的分組號。取值範圍:1~7。

說明

如果您為 ECS 執行個體調整部署集,且部署集策略為部署集組高可用策略(AvailablilityGroup),當不指定該參數時,系統會自動在各組之間均衡分配 ECS 執行個體。如果您為 ECS 執行個體指定的仍是當前執行個體所屬的部署集,系統也會重新在各組之間均衡分配 ECS 執行個體。

3

Force

boolean

執行個體在調整部署集時,是否強制更換執行個體宿主機。取值範圍:

  • true:允許。允許重啟運行中(Running)、已停止(Stopped)狀態的 ECS 執行個體。已停止狀態的執行個體不包括啟用節省停機模式的隨用隨付 ECS 執行個體。

    說明

    如果您指定的 ECS 執行個體搭載了本地碟,則本地碟也會允許強制更換,這可能導致在更換宿主機時本地碟資料丟失,請謹慎操作。

  • false:不允許。只在當前宿主機上加入部署集。這可能導致更換部署集失敗。

預設值:false。

false

Affinity

string

執行個體是否與Dedicated Host關聯。取值範圍:

  • host:關聯。已啟用節省停機模式的執行個體停機後再次啟動時,仍部署在原Dedicated Host上。

  • default:不關聯。已啟用節省停機模式的執行個體停機後再次啟動時,若原Dedicated Host資源不足,可遷移至自動部署資源集區中的其它Dedicated Host上。

執行個體從共用宿主機遷移至Dedicated Host時,預設值為 default。

host

Tenancy

string

執行個體是否在Dedicated Host上部署。取值:host,僅支援執行個體在Dedicated Host上部署。

host

MigrationType

string

是否先停止執行個體,再遷移到目標Dedicated Host。取值範圍:

  • reboot:先停止執行個體再遷移。

  • live:不停止執行個體,隨即轉移。此時,您必須指定參數 DedicatedHostId。該取值不支援在遷移 ECS 執行個體的同時變更執行個體規格。

預設值:reboot。

live

InstanceType

string

ECS 執行個體要變更的目標執行個體規格。調用 DescribeInstanceTypes 介面可擷取最新執行個體規格列表。

修改 ECS 執行個體宿主機時,可同時變更 ECS 執行個體規格。目標執行個體規格必須與指定Dedicated Host的規格相匹配,詳情請參見宿主機規格

  • 變更執行個體規格時,必須指定Dedicated Host ID,即設定參數DedicatedHostId的值。

  • 使用自動部署功能遷移 ECS 執行個體時,不能變更執行個體規格。

ecs.c6.large

DedicatedHostClusterId

string

Dedicated Host叢集 ID。

dc-bp67acfmxazb4ph****

RemoveFromDeploymentSet

boolean

是否將所選執行個體移出所選部署集。取值範圍:

  • true:是。

  • false:否。

預設值:false。

說明

當該參數為 true 時,必須指定具有所屬關係的 InstanceId 和 DeploymentSetId。

false

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

04F0F334-1335-436C-A1D7-6C044FE7****

樣本

正常返回樣本

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. Dedicated Host當前的狀態不支援此操作。
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 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. 指定的執行個體不是部署在Dedicated Host的執行個體。
400 ChargeTypeViolation.PostPaidDedicatedHost Prepaid instance onto postpaid dedicated host is not allowed. 訂用帳戶的執行個體無法添加到隨用隨付的Dedicated Host上。
400 OperationDenied.NotSupport Ecs on dedicatedHost has been migrated.
400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. 指定的Dedicated Host不存在。
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. 所指定的執行個體應處於Dedicated Host
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或者等待更多資源變為可用狀態。
403 InvalidInstanceType.ValueNotSupported The specified InstanceType does not support the current category of data disk. 指定的執行個體規格不支援當前執行個體掛載的資料盤規格。
404 InvalidDeploymentSetId.NotFound The specified deployment set does not exist.
404 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的執行個體ID無效。
404 OperationDenied.UnstoppedInstance Operation denied due to unstopped instance.
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 InvalidParam.DedicatedHostId Parameter dedicated host id must been provided in such operation.
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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情