

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 dei 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 dell' AWS DevOps agente, `source` è sempre `aws.aidevops` e `detail-type` identifica l'evento specifico.

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

I seguenti `detail-type` valori identificano gli eventi investigativi:
+ `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 EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *Reference*.

Di seguito è riportata la struttura JSON per gli eventi investigativi.

```
{
  . . .,
  "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 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`(stringa) — La versione dello schema dei dettagli dell'evento. Attualmente`1.0.0`.
+ `metadata.agent_space_id`(stringa) — L'identificatore univoco dello spazio 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`(stringa) — Data e ora ISO 8601 dell'ultimo aggiornamento dell'attività.
+ `data.summary_record_id`(stringa) — L'identificatore della registrazione riassuntiva contenente i risultati dell'indagine. Incluso quando viene generato un riepilogo per l'indagine completata. È possibile recuperare il contenuto del riepilogo tramite l'API dell' AWS DevOps agente utilizzando questo identificatore per cercare il record del diario con un tipo di record di. `investigation_summary_md`

**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 di indagine fallito**

```
{
  "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 EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *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`(stringa) — La versione dello schema dei dettagli dell'evento. Attualmente`1.0.0`.
+ `metadata.agent_space_id`(stringa) — L'identificatore univoco dello spazio 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`(stringa) — Data e ora ISO 8601 dell'ultimo aggiornamento dell'attività.
+ `data.summary_record_id`(stringa) — L'identificatore del record di riepilogo contenente i risultati della mitigazione. Incluso quando viene generato un riepilogo per la mitigazione completata. È possibile recuperare il contenuto del riepilogo tramite l' AWS DevOps Agent API utilizzando questo identificatore per cercare il record del journal con un tipo di record di. `mitigation_summary_md`

**Esempio: evento Mitigation Completed**

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