Ereignisse im Zusammenhang mit Ermittlungen Ereignisse zur Schadensbegrenzung

AWS DevOps Detailreferenz zu Agentenereignissen

Ereignisse von AWS Diensten haben gemeinsame Metadatenfeldersource, darunter detail-typeaccount,region, undtime. 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. Felderdetail, die keinen Wert haben, werden weggelassen und nicht auf gesetztnull. Daher müssen Sie metadata.execution_id und data.summary_record_id als optional behandeln.

Ereignisse im Zusammenhang mit Ermittlungen

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 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-typeIdentifiziert den Ereignistyp. Bei Ermittlungsereignissen ist dies einer der zuvor aufgeführten Ereignisnamen.

sourceIdentifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agentenereignisse lautet dieser Wertaws.aidevops.

detailEin JSON-Objekt, das ereignisspezifische Daten enthält. Das detail Objekt umfasst die folgenden Felder:

version(string) — Die Schemaversion des Ereignisdetails. Derzeit1.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: CRITICALHIGH,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 mit den Werten metadata.agent_space_id andmetadata.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.

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

Die folgenden detail-type Werte identifizieren Minderungsereignisse:

Mitigation In Progress
Mitigation Completed
Mitigation Failed
Mitigation Timed Out
Mitigation Cancelled

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

sourceIdentifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agentenereignisse lautet dieser Wertaws.aidevops.

detailEin JSON-Objekt, das ereignisspezifische Daten enthält. Das detail Objekt umfasst die folgenden Felder:

version(string) — Die Schemaversion des Ereignisdetails. Derzeit1.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: CRITICALHIGH,MEDIUM,LOW,MINIMAL.
data.status(string) — Der aktuelle Status. Werte: IN_PROGRESSCOMPLETED,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, indem Sie den Wert recordType von verwendenmitigation_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"
    }
  }
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Integration AWS DevOps Agent bei Amazon EventBridge

Verkaufte Logs und Metriken