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
Les événements provenant de AWS services possèdent des champs de métadonnées communs `source``detail-type`, notamment`account`,`region`, et`time`. Ces événements contiennent également un `detail` champ contenant des données spécifiques au service. Pour les événements de l' AWS DevOps agent, le `source` est toujours `aws.aidevops` et `detail-type` identifie l'événement spécifique.
Le `time` champ correspond à l'heure à laquelle l'enquête ou l'atténuation a été mise à jour pour la dernière fois. Ce n'est pas l'heure qui EventBridge a accueilli l'événement. Les champs `detail` qui n'ont aucune valeur sont omis au lieu d'être définis sur. `null` Par conséquent, vous devez traiter `metadata.execution_id` et `data.summary_record_id` comme facultatif.
## Événements liés à l'enquête
Les `detail-type` valeurs suivantes identifient les événements d'investigation :
+ `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 le manuel * Amazon EventBridge Events Reference*.
Voici la structure JSON pour les événements d'investigation.
```
{
. . .,
"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`**Un objet JSON qui contient 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 agent d'où provient l'événement.
+ `metadata.task_id`(string) — Identifiant unique de la tâche.
+ `metadata.execution_id`(string) — Identifiant unique de l'exécution exécutée. Présent lorsqu'une exécution a été attribuée à l'enquête.
+ `data.task_type`(chaîne) — 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`(chaîne) — Horodatage ISO 8601 à la date de 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 récapitulatif contenant les résultats de l'enquête. Inclus lorsqu'un compte rendu analytique a été rédigé pour l'exécution, et omis autrement, y compris pour une enquête terminée qui n'a produit aucun résumé. L'événement ne contient pas le texte récapitulatif. Pour le lire, appelez [ ListJournalRecords ](https://docs.aws.amazon.com/devopsagent/latest/APIReference/API_ListJournalRecords.html) avec le `metadata.agent_space_id` et`metadata.execution_id`, a `recordType` of de l'événement`investigation_summary_md`, et sélectionnez l'enregistrement renvoyé qui `recordId` correspond à cette valeur. Pour plus d'informations sur la récupération du résumé, voir [ Récupérer un résumé d'enquête ou d'atténuation. ](configuring-integrations-and-knowledge-integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-index.html#retrieving-an-investigation-or-mitigation-summary)
**Exemple : Événement « Enquête terminée » **
```
{
"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 : Événement d'é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
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 le manuel * Amazon EventBridge Events Reference*.
Voici la structure JSON pour les é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`**Un objet JSON qui contient 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 agent d'où provient l'événement.
+ `metadata.task_id`(string) — Identifiant unique de la tâche.
+ `metadata.execution_id`(string) — Identifiant unique de l'exécution exécutée. Présent lorsqu'une exécution a été affectée à l'atténuation.
+ `data.task_type`(chaîne) — 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`(chaîne) — Horodatage ISO 8601 à la date de 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 compte rendu récapitulatif a été rédigé pour l'exécution, et omis dans le cas contraire, y compris sur une atténuation terminée qui n'a produit aucun résumé. L'événement ne contient pas le texte récapitulatif. Récupérez-le `ListJournalRecords` comme décrit dans Événements [ d'investigation](#investigation-events), en utilisant `recordType` un`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 : Événement d'é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"
}
}
}
```