

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# AWS DevOps Référence détaillée des événements de l'agent
<a name="integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-devops-agent-events-detail-reference"></a>

Les événements issus AWS des services ont des champs de métadonnées communs`source`, notamment `detail-type``account`,,`region`, et`time`. Ces événements contiennent également un `detail` champ contenant des données spécifiques au service. Pour les événements d' AWS DevOps agent, le `source` est toujours `aws.aidevops` et le `detail-type` identifie l'événement spécifique.

## Événements liés à l'enquête
<a name="investigation-events"></a>

Les `detail-type` valeurs suivantes identifient les événements d'enquête :
+ `Investigation Created`
+ `Investigation Priority Updated`
+ `Investigation In Progress`
+ `Investigation Completed`
+ `Investigation Failed`
+ `Investigation Timed Out`
+ `Investigation Cancelled`
+ `Investigation Pending Triage`
+ `Investigation Linked`
+ `Investigation Skipped`

Les `detail-type` champs `source` et sont inclus ci-dessous car ils contiennent des valeurs spécifiques pour les événements de AWS DevOps l'agent. Pour les définitions des autres champs de métadonnées inclus dans tous les événements, consultez la section [Structure des événements](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) dans *Amazon EventBridge Events Reference*.

La structure JSON des événements d'investigation est la suivante.

```
{
  . . .,
  "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`**Identifie le type d'événement. Pour les événements d'enquête, il s'agit de l'un des noms d'événements répertoriés précédemment.

**`source`**Identifie le service qui a généré l'événement. Pour les événements de l' AWS DevOps agent, cette valeur est`aws.aidevops`.

**`detail`**Objet JSON contenant des données spécifiques à un événement. L'`detail`objet inclut les champs suivants :
+ `version`(string) — Version du schéma du détail de l'événement. Actuellement`1.0.0`.
+ `metadata.agent_space_id`(chaîne) — Identifiant unique de l'espace d'agent d'origine de l'événement.
+ `metadata.task_id`(chaîne) — Identifiant unique de la tâche.
+ `metadata.execution_id`(string) — Identifiant unique de l'exécution. Présent lorsqu'une exécution a été affectée à l'enquête.
+ `data.task_type`(string) — Type de tâche. Valeur :`INVESTIGATION`.
+ `data.priority`(string) — Le niveau de priorité. Valeurs :`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(string) — L'état actuel. Valeurs :`PENDING_START`,`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`,`PENDING_TRIAGE`,`LINKED`,`SKIPPED`.
+ `data.created_at`(string) — Horodatage ISO 8601 lors de la création de la tâche.
+ `data.updated_at`(string) — Horodatage ISO 8601 de la dernière mise à jour de la tâche.
+ `data.summary_record_id`(chaîne) — Identifiant du compte rendu sommaire contenant les résultats de l'enquête. Inclus lorsqu'un résumé est généré pour l'enquête terminée. Vous pouvez récupérer le contenu du résumé via l'API de l' AWS DevOps agent en utilisant cet identifiant pour rechercher la notice du journal avec un type d'enregistrement de`investigation_summary_md`.

**Exemple : événement d'enquête terminé**

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

**Exemple : échec de l'enquête**

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

## Événements d'atténuation
<a name="mitigation-events"></a>

Les `detail-type` valeurs suivantes identifient les événements d'atténuation :
+ `Mitigation In Progress`
+ `Mitigation Completed`
+ `Mitigation Failed`
+ `Mitigation Timed Out`
+ `Mitigation Cancelled`

Les `detail-type` champs `source` et sont inclus ci-dessous car ils contiennent des valeurs spécifiques pour les événements de AWS DevOps l'agent. Pour les définitions des autres champs de métadonnées inclus dans tous les événements, consultez la section [Structure des événements](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) dans *Amazon EventBridge Events Reference*.

Voici la structure JSON des événements d'atténuation.

```
{
  . . .,
  "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`**Identifie le type d'événement. Pour les événements d'atténuation, il s'agit de l'un des noms d'événements répertoriés précédemment.

**`source`**Identifie le service qui a généré l'événement. Pour les événements de l' AWS DevOps agent, cette valeur est`aws.aidevops`.

**`detail`**Objet JSON contenant des données spécifiques à un événement. L'`detail`objet inclut les champs suivants :
+ `version`(string) — Version du schéma du détail de l'événement. Actuellement`1.0.0`.
+ `metadata.agent_space_id`(chaîne) — Identifiant unique de l'espace d'agent d'origine de l'événement.
+ `metadata.task_id`(chaîne) — Identifiant unique de la tâche.
+ `metadata.execution_id`(string) — Identifiant unique de l'exécution. Présent lorsqu'une exécution a été affectée à l'atténuation.
+ `data.task_type`(string) — Type de tâche. Valeur :`INVESTIGATION`.
+ `data.priority`(string) — Le niveau de priorité. Valeurs :`CRITICAL`,`HIGH`,`MEDIUM`,`LOW`,`MINIMAL`.
+ `data.status`(string) — L'état actuel. Valeurs :`IN_PROGRESS`,`COMPLETED`,`FAILED`,`TIMED_OUT`,`CANCELLED`.
+ `data.created_at`(string) — Horodatage ISO 8601 lors de la création de la tâche.
+ `data.updated_at`(string) — Horodatage ISO 8601 de la dernière mise à jour de la tâche.
+ `data.summary_record_id`(chaîne) — Identifiant de l'enregistrement récapitulatif contenant les résultats des mesures d'atténuation. Inclus lorsqu'un résumé est généré pour l'atténuation terminée. Vous pouvez récupérer le contenu du résumé via l'API de l' AWS DevOps agent en utilisant cet identifiant pour rechercher la notice du journal avec un type d'enregistrement de`mitigation_summary_md`.

**Exemple : événement d'atténuation terminé**

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

**Exemple : échec de l'atténuation**

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