調(diào)用ModifyInstanceDeployment修改ECS實(shí)例的部署集,或遷移ECS實(shí)例至專有宿主機(jī)。支持在遷移ECS實(shí)例的同時(shí)變更實(shí)例規(guī)格。
接口說(shuō)明
遷移 ECS 實(shí)例至專有宿主機(jī),或在遷移實(shí)例同時(shí)變更 ECS 實(shí)例規(guī)格時(shí),必須滿足以下條件:
- ECS 實(shí)例必須處于已停止(Stopped)狀態(tài),遷移后實(shí)例自動(dòng)重啟。
- 只支持專有網(wǎng)絡(luò) VPC 類型的 ECS 實(shí)例。
- ECS 實(shí)例與專有宿主機(jī)必須屬于同一賬號(hào)、同一地域和可用區(qū)。
- 按量付費(fèi) ECS 實(shí)例可以遷移到包年包月專有宿主機(jī)上。包年包月 ECS 實(shí)例只能在包年包月專有宿主機(jī)之間遷移,且實(shí)例到期時(shí)間不能超過(guò)目標(biāo)專有宿主機(jī)的到期時(shí)間。
- 將 ECS 實(shí)例從共享宿主機(jī)遷移至專有宿主機(jī)時(shí),實(shí)例的計(jì)費(fèi)方式只能是按量付費(fèi),不支持包年包月實(shí)例和搶占式實(shí)例。
- ECS 實(shí)例可以指定專有宿主機(jī)集群重新部署。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 實(shí)例所在的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
InstanceId | string | 是 | 實(shí)例 ID。 | i-bp67acfmxazb4ph*** |
DedicatedHostId | string | 否 | 專有宿主機(jī) ID。調(diào)用 DescribeDedicatedHosts 查看可以使用的專有宿主機(jī)。 修改 ECS 實(shí)例宿主機(jī)(即將 ECS 實(shí)例從共享宿主機(jī)遷移至專有宿主機(jī),或在不同專有宿主機(jī)間遷移 ECS 實(shí)例)時(shí):
自動(dòng)部署功能詳情,請(qǐng)參見(jiàn)專有宿主機(jī)功能特性。 | dh-bp67acfmxazb4ph**** |
DeploymentSetId | string | 否 | 部署集 ID。 將 ECS 實(shí)例加入一個(gè)部署集,或調(diào)整 ECS 實(shí)例的部署集時(shí),該參數(shù)為必填參數(shù)。 說(shuō)明
修改專有宿主機(jī)的相關(guān)參數(shù)( Tenancy 、Affinity 和DedicatedHostId )時(shí),不可同時(shí)修改部署集。
| ds-bp67acfmxazb4ph**** |
DeploymentSetGroupNo | integer | 否 | 當(dāng) ECS 實(shí)例要加入或調(diào)整的部署集策略為部署集組高可用策略(AvailabilityGroup)時(shí),可以通過(guò)該參數(shù)指定實(shí)例在部署集中的分組號(hào)。取值范圍:1~7。 說(shuō)明
如果您為 ECS 實(shí)例調(diào)整部署集,且部署集策略為部署集組高可用策略( AvailablilityGroup ),當(dāng)不指定該參數(shù)時(shí),系統(tǒng)會(huì)自動(dòng)在各組之間均衡分配 ECS 實(shí)例。如果您為 ECS 實(shí)例指定的仍是當(dāng)前實(shí)例所屬的部署集,系統(tǒng)也會(huì)重新在各組之間均衡分配 ECS 實(shí)例。
| 3 |
Force | boolean | 否 | 實(shí)例在調(diào)整部署集時(shí),是否強(qiáng)制更換實(shí)例宿主機(jī)。取值范圍:
默認(rèn)值:false。 | false |
Affinity | string | 否 | 實(shí)例是否與專有宿主機(jī)關(guān)聯(lián)。取值范圍:
實(shí)例從共享宿主機(jī)遷移至專有宿主機(jī)時(shí),默認(rèn)值為 default。 | host |
Tenancy | string | 否 | 實(shí)例是否在專有宿主機(jī)上部署。取值:host,僅支持實(shí)例在專有宿主機(jī)上部署。 | host |
MigrationType | string | 否 | 是否先停止實(shí)例,再遷移到目標(biāo)專有宿主機(jī)。取值范圍:
默認(rèn)值:reboot。 | live |
InstanceType | string | 否 | ECS 實(shí)例要變更的目標(biāo)實(shí)例規(guī)格。調(diào)用 DescribeInstanceTypes 接口可獲取最新實(shí)例規(guī)格列表。 修改 ECS 實(shí)例宿主機(jī)時(shí),可同時(shí)變更 ECS 實(shí)例規(guī)格。目標(biāo)實(shí)例規(guī)格必須與指定專有宿主機(jī)的規(guī)格相匹配,詳情請(qǐng)參見(jiàn)宿主機(jī)規(guī)格。
| ecs.c6.large |
DedicatedHostClusterId | string | 否 | 專有宿主機(jī)集群 ID。 | dc-bp67acfmxazb4ph**** |
RemoveFromDeploymentSet | boolean | 否 | 是否將所選實(shí)例移出所選部署集。取值范圍:
默認(rèn)值:false。 說(shuō)明
當(dāng)該參數(shù)為 true 時(shí),必須指定具有所屬關(guān)系的 InstanceId 和 DeploymentSetId。
| false |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE7****"
}
錯(cuò)誤碼
HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
400 | OperationDenied.UnstoppedInstance | Operation denied due to unstopped instance. | 當(dāng)前操作無(wú)效,請(qǐng)確認(rèn)實(shí)例是否已停止。 |
400 | InvalidDedicatedHostStatus.NotSupport | Operation denied due to dedicated host status. | 專有宿主機(jī)當(dāng)前的狀態(tài)不支持此操作。 |
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. | 您指定的參數(shù) Tenancy 無(wú)效。 |
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. | 指定的實(shí)例不是部署在專有宿主機(jī)的實(shí)例。 |
400 | ChargeTypeViolation.PostPaidDedicatedHost | Prepaid instance onto postpaid dedicated host is not allowed. | 包年包月的實(shí)例無(wú)法添加到按量付費(fèi)的專有宿主機(jī)上。 |
400 | OperationDenied.NotSupport | Ecs on dedicatedHost has been migrated. | - |
400 | InvalidDedicatedHostId.NotFound | The specified DedicatedHostId does not exist. | 指定的專有宿主機(jī)不存在。 |
400 | InvalidParam.DedicatedHostId | Parameter dedicated host id must been provided in such operation. | - |
400 | OperationDenied.CannotPerform | Live migration cannot be performed. | 熱遷移無(wú)法執(zhí)行。 |
400 | InvalidInstanceType.ValueNotSupported | The specified InstanceType does not exist or beyond the permitted range. | 您指定的實(shí)例規(guī)格不存在,或者您沒(méi)有權(quán)限操作此規(guī)格的實(shí)例。 |
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. | 所指定的實(shí)例應(yīng)處于專有宿主機(jī)上 |
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. | 如果實(shí)例加入的部署集是Lowlatency策略,且此部署集已有實(shí)例加入,此實(shí)例必須在已有實(shí)例所在可用區(qū) |
403 | IncorrectInstanceStatus | %s | 當(dāng)前實(shí)例的狀態(tài)不支持此操作。 |
403 | OperationDenied.NoStock | The resource is out of usage. | 該實(shí)例不在運(yùn)行狀態(tài),請(qǐng)您啟動(dòng)實(shí)例或檢查操作是否合理。 |
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. | 沒(méi)有足夠的資源進(jìn)行此部署,可以將參數(shù)force設(shè)置為true或者等待更多資源變?yōu)榭捎脿顟B(tài)。 |
404 | InvalidDeploymentSetId.NotFound | The specified deployment set does not exist. | - |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的實(shí)例ID未找到。 |
404 | InvalidInstanceNetworkType.NotSupport | The specified Instance network type not support. | 當(dāng)前實(shí)例的網(wǎng)絡(luò)類型不支持此操作。 |
404 | InvalidInstanceChargeType.NotSupport | The Dedicated host not support the specified instance charge type. | 此專有宿主機(jī)不支持指定的付費(fèi)類型的實(shí)例。 |
404 | InvalidInstanceType.NotSupport | The Dedicated host not support the specified instance type. | 當(dāng)前宿主機(jī)不支持指定的實(shí)例規(guī)格。 |
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. | - |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-01-30 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
2023-06-20 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
2022-06-10 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |