

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# AWS DevOps Referência detalhada de eventos do agente
<a name="integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-devops-agent-events-detail-reference"></a>

Os eventos dos AWS serviços têm campos de metadados comuns`source`, incluindo `detail-type``account`,`region`, e. `time` Esses eventos também contêm um `detail` campo com dados específicos do serviço. Para eventos do AWS DevOps agente, o `source` é sempre `aws.aidevops` e o `detail-type` identifica o evento específico.

O `time` campo é a hora em que a investigação ou mitigação foi atualizada pela última vez. Não é a hora que EventBridge recebeu o evento. Os campos `detail` que não têm valor são omitidos em vez de definidos como. `null` Como resultado, você deve tratá-lo `metadata.execution_id` `data.summary_record_id` como opcional.

## Eventos de investigação
<a name="investigation-events"></a>

Os `detail-type` valores a seguir identificam eventos de investigação:
+ `Investigation Created`
+ `Investigation Priority Updated`
+ `Investigation In Progress`
+ `Investigation Completed`
+ `Investigation Failed`
+ `Investigation Timed Out`
+ `Investigation Cancelled`
+ `Investigation Pending Triage`
+ `Investigation Linked`
+ `Investigation Skipped`

Os `detail-type` campos `source` e estão incluídos abaixo porque contêm valores específicos para eventos AWS DevOps do agente. Para ver as definições dos outros campos de metadados que estão incluídos em todos os eventos, consulte Estrutura de eventos [ na * Amazon *](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) EventBridge Events Reference.

A seguir está a estrutura JSON para eventos de investigação.

```
{
  . . .,
  "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 o tipo de evento. Para eventos de investigação, esse é um dos nomes de eventos listados anteriormente.

**`source`**Identifica o serviço que gerou o evento. Para eventos AWS DevOps do agente, esse valor é`aws.aidevops`.

**`detail`**Um objeto JSON que contém dados específicos do evento. O `detail` objeto inclui os seguintes campos:
+ `version`(string) — A versão do esquema dos detalhes do evento. Atualmente`1.0.0`.
+ `metadata.agent_space_id`(string) — O identificador exclusivo do espaço do agente em que o evento se originou.
+ `metadata.task_id`(string) — O identificador exclusivo da tarefa.
+ `metadata.execution_id`(string) — O identificador exclusivo da execução. Presente quando uma execução é atribuída à investigação.
+ `data.task_type`(string) — O tipo de tarefa. Valor:`INVESTIGATION`.
+ `data.priority`(string) — O nível de prioridade. Valores:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(string) — O status atual. Valores:`PENDING_START`,`IN_PROGRESS`, `COMPLETED``FAILED`,`TIMED_OUT`,`CANCELLED`,`PENDING_TRIAGE`,`LINKED`,`SKIPPED`.
+ `data.created_at`(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi criada.
+ `data.updated_at`(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi atualizada pela última vez.
+ `data.summary_record_id`(string) — O identificador do registro resumido contendo os resultados da investigação. Incluído quando um registro resumido foi escrito para a execução e omitido de outra forma, inclusive em uma investigação concluída que não produziu nenhum resumo. O evento não contém o texto resumido. Para lê-lo, chame [ ListJournalRecords ](https://docs.aws.amazon.com/devopsagent/latest/APIReference/API_ListJournalRecords.html) com os `metadata.agent_space_id` e`metadata.execution_id`, a do evento e selecione o registro retornado que `recordId` corresponda a esse valor. `recordType` `investigation_summary_md` Para obter mais informações sobre como recuperar o resumo, consulte [ Recuperando um resumo de investigação ou mitigação. ](configuring-integrations-and-knowledge-integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-index.html#retrieving-an-investigation-or-mitigation-summary)

**Exemplo: evento de investigação concluída **

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

**Exemplo: Evento de falha na investigação **

```
{
  "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 mitigação
<a name="mitigation-events"></a>

Os `detail-type` valores a seguir identificam eventos de mitigação:
+ `Mitigation In Progress`
+ `Mitigation Completed`
+ `Mitigation Failed`
+ `Mitigation Timed Out`
+ `Mitigation Cancelled`

Os `detail-type` campos `source` e estão incluídos abaixo porque contêm valores específicos para eventos AWS DevOps do agente. Para ver as definições dos outros campos de metadados que estão incluídos em todos os eventos, consulte Estrutura de eventos [ na * Amazon *](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) EventBridge Events Reference.

A seguir está a estrutura JSON para eventos de mitigação.

```
{
  . . .,
  "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 o tipo de evento. Para eventos de mitigação, esse é um dos nomes de eventos listados anteriormente.

**`source`**Identifica o serviço que gerou o evento. Para eventos AWS DevOps do agente, esse valor é`aws.aidevops`.

**`detail`**Um objeto JSON que contém dados específicos do evento. O `detail` objeto inclui os seguintes campos:
+ `version`(string) — A versão do esquema dos detalhes do evento. Atualmente`1.0.0`.
+ `metadata.agent_space_id`(string) — O identificador exclusivo do espaço do agente em que o evento se originou.
+ `metadata.task_id`(string) — O identificador exclusivo da tarefa.
+ `metadata.execution_id`(string) — O identificador exclusivo da execução. Presente quando uma execução foi atribuída à mitigação.
+ `data.task_type`(string) — O tipo de tarefa. Valor:`INVESTIGATION`.
+ `data.priority`(string) — O nível de prioridade. Valores:`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(string) — O status atual. Valores:`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`.
+ `data.created_at`(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi criada.
+ `data.updated_at`(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi atualizada pela última vez.
+ `data.summary_record_id`(string) — O identificador do registro resumido contendo as descobertas de mitigação. Incluído quando um registro resumido foi escrito para a execução e omitido de outra forma, inclusive em uma mitigação concluída que não produziu nenhum resumo. O evento não contém o texto resumido. Recupere-o `ListJournalRecords` conforme descrito em Eventos de [ investigação](#investigation-events), usando um `recordType` de`mitigation_summary_md`.

**Exemplo: evento de mitigação concluído **

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

**Exemplo: evento de falha na mitigação **

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