背景情報
このトピックでは、Elastic Compute Service (ECS) イベントの通知の概要について説明します。イベント通知は、リソースの変更に関する情報を提供するように設計されています。イベント通知を使用すると、イベントに対してメッセージ処理ミドルウェアを構成して、イベント駆動型の自動 O&M を実装し、SDK ポーリングを置き換えることができます。CloudOps Orchestration Service (OOS) は、テンプレートの実行ステータスとタスクの実行ステータスの通知を含む、イベント通知をサポートしています。詳細については、「システムイベントを表示する」および「システムイベントによってトリガーされるアラート」をご参照ください。
テンプレート実行ステータスの通知
OOS は、テンプレートの実行ステータスが変更されると通知を送信します。
OOS は、テンプレートの実行ステータスが開始、成功、または失敗に変更された場合にのみ、イベント通知を送信します。
OOS は、クラウドプロダクト操作によって作成されたサブ実行のイベント通知は送信しません。
通知フォーマット
{
"ver": "1.0",
"id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5",
"product": "OOS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:execution/exec-abc1792gcdoonr9an2uk",
"level": "INFO",
"name": "Execution:ExecutionStatusChange",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"executionId" : "exec-abc1792gcdoonr9an2uk",
"status" : "Success",
"templateId" : "t-89fb84c218e84fd58e14",
"templateVersion" : "v8",
"templateName" : "templateName",
"executedBy" : "admin(1234567)",
"startTime" : "2019-11-11T12:00Z",
"endTime" : "2019-11-11T13:00Z",
"duration" : 360,
"parentExecutionId" : "exec-3816c2a99c9146979da6"
}
}
イベント属性
次の表に、通知の固定トップレベルフィールドを示します。
フィールド | 説明 | 例 |
ID | イベントの ID。 | 9435EAD6-3CF6-4494-8F7A-3A********77 |
eventTime | イベントが発生した時刻 (UTC + 08:00)。 | 20181226T220114.058+0800 |
level | イベントのレベル。 | INFO |
name | イベントの名前。 | Execution:StatusChange |
product | プロダクトの名前。有効な値: OOS。 | OOS |
regionId | イベントが発生したリージョンの ID。詳細については、「DescribeRegions」をご参照ください。 | cn-hangzhou |
resourceId | リソースの ARN (Aliyun Resource Name)。 | acs:ecs:cn-hangzhou:1169070********30:execution/exec-abc1792gcdoonr9an2uk |
userId | ユーザーアカウント ID。 | 169070********30 |
content | イベントの詳細。次の表に、content フィールドのサブフィールドを示します。 | なし |
次の表に、content フィールドのサブフィールドを示します。
フィールド | 説明 | 例 |
executionId | テンプレートの実行 ID。 | exec-abc1792gcdoonr9an2uk |
status | テンプレートの実行ステータス。 | 成功 |
templateId | テンプレートの ID。 | t-89fb84c218e84fd58e14 |
templateVersion | テンプレートのバージョン。 | v8 |
templateName | テンプレートの名前。 | templateName |
executedBy | テンプレートを実行するユーザー。 | admin(1234567) |
startTime | 実行の開始時刻。 | 2019-11-11T11:00:00Z |
endTime | 実行の終了時刻。 | 2019-11-11T11:00:02Z |
duration | テンプレートの実行にかかった時間。単位: 秒。 | |
parentExecutionId | 親実行の ID。 | exec-3816c2a99c9146979da6 |
タスク実行ステータスの通知
OOS は、テンプレートタスクの実行ステータスが変更されると通知を送信します。
OOS は、タスクの実行ステータスが開始、成功、または失敗に変更された場合にのみ、イベント通知を送信します。
OOS は、クラウドプロダクト操作によって作成されたタスクのイベント通知は送信しません。
通知フォーマット
{
"ver": "1.0",
"id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5",
"product": "OOS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:taskexecution/task-exec-abc1792gcdoonr9an2uk",
"level": "INFO",
"name": "TaskExecution:StatusChange",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"taskExecutionId" : "task-exec-abc",
"taskAction" : "ACS::ExecuteApi",
"taskName" : "taskName",
"executionId" : "exec-18864d6b80a448dcbe62",
"status" : "Success",
"templateId" : "t-89fb84c218e84fd58e14",
"templateVersion" : "v8",
"templateName" : "templateName",
"startTime" : "2019-11-11T12:00Z",
"endTime" : "2019-11-11T12:01Z",
"duration" : 60
}
}
イベント属性
次の表に、通知の固定トップレベルフィールドを示します。
フィールド | 説明 | 例 |
ID | イベントの ID。 | 9435EAD6-3CF6-4494-8F7A-3A********77 |
eventTime | イベントが発生した時刻 (UTC + 08:00)。 | 20181226T220114.058+0800 |
level | イベントのレベル。 | INFO |
name | イベントの名前。 | TaskExecution:StatusChange |
product | プロダクトの名前。有効な値: OOS。 | OOS |
regionId | イベントが発生したリージョンの ID。詳細については、「DescribeRegions」をご参照ください。 | cn-hangzhou |
resourceId | リソースの ARN (Aliyun Resource Name)。 | acs:ecs:cn-hangzhou:169070********30:taskexecution/task-exec-abc1792gcdoonr9an2uk |
userId | ユーザーアカウント ID。 | 169070********30 |
content | イベントの詳細。 1 つ以上のサブフィールドを含めることができます。次の表に、content フィールドのサブフィールドを示します。 | なし |
次の表に、content フィールドのサブフィールドを示します。
フィールド | 説明 | 例 |
taskExecutionId | タスクの実行 ID。 | task-exec-abc1792gcdoonr9an2uk |
status | タスクの実行ステータス。 | 成功 |
taskAction | タスクの操作。 | ACS::ExecuteApi |
taskName | タスクの名前。 | taskName |
executionId | 実行 ID。 | exec-18864d6b80a448dcbe62 |
templateId | テンプレートの ID。 | t-89fb84c218e84fd58e14 |
templateVersion | テンプレートのバージョン。 | v8 |
templateName | テンプレートの名前。 | templateName |
executedBy | タスクを実行するユーザー。 | admin(1234567) |
startTime | タスク実行の開始時刻。 | 2019-11-11T11:00:00Z |
endTime | タスク実行の終了時刻。 | 2019-11-11T11:00:01Z |
duration | タスクの実行にかかった時間。単位: 秒。 | 60 |