

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS DevOps Riferimento dettagliato sugli eventi degli agenti
<a name="integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-devops-agent-events-detail-reference"></a>

Gli eventi provenienti dai AWS servizi hanno campi di metadati comuni, tra cui`source`,`detail-type`, `account``region`, e. `time` Questi eventi contengono anche un `detail` campo con dati specifici del servizio. Per gli eventi AWS DevOps Agent, `source` is always `aws.aidevops` e the `detail-type` identifica l'evento specifico.

Il `time` campo indica l'ora dell'ultimo aggiornamento dell'indagine o della mitigazione. Non è l'ora in cui EventBridge ha ricevuto l'evento. I campi `detail` privi di valore vengono omessi anziché impostati su`null`. Di conseguenza, è necessario considerare `metadata.execution_id` e `data.summary_record_id` come facoltativo.

## Eventi di indagine
<a name="investigation-events"></a>

I seguenti `detail-type` valori identificano gli eventi di indagine:
+ `Investigation Created`
+ `Investigation Priority Updated`
+ `Investigation In Progress`
+ `Investigation Completed`
+ `Investigation Failed`
+ `Investigation Timed Out`
+ `Investigation Cancelled`
+ `Investigation Pending Triage`
+ `Investigation Linked`
+ `Investigation Skipped`

I `detail-type` campi `source` e sono inclusi di seguito perché contengono valori specifici per gli eventi AWS DevOps dell'agente. Per le definizioni degli altri campi di metadati inclusi in tutti gli eventi, consulta la struttura degli eventi [ in * Amazon *](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) EventBridge Events Reference. 

Di seguito è riportata la struttura JSON per gli eventi di indagine.

```
{
  . . .,
  "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`**Identifica il tipo di evento. Per gli eventi di indagine, questo è uno dei nomi di evento elencati in precedenza.

**`source`**Identifica il servizio che ha generato l'evento. Per gli eventi AWS DevOps dell'agente, questo valore è`aws.aidevops`.

**`detail`**Un oggetto JSON che contiene dati specifici dell'evento. L'`detail`oggetto include i seguenti campi:
+ `version`(string) — La versione dello schema dei dettagli dell'evento. Attualmente`1.0.0`.
+ `metadata.agent_space_id`(stringa) — L'identificatore univoco dello spazio dell'agente in cui ha avuto origine l'evento.
+ `metadata.task_id`(stringa) — L'identificatore univoco dell'attività.
+ `metadata.execution_id`(stringa) — L'identificatore univoco dell'esecuzione. Presente quando un'esecuzione è stata assegnata all'indagine.
+ `data.task_type`(stringa) — Il tipo di attività. Valore:`INVESTIGATION`.
+ `data.priority`(stringa) — Il livello di priorità. Valori:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(stringa) — Lo stato corrente. Valori: `PENDING_START``IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`,`PENDING_TRIAGE`,`LINKED`,`SKIPPED`.
+ `data.created_at`(stringa) — Timestamp ISO 8601 al momento della creazione dell'attività.
+ `data.updated_at`(string) — Timestamp ISO 8601 quando l'attività è stata aggiornata l'ultima volta.
+ `data.summary_record_id`(stringa) — L'identificatore del record di riepilogo contenente i risultati dell'indagine. Incluso quando è stato redatto un resoconto riassuntivo per l'esecuzione, e viene omesso in caso contrario, anche su un'indagine completata che non ha prodotto alcun riepilogo. L'evento non contiene il testo riassuntivo. Per leggerlo, chiama [ ListJournalRecords ](https://docs.aws.amazon.com/devopsagent/latest/APIReference/API_ListJournalRecords.html) con l'evento `metadata.agent_space_id` e`metadata.execution_id`, a `recordType` of `investigation_summary_md` e seleziona il record restituito che `recordId` corrisponde a questo valore. Per ulteriori informazioni sul recupero del riepilogo, vedere [ Recupero di un riepilogo dell'indagine o della mitigazione. ](configuring-integrations-and-knowledge-integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-index.html#retrieving-an-investigation-or-mitigation-summary)

**Esempio: evento Indagine completata **

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

**Esempio: evento Investigazione fallita **

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

## Eventi di mitigazione
<a name="mitigation-events"></a>

I seguenti `detail-type` valori identificano gli eventi di mitigazione:
+ `Mitigation In Progress`
+ `Mitigation Completed`
+ `Mitigation Failed`
+ `Mitigation Timed Out`
+ `Mitigation Cancelled`

I `detail-type` campi `source` e sono inclusi di seguito perché contengono valori specifici per gli eventi AWS DevOps dell'agente. Per le definizioni degli altri campi di metadati inclusi in tutti gli eventi, consulta la struttura degli eventi [ in * Amazon *](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) EventBridge Events Reference. 

Di seguito è riportata la struttura JSON per gli eventi di mitigazione.

```
{
  . . .,
  "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`**Identifica il tipo di evento. Per gli eventi di mitigazione, questo è uno dei nomi degli eventi elencati in precedenza.

**`source`**Identifica il servizio che ha generato l'evento. Per gli eventi AWS DevOps dell'agente, questo valore è`aws.aidevops`.

**`detail`**Un oggetto JSON che contiene dati specifici dell'evento. L'`detail`oggetto include i seguenti campi:
+ `version`(string) — La versione dello schema dei dettagli dell'evento. Attualmente`1.0.0`.
+ `metadata.agent_space_id`(stringa) — L'identificatore univoco dello spazio dell'agente in cui ha avuto origine l'evento.
+ `metadata.task_id`(stringa) — L'identificatore univoco dell'attività.
+ `metadata.execution_id`(stringa) — L'identificatore univoco dell'esecuzione. Presente quando un'esecuzione è stata assegnata alla mitigazione.
+ `data.task_type`(stringa) — Il tipo di attività. Valore:`INVESTIGATION`.
+ `data.priority`(stringa) — Il livello di priorità. Valori:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(stringa) — Lo stato corrente. Valori:`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`.
+ `data.created_at`(stringa) — Timestamp ISO 8601 al momento della creazione dell'attività.
+ `data.updated_at`(string) — Timestamp ISO 8601 quando l'attività è stata aggiornata l'ultima volta.
+ `data.summary_record_id`(stringa) — L'identificatore del record di riepilogo contenente i risultati della mitigazione. Incluso quando è stato scritto un record di riepilogo per l'esecuzione e omesso in caso contrario, incluso quello relativo a una mitigazione completata che non ha prodotto alcun riepilogo. L'evento non contiene il testo riassuntivo. Recuperatelo `ListJournalRecords` come descritto in [ Investigation events](#investigation-events), utilizzando un `recordType` of`mitigation_summary_md`.

**Esempio: evento Mitigazione completata **

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

**Esempio: evento di mitigazione non riuscito **

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