Elastic Compute Service:ModifyInstanceDeployment

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

インスタンスの ID。

移行先の専用ホストの ID。DescribeDedicatedHosts 操作を呼び出して、最新の専用ホストのリストをクエリできます。

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

• インスタンスを特定の専用ホストに移行するには、このパラメーターを指定します。

• インスタンスをシステムが選択した専用ホストに移行するには、このパラメーターを空のままにし、Tenancy を `host` に設定します。

自動デプロイ機能の詳細については、「機能と特徴」をご参照ください。

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

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

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

インスタンスのデプロイメントセットが変更されたときに、インスタンスのホストを強制的に変更するかどうかを指定します。有効値：

• true：インスタンスのデプロイメントセットが変更されたときに、インスタンスのホストを強制的に変更します。ホストの強制変更は、実行中 (Running) または 停止済み (Stopped) 状態のインスタンスに対してのみ可能です。停止済み (Stopped) 状態のインスタンスには、節約モードで停止された従量課金インスタンスは含まれません。

  **

  注 指定されたインスタンスにローカルディスクがアタッチされている場合、インスタンスのホストが強制的に変更されると、ローカルディスクも強制的に変更されます。これにより、ローカルディスク内のデータが失われる可能性があります。操作は慎重に行ってください。

• false：インスタンスのデプロイメントセットが変更されたときに、インスタンスのホストを強制的に変更しません。インスタンスが現在のホストにとどまる場合にのみ、インスタンスをデプロイメントセットに追加できます。Force パラメーターが false に設定されている場合、デプロイメントセットの変更に失敗することがあります。

デフォルト値：false。

インスタンスを専用ホストに関連付けるかどうかを指定します。有効値：

• host：インスタンスを専用ホストに関連付けます。節約モードで停止したインスタンスを起動すると、インスタンスは元の専用ホストにとどまります。

• default：インスタンスを専用ホストに関連付けません。節約モードで停止したインスタンスを起動すると、元の専用ホストのリソースが不足している場合、インスタンスは自動デプロイリソースプール内の別の専用ホストに自動的にデプロイされることがあります。

インスタンスを共有ホストから専用ホストに移行する場合は、デフォルト値を使用します。デフォルト値：default。

インスタンスを専用ホストにデプロイするかどうかを指定します。値を `host` に設定します。これは、インスタンスが専用ホストにデプロイされることを示します。

インスタンスを移行先の専用ホストに移行する前に停止するかどうかを指定します。有効値：

• reboot：移行前にインスタンスを停止します。

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

デフォルト値：reboot。

インスタンスの変更後のインスタンスタイプ。DescribeInstanceTypes 操作を呼び出して、最新のインスタンスタイプのリストをクエリできます。

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

• このパラメーターを指定する場合は、DedicatedHostId も指定する必要があります。

• 自動デプロイ機能を使用してインスタンスを移行する場合、インスタンスのインスタンスタイプは変更できません。

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

指定されたインスタンスを指定されたデプロイメントセットから削除するかどうかを指定します。有効値：

• true

• false

デフォルト値：false。