ECS (Elastic Compute Service) は、O&Mイベント、ライフサイクルステータス変更イベント、プリエンプティブルインスタンスリリースイベントなどのインスタンスイベントの通知を送信できます。
Events
ECSは、次のインスタンスイベントの通知を送信できます。
O&Mイベント
インスタンスでO&Mイベントが発生すると、ECSはイベントの最初の通知を送信し、その後、イベントのステータスが変更されるたびに通知を送信します。 O&Mイベントの通知の名前については、このトピックの付録: インスタンス関連のO&Mイベントの通知を参照してください。
次のサンプルコードのスニペットは、システムメンテナンスによるインスタンスの再起動 (SystemMaintenance.Reboot) イベントのJSON形式の通知の例を示しています。
O&MイベントがScheduled (Scheduled) 状態であることを示すサンプルの最初の通知:
{ "id": "2256A988-0B26-4E2B-820A-8A********E5", "product": "ECS", "resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go", "level": "CRITICAL", "name": "Instance:SystemMaintenance.Reboot:Scheduled", "userId": "169070********30", "eventTime": "20190409T121826.922+0800", "regionId": "cn-hangzhou", "content": { "eventId": "e-bp11trd********pqum2", "publishTime": "2019-04-09T04:18:26Z", "notBefore": "2019-04-12T01:01:01Z", "instanceId": "i-bp1ecr********5go2go", "eventType": "SystemMaintenance.Reboot", "eventStatus": "Scheduled" } }
notBeforeフィールドで指定された時間より前にインスタンスを再起動すると、O&Mイベントは回避され、ECSからO&Mイベントのステータスが回避済み (回避済み) に変更されたことを示す通知が送信されます。 サンプル通知:
{ "id": "2256A988-0B26-4E2B-820A-8A********E5", "product": "ECS", "resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go", "level": "CRITICAL", "name": "Instance:SystemMaintenance.Reboot:Scheduled", "userId": "169070********30", "eventTime": "20190410T160101.922+0800", "regionId": "cn-hangzhou", "content": { "eventId": "e-bp11trdr********qum2", "publishTime": "2019-04-09T04:18:26Z", "notBefore": "2019-04-12T01:01:01Z", "instanceId": "i-bp1ecr********5go2go", "eventType": "SystemMaintenance.Reboot", "eventStatus": "Avoided", "executeStartTime": "2019-04-10T08:01:01Z", "executeFinishTime": "2019-04-10T08:01:01Z" } }
次の表に、contentパラメーターに含まれるフィールドを示します。
フィールド | 説明 | 例 |
eventId | O&MイベントのID。 | e-t4navn7 ******** 6x 5no |
publishTime | O&Mイベントが発行された時刻。 | 2019-04-09T04:18:26Z |
notBefore | O&Mイベントの開始予定時刻。 notBeforeフィールドは、メンテナンスイベントでのみ使用できます。 | 2019-04-12T01:01:01Z |
instanceId | 影響を受けるインスタンスのID。 | i-bp1ecr ******** 5go 2go |
eventType | O&Mイベントのタイプ。 このフィールドの有効な値については、「概要」をご参照ください。 | SystemMaintenance.Reboot |
eventStatus | O&Mイベントのステータス。 このフィールドの有効な値については、「概要」をご参照ください。 | 回避 |
executeStartTime | イベントに関連するO&Mタスクの開始時刻。 時刻は UTC です。 | 2019-04-10T08:01:01Z |
executeFinishTime | イベントに関連するO&Mタスクの終了時刻。 時刻は UTC です。 説明 executeStartTimeおよびexecuteFinishTimeフィールドは、Executing (Executing) 、Executed (Executed) 、Canceled (Canceled) 、またはAvoided (Avoided) 状態のO&Mイベントでのみ使用できます。 | 2019-04-10T08:01:01Z |
ライフサイクルステータス変更イベント
インスタンスのステータスが変更されると、ECSからイベント通知が送信されます。 インスタンスのステータスの変更については、「インスタンスのライフサイクル」をご参照ください。
次のサンプルコードは、インスタンスのステータスが [実行中] ([実行中]) に変わったときに送信されるイベント通知の例を示しています。
{
"id": "2256A988-0B26-4E2B-820A-8A********E5",
"product": "ECS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go",
"level": "INFO",
"name": "Instance:StateChange",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"resourceId": "i-bp1ecr********5go2go",
"resourceType": "ALIYUN::ECS::Instance",
"state": "Running"
}
}
次の表に、contentパラメーターに含まれるフィールドを示します。
フィールド | 説明 | 例 |
resourceId | インスタンスの ID です。 | i-bp1ecr ******** 5go 2go |
resourceType | リソースのタイプを示します。 有効値:ALIYUN::ECS::Instance。 | ALIYUN::ECS:: インスタンス |
state | インスタンスのステータス。 有効な値:
| 実行中 |
プリエンプティブルインスタンスのリリースイベント
プリエンプティブルインスタンスは、市場価格の変動またはリソース不足によりリリースされる可能性があります。 ECSは、プリエンプティブルインスタンスがリリースされる5分前にイベント通知を送信し、インスタンスの中断を通知します。 詳細については、「概要」をご参照ください。
次のサンプルコードは、JSON形式のイベント通知の例を示しています。
{
"id": "2256A988-0B26-4E2B-820A-8A********E5",
"product": "ECS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go",
"level": "INFO",
"name": "Instance:PreemptibleInstanceInterruption",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"instanceId": "i-bp1ecr********5go2go",
"action": "delete"
}
}
次の表に、contentパラメーターに含まれるフィールドを示します。
フィールド | 説明 | 例 |
instanceId | プリエンプティブルインスタンスの ID。 | i-bp1ecr ******** 5go 2go |
アクション | プリエンプティブルインスタンスに対して実行されるアクション。 有効値: delete 。 | 削除 |
専用ホスト上のインスタンスのホット移行イベント
ModifyInstanceDeployment操作を呼び出して、ホット移行を実行し、専用ホスト間でインスタンスを移行できます。 ホットマイグレーションは非同期操作であり、インスタンスのステータスは移行プロセス中に変更されません。 Instance:LiveMigrationAcrossDDHイベントの通知を設定して、移行タスクの進行状況に関する更新を受信できます。
次のサンプルコードのスニペットは、JSON形式のイベント通知の例を示しています。
ホット移行タスクが開始するイベントの通知例:
{ "id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5", "product": "ECS", "resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go", "level": "INFO", "instanceName": "instance-event-subscription", "name": "Instance:LiveMigrationAcrossDDH", "userId": "169070********30", "eventTime": "20180608T092537.922+0800", "regionId": "cn-hangzhou", "content": { "instanceId" : "i-bp1ecr********5go2go", "sourceDedicatedHostId" : "dh-2ze3lm********t8nr82", "destinationDedicatedHostId" : "dh-2ze3lm********t8nr83", "startTime" : "2018-06-08T01:25:37Z", "status" : "started" } }
ホット移行タスクが完了したイベントの通知例:
{ "id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5", "product": "ECS", "resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go", "level": "INFO", "instanceName": "instance-event-subscription", "name": "Instance:LiveMigrationAcrossDDH", "userId": "169070********30", "eventTime": "20180608T092545.922+0800", "regionId": "cn-hangzhou", "content": { "instanceId" : "i-bp1ecr********5go2go", "sourceDedicatedHostId" : "dh-2ze3lm********t8nr82", "destinationDedicatedHostId" : "dh-2ze3lm********t8nr83", "startTime" : "2018-06-08T01:25:37Z", "endTime" : "2018-06-08T01:25:45Z", "status" : "accomplished" } }
ホット移行タスクが失敗したイベントのサンプル通知:
{ "id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5", "product": "ECS", "resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go", "level": "INFO", "instanceName": "instance-event-subscription", "name": "Instance:LiveMigrationAcrossDDH", "userId": "169070********30", "eventTime": "20180608T092545.922+0800", "regionId": "cn-hangzhou", "content": { "instanceId" : "i-bp1ecr********5go2go", "sourceDedicatedHostId" : "dh-2ze3lm********t8nr82", "destinationDedicatedHostId" : "dh-2ze3lm********t8nr83", "startTime" : "2018-06-08T01:25:37Z", "endTime" : "2018-06-08T01:25:45Z", "status" : "failed" } }
次の表に、contentパラメーターに含まれるフィールドを示します。
フィールド | 説明 | 例 |
instanceId | インスタンスの ID です。 | i-bp1ecr ******** 5go 2go |
sourceDedicatedHostId | ソース専用ホストのID。 | dh-2ze3lm ******** t8nr82 |
destinationDedicatedHostId | 宛先専用ホストのID。 | dh-2ze3lm ******** t8nr83 |
startTime | ホット移行タスクの開始時刻。 時刻は UTC です。 | 2018-06-08T01:25:37Z |
endTime | ホット移行タスクの終了時刻。 時刻は UTC です。 | 2018-06-08T01:25:45Z |
status | ホット移行タスクのステータス。 有効な値:
| 達成済み |
バースト可能インスタンスのパフォーマンスモード変更イベント
バースト可能インスタンスのパフォーマンスモードが変更された場合、ECSはinstance: PerformanceModeChangeイベントの通知を送信します。
次のサンプルコードは、JSON形式のイベント通知の例を示しています。
{
"id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5",
"product": "ECS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go",
"level": "INFO",
"name": "Instance:PerformanceModeChange",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"instanceId" : "i-bp1ecr********5go2go",
"creditSpecification" : "Unlimited",
"operator" : "System"
}
}
次の表に、contentパラメーターに含まれるフィールドを示します。
フィールド | 説明 | 例 |
instanceId | バースト可能なインスタンスのID。 | i-bp1ecr ******** 5go 2go |
creditSpecification | バースト可能インスタンスの新しいパフォーマンスモード。 有効な値:
| 標準 |
演算子 | イベントをトリガーする演算子。 有効な値:
| ユーザー |
バースト可能インスタンスの限定パフォーマンスイベント
バースト可能インスタンスのCPUクレジットが使い果たされると、インスタンスはベースラインパフォーマンスに制限され、標準モードで実行されます。 上記のシナリオが発生すると、Instance:BurstablePerformanceRestrictedという名前のイベントが生成されます。
各インスタンス: BurstablePerformanceRestrictedイベントは1時間続きます。 イベントの開始時間と終了時間は1時間離れています。 このイベントは、インスタンスがイベントウィンドウの一部のベースラインパフォーマンスに制限されていることを示しますが、必ずしもインスタンスがイベントウィンドウ全体にわたってベースラインパフォーマンスに制限されていることを示しているわけではありません。 インスタンスが長期間にわたってベースラインパフォーマンスに制限されている場合、instance: BurstablePerformanceRestrictedイベントが1時間ごとに生成されます。
次のサンプルコードは、JSON形式のイベント通知の例を示しています。
{
"id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5",
"product": "ECS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go",
"level": "INFO",
"name": "Instance:BurstablePerformanceRestricted",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"instanceId" : "i-bp1ecr********5go2go",
"intervalStart" : "2019-11-11T11:00Z",
"intervalEnd" : "2019-11-11T12:00Z"
}
}
次の表に、contentパラメーターに含まれるフィールドを示します。
フィールド | 説明 | 例 |
instanceId | インスタンスの ID です。 | i-bp1ecr ******** 5go 2go |
intervalStart | イベントウィンドウの開始時刻。 時刻は UTC です。 | 2019-11-11T11:00Z |
intervalEnd | イベントウィンドウの終了時刻。 時刻は UTC です。 | 2019-11-11T12:00Z |
付録: インスタンス関連のO&Mイベントの通知
影響 | イベントタイプとコード | イベント通知名とコード |
インスタンスが再起動されました。 | システムメンテナンスによるインスタンスの再起動 (SystemMaintenance.Reboot) |
|
インスタンスが予期せず再起動されました。 | システムエラーによるインスタンスの再起動 (SystemFailure.Reboot) |
|
インスタンスが予期せず再起動されました。 | インスタンスエラーによるインスタンスの再起動:InstanceFailure.Reboot |
|
インスタンスが再デプロイされました。 | システムメンテナンスによるインスタンスの再デプロイ (SystemMaintenance.Redeploy) |
|
インスタンスが再デプロイされました。 | システムエラーによるインスタンスの再デプロイ (SystemFailure.Redeploy) |
|
インスタンスが再起動され、破損したローカルディスクが分離されます。 | システムメンテナンスによるインスタンスの再起動とローカルディスクの交換 (SystemMaintenance.RebootAndIsolateErrorDisk) |
|
インスタンスが再起動され、破損したローカルディスクが復元されます。 | システムメンテナンスによるインスタンスの再起動とローカルディスクの再初期化 (SystemMaintenance.RebootAndReInitErrorDisk) |
|
インスタンスがリリースされました。 | インスタンス作成の失敗によるインスタンスの自動リリース (SystemFailure.Delete) |
|