View a markdown version of this page

AWS DevOps Detailreferenz zu Agentenereignissen - AWS DevOps Agentin
ErmittlungsereignisseEreignisse zur Schadensbegrenzung

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

Ereignisse von AWS Diensten haben gemeinsame Metadatenfeldersource, darunterdetail-type,account,region, undtime. 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

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 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 oben aufgeführten Ereignisnamen.

sourceIdentifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agent-Ereignisse ist 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, 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 sucheninvestigation_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

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

sourceIdentifiziert den Dienst, der das Ereignis generiert hat. Für AWS DevOps Agent-Ereignisse ist 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, 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"
    }
  }
}