

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>

Eventos de 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 `detail-type` identifica o evento específico.

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

Os `detail-type` valores a seguir identificam os eventos da 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 obter definições dos outros campos de metadados que estão incluídos em todos os eventos, consulte [Estrutura de eventos na Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *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 Agent, 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 à 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) — Registro de data e hora ISO 8601 quando a tarefa foi criada.
+ `data.updated_at`(string) — Registro de data e hora ISO 8601 de 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 resumo é gerado para a investigação concluída. Você pode recuperar o conteúdo resumido por meio da API do AWS DevOps agente usando esse identificador para pesquisar o registro do diário com um tipo de registro de`investigation_summary_md`.

**Exemplo: Evento de investigação concluído**

```
{
  "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 obter definições dos outros campos de metadados que estão incluídos em todos os eventos, consulte [Estrutura de eventos na Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *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 Agent, 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) — Registro de data e hora ISO 8601 quando a tarefa foi criada.
+ `data.updated_at`(string) — Registro de data e hora ISO 8601 de 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 resumo é gerado para a mitigação concluída. Você pode recuperar o conteúdo resumido por meio da API do AWS DevOps agente usando esse identificador para pesquisar o registro do diário com um tipo de registro 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"
    }
  }
}
```