ModifyInstanceDeployment - 修改執行個體部署集
修改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程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ecs:ModifyInstanceDeployment |
update |
DedicatedHost
*Instance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| 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功能特性。 |
dh-bp67acfmxazb4ph**** |
| DeploymentSetId |
string |
否 |
部署集 ID。 將 ECS 執行個體加入一個部署集,或調整 ECS 執行個體的部署集時,該參數為必填參數。 說明
修改Dedicated Host的相關參數( |
ds-bp67acfmxazb4ph**** |
| DeploymentSetGroupNo |
integer |
否 |
當 ECS 執行個體要加入或調整的部署集策略為部署集組高可用策略(AvailabilityGroup)時,可以通過該參數指定執行個體在部署集中的分組號。取值範圍:1~7。 說明
如果您為 ECS 執行個體調整部署集,且部署集策略為部署集組高可用策略( |
3 |
| Force |
boolean |
否 |
執行個體在調整部署集時,是否強制更換執行個體宿主機。取值範圍:
預設值:false。 |
false |
| Affinity |
string |
否 |
執行個體是否與Dedicated Host關聯。取值範圍:
執行個體從共用宿主機遷移至Dedicated Host時,預設值為 default。 |
host |
| Tenancy |
string |
否 |
執行個體是否在Dedicated Host上部署。取值:host,僅支援執行個體在Dedicated Host上部署。 |
host |
| MigrationType |
string |
否 |
是否先停止執行個體,再遷移到目標Dedicated Host。取值範圍:
預設值:reboot。 |
live |
| InstanceType |
string |
否 |
ECS 執行個體要變更的目標執行個體規格。調用 DescribeInstanceTypes 介面可擷取最新執行個體規格列表。 修改 ECS 執行個體宿主機時,可同時變更 ECS 執行個體規格。目標執行個體規格必須與指定Dedicated Host的規格相匹配,詳情請參見宿主機規格。
|
ecs.c6.large |
| DedicatedHostClusterId |
string |
否 |
Dedicated Host叢集 ID。 |
dc-bp67acfmxazb4ph**** |
| RemoveFromDeploymentSet |
boolean |
否 |
是否將所選執行個體移出所選部署集。取值範圍:
預設值: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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。