翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS DevOps エージェントイベントの詳細リファレンス
AWS サービスからのイベントには、`source`、、、`detail-type``account`、 `region`などの一般的なメタデータフィールドがあります`time`。これらのイベントには、サービスに固有のデータを含む`detail`フィールドも含まれます。 AWS DevOps エージェントイベントの場合、 `source`は常に `aws.aidevops`であり、 は特定のイベント`detail-type`を識別します。
## 調査イベント
次の`detail-type`値は調査イベントを識別します。
+ `Investigation Created`
+ `Investigation Priority Updated`
+ `Investigation In Progress`
+ `Investigation Completed`
+ `Investigation Failed`
+ `Investigation Timed Out`
+ `Investigation Cancelled`
+ `Investigation Pending Triage`
+ `Investigation Linked`
+ `Investigation Skipped`
`source` および `detail-type`フィールドには、 AWS DevOps エージェントイベントの特定の値が含まれているため、以下が含まれます。すべてのイベントに含まれる他のメタデータフィールドの定義については、「*Amazon EventBridge イベントリファレンス*」の「[イベントの構造](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)」を参照してください。
以下は、調査イベントの JSON 構造です。
```
{
. . .,
"detail-type" : "string",
"source" : "aws.aidevops",
. . .,
"detail" : {
"version" : "string",
"metadata" : {
"agent_space_id" : "string",
"task_id" : "string",
"execution_id" : "string"
},
"data" : {
"task_type" : "string",
"priority" : "string",
"status" : "string",
"created_at" : "string",
"updated_at" : "string",
"summary_record_id" : "string"
}
}
}
```
**`detail-type`** イベントのタイプを識別します。調査イベントの場合、これは前述のイベント名の 1 つです。
**`source`** イベントを生成したサービスを識別します。 AWS DevOps エージェントイベントの場合、この値は です`aws.aidevops`。
**`detail`** イベント固有のデータを含む JSON オブジェクト。`detail` オブジェクトには次のフィールドが含まれます。
+ `version` (文字列) – イベント詳細のスキーマバージョン。現在 `1.0.0`。
+ `metadata.agent_space_id` (文字列) – イベントが発生したエージェントスペースの一意の識別子。
+ `metadata.task_id` (文字列) – タスクの一意の識別子。
+ `metadata.execution_id` (文字列) – 実行実行の一意の識別子。実行が調査に割り当てられたときに表示されます。
+ `data.task_type` (文字列) – タスクのタイプ。値: `INVESTIGATION`。
+ `data.priority` (文字列) – 優先度レベル。値: `CRITICAL`、`HIGH`、`MEDIUM`、`LOW`、`MINIMAL`。
+ `data.status` (文字列) – 現在のステータス。値: `PENDING_START`、`IN_PROGRESS`、`COMPLETED`、、`FAILED`、`TIMED_OUT`、`CANCELLED`、`PENDING_TRIAGE``LINKED`、。 `SKIPPED`
+ `data.created_at` (文字列) – タスクが作成されたときの ISO 8601 タイムスタンプ。
+ `data.updated_at` (文字列) – タスクが最後に更新されたときの ISO 8601 タイムスタンプ。
+ `data.summary_record_id` (文字列) – 調査結果を含むサマリーレコードの識別子。完了した調査の概要が生成された場合に含まれます。この識別子を使用してレコードタイプが のジャーナルレコードを検索することで、 AWS DevOps Agent API を通じて概要コンテンツを取得できます`investigation_summary_md`。
**例: 調査完了イベント**
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789015",
"detail-type": "Investigation Completed",
"source": "aws.aidevops",
"account": "123456789012",
"time": "2026-03-12T18:10:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
],
"detail": {
"version": "1.0.0",
"metadata": {
"agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
"task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
"execution_id": "b2c3d4e5-6789-01ab-cdef-example22222"
},
"data": {
"task_type": "INVESTIGATION",
"priority": "CRITICAL",
"status": "COMPLETED",
"created_at": "2026-03-12T18:00:00Z",
"updated_at": "2026-03-12T18:10:00Z",
"summary_record_id": "d4e5f6g7-6789-01ab-cdef-example44444"
}
}
}
```
**例: 調査失敗イベント**
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789016",
"detail-type": "Investigation Failed",
"source": "aws.aidevops",
"account": "123456789012",
"time": "2026-03-12T18:10:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
],
"detail": {
"version": "1.0.0",
"metadata": {
"agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
"task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
"execution_id": "b2c3d4e5-6789-01ab-cdef-example22222"
},
"data": {
"task_type": "INVESTIGATION",
"priority": "CRITICAL",
"status": "FAILED",
"created_at": "2026-03-12T18:00:00Z",
"updated_at": "2026-03-12T18:10:00Z"
}
}
}
```
## 緩和イベント
次の`detail-type`値は緩和イベントを識別します。
+ `Mitigation In Progress`
+ `Mitigation Completed`
+ `Mitigation Failed`
+ `Mitigation Timed Out`
+ `Mitigation Cancelled`
`source` および `detail-type`フィールドには、 AWS DevOps エージェントイベントの特定の値が含まれているため、以下が含まれます。すべてのイベントに含まれる他のメタデータフィールドの定義については、「*Amazon EventBridge イベントリファレンス*」の「[イベントの構造](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)」を参照してください。
以下は、緩和イベントの JSON 構造です。
```
{
. . .,
"detail-type" : "string",
"source" : "aws.aidevops",
. . .,
"detail" : {
"version" : "string",
"metadata" : {
"agent_space_id" : "string",
"task_id" : "string",
"execution_id" : "string"
},
"data" : {
"task_type" : "string",
"priority" : "string",
"status" : "string",
"created_at" : "string",
"updated_at" : "string",
"summary_record_id" : "string"
}
}
}
```
**`detail-type`** イベントのタイプを識別します。緩和イベントの場合、これは前述のイベント名の 1 つです。
**`source`** イベントを生成したサービスを識別します。 AWS DevOps エージェントイベントの場合、この値は です`aws.aidevops`。
**`detail`** イベント固有のデータを含む JSON オブジェクト。`detail` オブジェクトには次のフィールドが含まれます。
+ `version` (文字列) – イベント詳細のスキーマバージョン。現在 `1.0.0`。
+ `metadata.agent_space_id` (文字列) – イベントが発生したエージェントスペースの一意の識別子。
+ `metadata.task_id` (文字列) – タスクの一意の識別子。
+ `metadata.execution_id` (文字列) – 実行実行の一意の識別子。実行が緩和に割り当てられたときに表示されます。
+ `data.task_type` (文字列) – タスクのタイプ。値: `INVESTIGATION`。
+ `data.priority` (文字列) – 優先度レベル。値: `CRITICAL`、`HIGH`、`MEDIUM`、`LOW`、`MINIMAL`。
+ `data.status` (文字列) – 現在のステータス。値: `IN_PROGRESS`、`COMPLETED`、`FAILED`、`TIMED_OUT`、`CANCELLED`。
+ `data.created_at` (文字列) – タスクが作成されたときの ISO 8601 タイムスタンプ。
+ `data.updated_at` (文字列) – タスクが最後に更新されたときの ISO 8601 タイムスタンプ。
+ `data.summary_record_id` (文字列) – 緩和結果を含むサマリーレコードの識別子。完了した緩和策の概要が生成された場合に含まれます。この識別子を使用してレコードタイプが のジャーナルレコードを検索することで、 AWS DevOps Agent API を通じて概要コンテンツを取得できます`mitigation_summary_md`。
**例: 緩和完了イベント**
```
{
"version": "0",
"id": "12345678-1234-1234-1234-12345678901c",
"detail-type": "Mitigation Completed",
"source": "aws.aidevops",
"account": "123456789012",
"time": "2026-03-12T18:20:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
],
"detail": {
"version": "1.0.0",
"metadata": {
"agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
"task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
"execution_id": "c3d4e5f6-7890-12ab-cdef-example33333"
},
"data": {
"task_type": "INVESTIGATION",
"priority": "CRITICAL",
"status": "COMPLETED",
"created_at": "2026-03-12T18:00:00Z",
"updated_at": "2026-03-12T18:20:00Z",
"summary_record_id": "e5f6g7h8-7890-12ab-cdef-example55555"
}
}
}
```
**例: 緩和失敗イベント**
```
{
"version": "0",
"id": "12345678-1234-1234-1234-12345678901d",
"detail-type": "Mitigation Failed",
"source": "aws.aidevops",
"account": "123456789012",
"time": "2026-03-12T18:20:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
],
"detail": {
"version": "1.0.0",
"metadata": {
"agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
"task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
"execution_id": "c3d4e5f6-7890-12ab-cdef-example33333"
},
"data": {
"task_type": "INVESTIGATION",
"priority": "CRITICAL",
"status": "FAILED",
"created_at": "2026-03-12T18:00:00Z",
"updated_at": "2026-03-12T18:20:00Z"
}
}
}
```