

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS DevOps Referencia detallada de los eventos del agente
<a name="integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-devops-agent-events-detail-reference"></a>

Los eventos de AWS los servicios tienen campos de metadatos comunes`source`, como`detail-type`,`account`,`region`, y`time`. Estos eventos también contienen un `detail` campo con datos específicos del servicio. En el caso de los eventos del AWS DevOps agente, `source` es siempre `aws.aidevops` e `detail-type` identifica el evento específico.

El `time` campo indica la hora en que se actualizó por última vez la investigación o la mitigación. No es la hora en la que se EventBridge recibió el evento. Los campos `detail` que no tienen ningún valor se omiten en lugar de establecerlos `null` en. Por lo tanto, debe tratar `metadata.execution_id` y `data.summary_record_id` como opcional.

## Eventos de investigación
<a name="investigation-events"></a>

Los siguientes `detail-type` valores identifican los eventos de investigación:
+ `Investigation Created`
+ `Investigation Priority Updated`
+ `Investigation In Progress`
+ `Investigation Completed`
+ `Investigation Failed`
+ `Investigation Timed Out`
+ `Investigation Cancelled`
+ `Investigation Pending Triage`
+ `Investigation Linked`
+ `Investigation Skipped`

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos AWS DevOps del agente. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la sección Estructura de [ eventos ](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) en la referencia de EventBridge eventos de * Amazon*.

La siguiente es la estructura JSON para los eventos de investigación.

```
{
  . . .,
  "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 el tipo de evento. En el caso de los eventos de investigación, este es uno de los nombres de eventos listados anteriormente.

**`source`**Identifica el servicio que generó el evento. Para los eventos del AWS DevOps agente, este valor es`aws.aidevops`.

**`detail`**Un objeto JSON que contiene datos específicos del evento. El `detail` objeto incluye los siguientes campos:
+ `version`(cadena): la versión del esquema del detalle del evento. Actualmente`1.0.0`.
+ `metadata.agent_space_id`(cadena): el identificador único del espacio de agentes en el que se originó el evento.
+ `metadata.task_id`(cadena): el identificador único de la tarea.
+ `metadata.execution_id`(cadena): el identificador único de la ejecución. Está presente cuando se ha asignado una ejecución a la investigación.
+ `data.task_type`(cadena): el tipo de tarea. Valor:`INVESTIGATION`.
+ `data.priority`(cadena): el nivel de prioridad. Valores:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(cadena): el estado actual. Valores:`PENDING_START`,`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`,`PENDING_TRIAGE`,`LINKED`,`SKIPPED`.
+ `data.created_at`(cadena): marca de tiempo ISO 8601 en la que se creó la tarea.
+ `data.updated_at`(cadena): marca de tiempo ISO 8601 en la que se actualizó la tarea por última vez.
+ `data.summary_record_id`(cadena): el identificador del registro resumido que contiene los resultados de la investigación. Se incluye cuando se redacta un acta resumida de la ejecución y se omite en otros casos, incluso cuando se ha completado una investigación sin ningún resumen. El acto no contiene el texto resumido. Para leerlo, llame [ ListJournalRecords ](https://docs.aws.amazon.com/devopsagent/latest/APIReference/API_ListJournalRecords.html) con las letras `metadata.agent_space_id` y`metadata.execution_id`, a `recordType` de del `investigation_summary_md` evento y seleccione el registro devuelto que `recordId` coincida con este valor. Para obtener más información sobre cómo recuperar el resumen, consulta Cómo [ recuperar un resumen de una investigación o una mitigación. ](configuring-integrations-and-knowledge-integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-index.html#retrieving-an-investigation-or-mitigation-summary)

**Ejemplo: evento de investigación completada **

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

**Ejemplo: Evento fallido de investigación **

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

## Eventos de mitigación
<a name="mitigation-events"></a>

Los siguientes `detail-type` valores identifican los eventos de mitigación:
+ `Mitigation In Progress`
+ `Mitigation Completed`
+ `Mitigation Failed`
+ `Mitigation Timed Out`
+ `Mitigation Cancelled`

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos AWS DevOps del agente. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la sección Estructura de [ eventos ](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) en la referencia de EventBridge eventos de * Amazon*.

La siguiente es la estructura JSON para los eventos de mitigación.

```
{
  . . .,
  "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 el tipo de evento. En el caso de los eventos de mitigación, este es uno de los nombres de eventos listados anteriormente.

**`source`**Identifica el servicio que generó el evento. Para los eventos del AWS DevOps agente, este valor es`aws.aidevops`.

**`detail`**Un objeto JSON que contiene datos específicos del evento. El `detail` objeto incluye los siguientes campos:
+ `version`(cadena): la versión del esquema del detalle del evento. Actualmente`1.0.0`.
+ `metadata.agent_space_id`(cadena): el identificador único del espacio de agentes en el que se originó el evento.
+ `metadata.task_id`(cadena): el identificador único de la tarea.
+ `metadata.execution_id`(cadena): el identificador único de la ejecución. Está presente cuando se ha asignado una ejecución a la mitigación.
+ `data.task_type`(cadena): el tipo de tarea. Valor:`INVESTIGATION`.
+ `data.priority`(cadena): el nivel de prioridad. Valores:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(cadena): el estado actual. Valores:`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`.
+ `data.created_at`(cadena): marca de tiempo ISO 8601 en la que se creó la tarea.
+ `data.updated_at`(cadena): marca de tiempo ISO 8601 en la que se actualizó la tarea por última vez.
+ `data.summary_record_id`(cadena): el identificador del registro resumido que contiene los resultados de la mitigación. Se incluye cuando se redacta un acta resumida para la ejecución y se omite en caso contrario, incluso cuando se ha completado una mitigación y no se ha producido ningún resumen. El evento no contiene el texto resumido. Recupéralo `ListJournalRecords` tal y como se describe en Eventos de [ investigación](#investigation-events), utilizando un `recordType` de`mitigation_summary_md`.

**Ejemplo: evento de mitigación completado **

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

**Ejemplo: evento fallido de mitigación **

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