

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 Agentenereignissen `source` ist immer `aws.aidevops` und das `detail-type` identifiziert das spezifische Ereignis.

Das `time` Feld gibt den Zeitpunkt an, zu dem die Untersuchung oder die Risikominderung zuletzt aktualisiert wurde. Es ist nicht der Zeitpunkt, an dem das Ereignis EventBridge empfangen wurde. Felder`detail`, die keinen Wert haben, werden weggelassen und nicht auf gesetzt`null`. Daher müssen Sie `metadata.execution_id` und `data.summary_record_id` als optional behandeln.

## Ereignisse im Zusammenhang mit Ermittlungen
<a name="investigation-events"></a>

Die folgenden `detail-type` Werte kennzeichnen 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 zuvor aufgeführten Ereignisnamen.

**`source`**Identifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agentenereignisse lautet 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, aus dem das Ereignis hervorgegangen ist.
+ `metadata.task_id`(string) — Die eindeutige Kennung der Aufgabe.
+ `metadata.execution_id`(string) — Die eindeutige Kennung des Ausführungslaufs. Anwesend, wenn der Untersuchung eine Hinrichtung zugewiesen wurde.
+ `data.task_type`(string) — Die Art 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. Eingeschlossen, wenn eine Zusammenfassung der Hinrichtung verfasst wurde, und andernfalls weggelassen, auch bei einer abgeschlossenen Untersuchung, die keine Zusammenfassung ergab. Die Veranstaltung enthält keinen zusammenfassenden Text. Um es zu lesen, rufen Sie [ ListJournalRecords ](https://docs.aws.amazon.com/devopsagent/latest/APIReference/API_ListJournalRecords.html) mit den Werten `metadata.agent_space_id` and`metadata.execution_id`, a `recordType` of `investigation_summary_md` des Ereignisses auf und wählen Sie den zurückgegebenen Datensatz aus, dessen Wert diesem Wert `recordId` entspricht. Weitere Informationen zum Abrufen der Zusammenfassung finden Sie unter Zusammenfassung einer Untersuchung oder Risikominderung [ abrufen. ](configuring-integrations-and-knowledge-integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-index.html#retrieving-an-investigation-or-mitigation-summary)

**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 ist 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. Bei Minderungsereignissen ist dies einer der zuvor aufgeführten Ereignisnamen.

**`source`**Identifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agentenereignisse lautet 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, aus dem das Ereignis hervorgegangen ist.
+ `metadata.task_id`(string) — Die eindeutige Kennung der Aufgabe.
+ `metadata.execution_id`(string) — Die eindeutige Kennung des Ausführungslaufs. Ist vorhanden, wenn der Risikominderung eine Ausführung zugewiesen wurde.
+ `data.task_type`(string) — Die Art 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) — Der Bezeichner des zusammenfassenden Datensatzes, der die Ergebnisse der Schadensbegrenzung enthält. Eingeschlossen, wenn eine Zusammenfassung der Ausführung erstellt wurde, und andernfalls weggelassen, auch bei einer abgeschlossenen Schadensbegrenzung, die keine Zusammenfassung ergab. Das Ereignis enthält keinen zusammenfassenden Text. Rufen Sie es `ListJournalRecords` wie unter [ Investigationsereignisse beschrieben ab](#investigation-events), indem Sie den Wert `recordType` von verwenden`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"
    }
  }
}
```