RedeployInstance を呼び出して、ECS インスタンスがイベント通知を受信した再にインスタンスを再デプロイすることができます。

説明

RedeployInstance は非同期処理です。 この操作では、インスタンスの再起動前にデータを移行します。 再デプロイメントが成功すると、インスタンスは使用中の状態になります。 再デプロイメントが失敗すると、インスタンスは元の物理サーバーに戻り、操作前の元の状態に戻ります。 本インターフェイスを呼び出す際は次の点に留意してください。

  • 以下のいずれかのシステムイベントが発生した場合は、RedeployInstance を実行することができます。 システムイベントに関する詳細については、システムイベントをご参照ください。
    • SystemMaintenance.Reboot および SystemMaintenance.Redeploy のイベントがスケジュール済みの状態である。
    • SystemFailure.Reboot のイベントが実行中の状態である (ローカルディスクのインスタンスのみが対象) 。

      警告 ローカルディスクのインスタンスを再デプロイすると、ディスクは初期化・クリアされます。 この操作を行う際は注意を払ってください。
  • ターゲットインスタンスのステータスは実行中または停止中である必要があります。 再デプロイメント後、インスタンスのステータスは次のように変わります。
    • 使用中のインスタンスは停止中の状態になります。
    • 停止中のインスタンスは起動中の状態になります。
  • OperationLocks パラメーターの値が LockReason: security の場合は、インスタンスを再デプロイすることはできません。
  • 専用ホストのインスタンスは再デプロイすることはできません。

デバッグ

Alibaba Cloud は、API の使用を簡素化するために OpenAPI Explorer を提供しています。 OpenAPI Explorer を使用して、API の検索、API の呼び出し、SDK サンプルコードの動的生成を行うことができます。

リクエストパラメーター

パラメーター データ型 必須/省略可能 説明
InstanceId String 必須 i-bp1azkttqpldxgted****

使用中または停止中の状態のインスタンスの ID 。

Action String 省略可能 RedeployInstance

実行する操作。 このパラメーターを RedeployInstance に設定します。 リクエスト HTTP または HTTPS URL に異なるパラメーターが含まれている場合、Actionが必要になります。

ForceStop Boolean 省略可能 false

使用中のインスタンスの使用停止を強制するかを指定します。 規定値:false

強制停止はサーバーの物理的な終了と同等です。 この操作は、インスタンスのデータがディスクに書き込まれていない場合、データ損失の原因になる場合があります。 停止中の状態のインスタンスを再デプロイすることを推奨します。

レスポンスパラメーター

パラメーター データ型 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID 。

TaskId String t-bp10e8orkp********8x

再デプロイメントタスクの ID 。 DescribeTasks を呼び出してマイグレーション結果を表示することができます。 DescribeTasks を呼び出す際の必要パラメーターの例は以下の通りです。

  • リクエスト例:TaskIds=["t-bp10e8or******c74o8x", "t-bp10e8orkpqm0lc74o8y"]TaskAction=RedeployInstance
  • レスポンス例:
    • TaskStatus=Processing. インスタンスの再デプロイ中の状態であることを示します。
    • TaskStatus=Finished. インスタンスの再デプロイが完了し、使用中の状態であることを示します。
    • TaskStatus=Failed. 再デプロイが失敗した状態を示します。インスタンスは元の物理サーバーに戻り、操作前の元の状態が復元されています。 操作が失敗した場合、Alibaba Cloud にチケットを起票してテクニカルサポートへお問い合わせください。

リクエストの例

https://ecs.aliyuncs.com/?Action=RedeployInstance
&InstanceId=i-bp1azkttqpldxgted****
&<Common request parameters>

通常のレスポンス例

XML 形式

<RedeployInstanceResponse>
    <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
    <TaskId>t-bp10e8orkp********8x</TaskId>
</RedeployInstanceResponse>

JSON 形式

{
	"RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
	"TaskId":"t-bp10e8orkp********8x"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidInstanceId.NotFound 指定された InstanceId は、レコードに存在しません。 指定されたインスタンスが存在しない場合に返されるエラーメッセージ。
403 IncorrectInstanceStatus リソースの現在のステータスでは、この操作を実行できません。 リソースの現在のステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。
403 InstanceLockedForSecurity セキュリティ上の理由によりインスタンスがロックされているため、指定された操作は拒否されました。 セキュリティ上の理由によりインスタンスがロックされているため、該当の操作がサポートされていない場合に返されるエラーメッセージ。
403 DiskError IncorrectDiskStatus。 指定されたディスクステータスが無効な場合に返されるエラーメッセージ。
500 InternalError 不明なエラーが発生したため、リクエスト処理に失敗しました。 内部エラーが発生した場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 問題が解決しない場合は、チケットを起票してください。
403 InstanceExpiredOrInArrears 前払いインスタンスが期限切れ (前払いモード) または延滞 (後払いモード) のため、指定された操作が拒否されました。 サブスクリプションインスタンスの有効期限が切れた場合に返されるエラーメッセージ。 インスタンスを更新して、もう一度お試しください。
403 IncorrectInstanceStatus %s 現在のインスタンスのステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。

エラーコードの表示