

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 eventos de agentes
<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``detail-type`, como`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, el símbolo `source` es siempre `aws.aidevops` y el `detail-type` identifica el evento específico.

## 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 [Estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) en la *referencia de Amazon EventBridge Events*.

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 enumerados 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 esquemática del detalle del evento. Actualmente`1.0.0`.
+ `metadata.agent_space_id`(cadena): el identificador único del espacio de agentes donde 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): fecha y hora ISO 8601 de la última actualización de la tarea.
+ `data.summary_record_id`(cadena): identificador del acta resumida que contiene los resultados de la investigación. Se incluye cuando se genera un resumen de la investigación finalizada. Puede recuperar el contenido del resumen a través de la API AWS DevOps Agent utilizando este identificador para buscar el registro del diario con un tipo de registro de`investigation_summary_md`.

**Ejemplo: evento «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 en la 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 [Estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) en la *referencia de Amazon EventBridge Events*.

La siguiente es la estructura de 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 enumerados 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 esquemática del detalle del evento. Actualmente`1.0.0`.
+ `metadata.agent_space_id`(cadena): el identificador único del espacio de agentes donde 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): fecha y hora ISO 8601 de la última actualización de la tarea.
+ `data.summary_record_id`(cadena): el identificador del registro resumido que contiene los resultados de la mitigación. Se incluye cuando se genera un resumen de la mitigación completada. Puede recuperar el contenido del resumen a través de la API del AWS DevOps agente utilizando este identificador para buscar el registro del diario con un tipo de registro de`mitigation_summary_md`.

**Ejemplo: evento Mitigación completada**

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