Elastic Compute Service (ECS) インスタンスのデプロイメントセットを変更するか、ECSインスタンスを専用ホストに移行します。 インスタンスの移行時に、インスタンスのインスタンスタイプを変更できます。

説明

インスタンスに対してこの操作を呼び出すときは、次の項目に注意してください。

  • インスタンスは [停止済み] (Stopped) ステータスである必要があります。 インスタンスは、移行後に自動的に再起動されます。
  • インスタンスのネットワークタイプは、Virtual Private Cloud (VPC) である必要があります。
  • インスタンスとインスタンスの移行先の専用ホストは、同じアカウントに属し、同じリージョンとゾーンに存在する必要があります。
  • 従量課金インスタンスは、サブスクリプション専用ホストに移行できます。 A subscription instance can be migrated only between subscription dedicated hosts. サブスクリプションインスタンスの有効期限は、移行先の専用ホストの有効期限よりも遅くすることはできません。
  • You can migrate only pay-as-you-go instances from a shared host to a dedicated host. You cannot migrate subscription or preemptible instances from a shared host to a dedicated host.
  • インスタンスを特定の専用ホストクラスターに再デプロイできます。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 ModifyInstanceDeployment

実行する操作です。 値をModifyInstanceDeploymentに設定します。

RegionId String 必須 cn-hangzhou

インスタンスのリージョン ID です。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

InstanceId String 必須 i-bp67acfmxazb4ph ***

インスタンスの ID。

DedicatedHostId String 任意 dh-bp67acfmxazb4ph ****

宛先専用ホストのID。 DescribeDedicatedHosts操作を呼び出して、専用ホストの最新リストを照会できます。

共有ホストから専用ホストへ、または専用ホスト間でインスタンスを移行する場合は、次の項目に注意してください。

  • インスタンスを特定の専用ホストに移行するには、このパラメーターを指定する必要があります。
  • To migrate the instance to a system-selected dedicated host, you must leave this parameter empty and set Tenancy to host.

自動デプロイ機能の詳細については、「専用ホストの機能」をご参照ください。

DeploymentSetId String 任意 ds-bp67acfmxazb4ph ****

移行先デプロイメントセットのID。

このパラメーターは、ECSインスタンスをデプロイメントセットに追加する場合、またはインスタンスのデプロイメントセットを変更する場合に必要です。

注 テナント、アフィニティ、DedicatedHostIdなどの専用ホスト関連のパラメーターを変更する場合、デプロイメントセットを変更することはできません。
DeploymentSetGroupNo Integer 任意 3

移行先デプロイメントセット内のインスタンスをデプロイするデプロイメントセットグループの番号。 このパラメーターは、移行先デプロイメントセットが高可用性グループ戦略 (AvailabilityGroup) を使用している場合にのみ有効です。 有効な値: 1 ~ 7。

注 このパラメーターを空のままにしてこの操作を呼び出し、指定されたインスタンスを高可用性グループ戦略 (AvailablilityGroup) を使用するデプロイメントセットにデプロイすると、システムはデプロイメントセット内のデプロイメントセットグループ間でECSインスタンスを均等に分散します。 この操作を呼び出してインスタンスのデプロイメントセットを変更し、インスタンスの現在のデプロイメントセットを宛先デプロイメントセットとして指定すると、システムはデプロイメントセット内のデプロイメントセットグループ間でECSインスタンスを再び均等に分散します。
フォース Boolean 任意 false

インスタンスのデプロイメントセットが変更されたときに、インスタンスのホストを強制的に変更するかどうかを指定します。 設定可能な値は以下のとおりです。

  • true: インスタンスのデプロイメントセットが変更されたときに、インスタンスのホストを強制的に変更します。 ホストは、実行中 (実行中) または停止中 (停止中) のインスタンスに対してのみ強制的に変更できます。 Stopped (Stopped) ステータスのインスタンスには、エコノミーモードで停止した従量課金インスタンスは含まれません。
    注 指定されたインスタンスにローカルディスクがアタッチされている場合、インスタンスのホストが強制的に変更されると、ローカルディスクは強制的に変更されます。 これにより、ローカルディスクでデータが失われる可能性があります。 操作は慎重に行ってください。
  • false: インスタンスのデプロイメントセットが変更されても、インスタンスのホストは強制的に変更されません。 インスタンスをデプロイメントセットに追加できるのは、インスタンスが現在のホストに残っている場合のみです。 Forceパラメーターがfalseに設定されている場合、デプロイメントセットの変更に失敗する可能性があります。

規定値: false

Affinity String 任意 host

インスタンスを専用ホストに関連付けるかどうかを指定します。 設定可能な値は以下のとおりです。

  • host: インスタンスを専用ホストに関連付けます。 停止したインスタンスをエコノミーモードで起動すると、インスタンスは元の専用ホストのままになります。
  • default: インスタンスを専用ホストに関連付けません。 停止したインスタンスをエコノミーモードで起動すると、元の専用ホストのリソースが不足している場合、自動デプロイリソースプール内の別の専用ホストにインスタンスを自動的にデプロイできます。

When an instance is migrated from a shared host to a dedicated host, this parameter is set to default by default.

Tenancy String 任意 host

インスタンスを専用ホストにデプロイするかどうかを指定します。 値をhostに設定して、インスタンスを専用ホストにデプロイします。

MigrationType String 任意 live

移行先の専用ホストに移行する前にインスタンスを停止するかどうかを指定します。 設定可能な値は以下のとおりです。

  • reboot: 移行する前にインスタンスを停止します。
  • live: インスタンスを停止せずに移行します。 MigrationTypeパラメーターをliveに設定した場合、DedicatedHostIdパラメーターを指定する必要があります。 この場合、インスタンスの移行時にインスタンスのインスタンスタイプを変更することはできません。

デフォルト値: reboot。

InstanceType String 任意 ecs.c6.large

インスタンスが変更されるインスタンスタイプ。 DescribeInstanceTypesを呼び出して、インスタンスタイプの最新リストを照会できます。

インスタンスを専用ホストに移行するときに、インスタンスのインスタンスタイプを変更できます。 新しいインスタンスタイプは、指定された専用ホストのタイプと一致する必要があります。 詳細については、「専用ホストタイプ」をご参照ください。

  • このパラメーターを指定する場合は、DedicatedHostIdパラメーターも指定する必要があります。
  • 自動デプロイ機能を使用してインスタンスを移行する場合、インスタンスのインスタンスタイプを変更することはできません。
DedicatedHostClusterId String 任意 dc-bp67acfmxazb4ph ****

専用ホストクラスターのID。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

リクエストの ID です。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=ModifyInstanceDeployment
&InstanceId=i-bp67acfmxazb4ph ****
&RegionId=cn-hangzhou
&DedicatedHostId=dh-bp67acfmxazb4ph ****
&テナント=ホスト
&MigrationType=live
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyInstanceDeploymentResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</ModifyInstanceDeploymentResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 OperationDenied.UnstoppedInstance インスタンスが停止していないため、操作が拒否されました。 操作が無効な場合に返されるエラーメッセージ。 インスタンスがStopped状態かどうかを確認します。
400 InvalidDedicatedHostStatus.NotSupport Operation denied due to dedicated host status. この操作が、現在のステータスにある専用ホストではサポートされていない場合に返されるエラーメッセージ。
400 InvalidPeriod.ExceededDedicatedHost Instance expired date can't exceed dedicated host expired date. インスタンスの有効期限が専用ホストの有効期限よりも遅い場合に返されるエラーメッセージ。
400 InvalidParam.Tenancy The specified Tenancy is invalid. 指定された Tenancy パラメーターが無効な場合に返されるエラーメッセージ。
400 ChargeTypeViolation.PostPaidDedicatedHost Prepaid instance onto postpaid dedicated host is not allowed. サブスクリプションインスタンスを従量課金の専用ホストにデプロイできない場合に返されるエラーメッセージ。
400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. 指定された DedicatedHostId が存在しない場合に返されるエラーメッセージ。
400 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range. The error message returned because the specified InstanceType parameter does not exist or because you are not authorized to manage instances of the specified instance type.
403 IncorrectInstanceStatus %s 現在のインスタンスのステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。
403 OperationDenied.NoStock The resource is out of usage. インスタンスが実行中のステータスではない場合に返されるエラーメッセージ。 インスタンスを開始するか、指定された操作が有効かどうかを確認してください。
404 InvalidInstanceId.NotFound 指定されたInstanceIdは存在しません。 指定された InstanceId パラメーターが無効な場合に返されるエラーメッセージ。
404 InvalidInstanceNetworkType.NotSupport 指定されたインスタンスネットワークタイプはサポートしていません。 The error message returned because the network type of the instance does not support this operation.
404 InvalidInstanceType.NotSupport Dedicatedホストは、指定されたインスタンスタイプをサポートしていません。 現在の専用ホストが指定されたインスタンスタイプをサポートしていない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。