

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# AWS DevOps Detailreferenz zu Agentenereignissen
<a name="integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-devops-agent-events-detail-reference"></a>

Ereignisse von AWS Diensten haben gemeinsame Metadatenfelder`source`, darunter`detail-type`,`account`,`region`, und`time`. Diese Ereignisse enthalten auch ein `detail` Feld mit dienstspezifischen Daten. Bei AWS DevOps Agent-Ereignissen `source` ist das immer `aws.aidevops` und das `detail-type` identifiziert das spezifische Ereignis.

## Ermittlungsereignisse
<a name="investigation-events"></a>

Die folgenden `detail-type` Werte identifizieren Ermittlungsereignisse:
+ `Investigation Created`
+ `Investigation Priority Updated`
+ `Investigation In Progress`
+ `Investigation Completed`
+ `Investigation Failed`
+ `Investigation Timed Out`
+ `Investigation Cancelled`
+ `Investigation Pending Triage`
+ `Investigation Linked`
+ `Investigation Skipped`

Die `detail-type` Felder `source` und sind unten aufgeführt, da sie spezifische Werte für AWS DevOps Agentenereignisse enthalten. Definitionen der anderen Metadatenfelder, die in allen Ereignissen enthalten sind, finden Sie unter [Event-Struktur](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) in der *Amazon EventBridge Events-Referenz*.

Im Folgenden finden Sie die JSON-Struktur für Ermittlungsereignisse.

```
{
  . . .,
  "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`**Identifiziert den Ereignistyp. Bei Ermittlungsereignissen ist dies einer der oben aufgeführten Ereignisnamen.

**`source`**Identifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agent-Ereignisse ist dieser Wert`aws.aidevops`.

**`detail`**Ein JSON-Objekt, das ereignisspezifische Daten enthält. Das `detail` Objekt umfasst die folgenden Felder:
+ `version`(string) — Die Schemaversion des Ereignisdetails. Derzeit`1.0.0`.
+ `metadata.agent_space_id`(string) — Die eindeutige Kennung des Agentenbereichs, in dem das Ereignis seinen Ursprung hat.
+ `metadata.task_id`(string) — Die eindeutige Kennung der Aufgabe.
+ `metadata.execution_id`(string) — Die eindeutige Kennung des Ausführungslaufs. Vorhanden, wenn der Untersuchung eine Hinrichtung zugewiesen wurde.
+ `data.task_type`(string) — Der Typ der Aufgabe. Wert:`INVESTIGATION`.
+ `data.priority`(string) — Die Prioritätsstufe. Werte:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(string) — Der aktuelle Status. Werte:`PENDING_START`,`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`,`PENDING_TRIAGE`,`LINKED`,`SKIPPED`.
+ `data.created_at`(string) — ISO 8601-Zeitstempel, als die Aufgabe erstellt wurde.
+ `data.updated_at`(string) — ISO 8601-Zeitstempel, als die Aufgabe zuletzt aktualisiert wurde.
+ `data.summary_record_id`(string) — Die Kennung des zusammenfassenden Datensatzes, der die Untersuchungsergebnisse enthält. Ist enthalten, wenn eine Zusammenfassung für die abgeschlossene Untersuchung generiert wird. Sie können den Inhalt der Zusammenfassung über die AWS DevOps Agenten-API abrufen, indem Sie diese Kennung verwenden, um nach dem Journaldatensatz mit dem Datensatztyp zu suchen`investigation_summary_md`.

**Beispiel: Ereignis „Untersuchung abgeschlossen“**

```
{
  "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"
    }
  }
}
```

**Beispiel: Ereignis „Untersuchung fehlgeschlagen“**

```
{
  "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"
    }
  }
}
```

## Ereignisse zur Schadensbegrenzung
<a name="mitigation-events"></a>

Die folgenden `detail-type` Werte identifizieren Minderungsereignisse:
+ `Mitigation In Progress`
+ `Mitigation Completed`
+ `Mitigation Failed`
+ `Mitigation Timed Out`
+ `Mitigation Cancelled`

Die `detail-type` Felder `source` und sind unten aufgeführt, da sie spezifische Werte für AWS DevOps Agentenereignisse enthalten. Definitionen der anderen Metadatenfelder, die in allen Ereignissen enthalten sind, finden Sie unter [Event-Struktur](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) in der *Amazon EventBridge Events-Referenz*.

Im Folgenden finden Sie die JSON-Struktur für Minderungsereignisse.

```
{
  . . .,
  "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`**Identifiziert den Ereignistyp. Für Minderungsereignisse ist dies einer der zuvor aufgeführten Ereignisnamen.

**`source`**Identifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agent-Ereignisse ist dieser Wert`aws.aidevops`.

**`detail`**Ein JSON-Objekt, das ereignisspezifische Daten enthält. Das `detail` Objekt umfasst die folgenden Felder:
+ `version`(string) — Die Schemaversion des Ereignisdetails. Derzeit`1.0.0`.
+ `metadata.agent_space_id`(string) — Die eindeutige Kennung des Agentenbereichs, in dem das Ereignis seinen Ursprung hat.
+ `metadata.task_id`(string) — Die eindeutige Kennung der Aufgabe.
+ `metadata.execution_id`(string) — Die eindeutige Kennung des Ausführungslaufs. Vorhanden, wenn der Schadensbegrenzung eine Ausführung zugewiesen wurde.
+ `data.task_type`(string) — Der Typ der Aufgabe. Wert:`INVESTIGATION`.
+ `data.priority`(string) — Die Prioritätsstufe. Werte:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(string) — Der aktuelle Status. Werte:`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`.
+ `data.created_at`(string) — ISO 8601-Zeitstempel, als die Aufgabe erstellt wurde.
+ `data.updated_at`(string) — ISO 8601-Zeitstempel, als die Aufgabe zuletzt aktualisiert wurde.
+ `data.summary_record_id`(string) — Die Kennung des zusammenfassenden Datensatzes, der die Ergebnisse zur Risikominderung enthält. Ist enthalten, wenn eine Zusammenfassung für die abgeschlossene Abhilfemaßnahme generiert wird. Sie können den Inhalt der Zusammenfassung über die AWS DevOps Agenten-API abrufen, indem Sie diese Kennung verwenden, um nach dem Journaldatensatz mit dem Datensatztyp zu suchen. `mitigation_summary_md`

**Beispiel: Ereignis „Schadensbegrenzung abgeschlossen“**

```
{
  "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"
    }
  }
}
```

**Beispiel: Ereignis „Schadensbegrenzung fehlgeschlagen“**

```
{
  "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"
    }
  }
}
```