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.
# Intégration AWS Support dans des applications axées sur les événements à l'aide d'Amazon EventBridge
Vous pouvez les AWS Support intégrer à des applications pilotées par des événements (EDAs) qui utilisent des événements qui se produisent AWS Support pour communiquer entre les composants de l'application et lancer des processus en aval.
Par exemple, vous pouvez être averti chaque fois que les AWS Support événements suivants se produisent dans votre compte :
+ Un dossier d'assistance est créé, résolu ou rouvert
+ Une correspondance est ajoutée à un dossier de support existant
Pour ce faire, utilisez Amazon EventBridge pour acheminer les événements depuis AWS Support d'autres composants logiciels. Amazon EventBridge est un service sans serveur qui utilise des événements pour connecter les composants de l'application entre eux, ce qui vous permet d'intégrer plus facilement des AWS services, par exemple AWS Support dans des architectures pilotées par des événements, sans code ni opérations supplémentaires.
## Comment EventBridge achemine les AWS Support événements
Voici comment EventBridge fonctionne les AWS Support événements :
Comme c'est le cas pour de nombreux AWS services, AWS Support génère et envoie des événements au *bus d'événements EventBridge * par défaut. Un bus d'événements est un routeur qui reçoit des événements et les achemine vers les destinations, ou *cibles*, que vous spécifiez. Les cibles peuvent inclure d'autres AWS services, des applications personnalisées et des applications partenaires SaaS.
EventBridge achemine les événements conformément aux *règles* que vous créez sur le bus d'événements. Pour chaque règle, vous spécifiez un filtre, ou un *modèle d'événement*, afin de sélectionner uniquement les événements souhaités. Chaque fois qu'un événement est envoyé au bus d'événements EventBridge , comparez-le à chaque règle. Si l'événement correspond à la règle, EventBridge achemine l'événement vers la ou les cibles spécifiées.
![\[AWS les services envoient des événements au bus d'événements EventBridge par défaut. Si l'événement correspond au modèle d'événement d'une règle, EventBridge achemine l'événement vers les cibles spécifiées pour cette règle.\]](http://docs.aws.amazon.com/fr_fr/awssupport/latest/user/images/eventbridge-integration-how-it-works.png)
## AWS Support événements
AWS Support envoie automatiquement les événements suivants au bus EventBridge d'événements par défaut.
| Type de détail d’événement | Description |
| --- | --- |
| [Mise à jour du dossier de support](event-detail-support-case-update.md) | Représente une modification apportée à un dossier de support. |
### Structure d’évènements
Tous les événements des AWS services contiennent deux types de données :
+ Ensemble commun de champs contenant des métadonnées relatives à l'événement, telles que le AWS service à l'origine de l'événement, l'heure à laquelle l'événement a été généré, le compte et la région dans lesquels l'événement a eu lieu, etc. Pour les définitions de ces champs généraux, consultez la section [Structure des événements](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) dans le *Amazon EventBridge Events Reference*.
+ `detail`Champ contenant des données spécifiques à cet événement de service particulier.
### AWS Support livraison d'événements via AWS CloudTrail
AWS les services peuvent envoyer des événements directement au bus d'événements EventBridge par défaut. En outre, AWS CloudTrail envoie également des événements provenant de nombreux AWS services à EventBridge . Ces événements peuvent inclure des appels d'API, des connexions et des actions à la console, des événements de service et CloudTrail des statistiques. Pour plus d'informations, consultez les [événements AWS de service fournis via AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html) dans le *guide de EventBridge l'utilisateur*.
Pour obtenir la liste des AWS Support événements envoyés à EventBridge, reportez-vous à la AWS Support rubrique correspondante dans la [https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html).
## Création de modèles d'événements qui correspondent aux AWS Support événements
Les modèles d'événements sont des filtres qui spécifient les données que doivent contenir les événements que vous souhaitez sélectionner.
Chaque modèle d’événement est un objet JSON qui contient :
+ Un attribut `source` qui identifie le service qui envoie l’événement. Pour les AWS Support événements, la source est`aws.support`.
+ (Facultatif) : `detail-type` attribut qui contient un tableau des noms d'événements à associer.
+ (Facultatif) : un attribut `detail` qui contient toute autre donnée d’événement à rechercher.
Par exemple, le modèle d'événement suivant permet de sélectionner tous les événements Support Case Update parmi AWS Support :
```
{
"source": ["aws.support"],
"detail-type": ["Support Case Update"]
}
```
Vous pouvez préciser votre sélection d'événements en incluant des valeurs dans l'événement lui-même. Par exemple, le modèle d'événement suivant correspond aux événements Support Case Update qui représentent la réouverture d'un dossier :
```
{
"source": ["aws.support"],
"detail-type": ["Support Case Update"],
"detail": {
"event-name": "ReopenCase"
}
}
```
Pour plus d'informations sur la rédaction de modèles d'événements, consultez la section [Modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) dans le *guide de EventBridge l'utilisateur*.
### Consultez aussi
Pour plus d'informations sur l'utilisation EventBridge avec AWS Support, consultez les ressources suivantes :
+ [Comment automatiser AWS Support l'API avec Amazon EventBridge](https://aws.amazon.com/blogs/mt/how-to-automate-aws-support-api-with-amazon-eventbridge)
+ [AWS Support notificateur d'activité des cas](https://github.com/aws-samples/aws-support-case-activity-notifier) sur GitHub
# Événement de mise à jour du dossier de support
Vous trouverez ci-dessous les champs détaillés de l'`Support Case Update`événement.
Les `detail-type` champs `source` et sont inclus ci-dessous car ils contiennent des valeurs spécifiques pour les AWS Support événements. 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*.
```
{
. . .,
"detail-type": "Support Case Update",
"source": "aws.support",
. . .,
"detail": {
"case-id" : "string",
"display-id" : "string",
"communication-id" : "string",
"event-name" : "string",
"origin" : "string"
}
}
```
`detail-type`
Identifie le type d'événement.
Pour cet événement, cette valeur est`Support Case Update`.
`source`
Identifie le service qui a généré l'événement. Pour les AWS Support événements, cette valeur est`aws.support`.
`detail`
Un objet JSON qui contient des informations sur l'événement. Le service qui génère l'événement détermine le contenu de ce champ.
Pour cet événement, ces données incluent :
`case-id`
L'identifiant du dossier d'assistance. Le numéro de dossier est une chaîne alphanumérique au format suivant : case- *12345678910-2013-c4c1d2bf33c5cf47*.
`display-id`
L'identifiant du dossier sur les pages du AWS Support Centre.
`communication-id`
L'identifiant de communication.
`event-name`
*Valeurs valides* : `CreateCase` \$1 `AddCommunicationToCase` \$1 `ResolveCase` \$1 `ReopenCase`
Spécifie le type d'événement lié au dossier de support.
`origin`
*Valeurs valides* : `AWS` \$1 `CUSTOMER`
Spécifie si vous ou un AWS Support agent avez ajouté une correspondance de dossier à un dossier d'assistance.
Actuellement, seuls les événements marqués `event-name` d'un de `AddCommunicationToCase` contiendront cette valeur.
**Example Exemple d'événement de mise à jour du dossier de support : dossier de support créé**
```
{
"version": "0",
"id": "3433df007-9285-55a3-f6d1-536944be45d7",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:51:19Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2022-7118885805350839",
"display-id": "1234563851",
"communication-id": "",
"event-name": "CreateCase",
"origin": ""
}
}
```
**Example Exemple d'événement de mise à jour d'un dossier de support : AWS Support réponses à un dossier de support**
```
{
"version": "0",
"id": "f90cb8cb-32be-1c91-c0ba-d50b4ca5e51b",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:51:31Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2022-7118885805350839",
"display-id": "1234563851",
"communication-id": "ekko:us-east-1:12345678-268a-424b-be08-54613cab84d2",
"event-name": "AddCommunicationToCase",
"origin": "AWS"
}
}
```
**Example Exemple d'événement de mise à jour du dossier de support : dossier de support résolu**
```
{
"version": "0",
"id": "1aa4458d-556f-732e-ddc1-4a5b2fbd14a5",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:51:31Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2022-7118885805350839",
"display-id": "1234563851",
"communication-id": "",
"event-name": "ResolveCase",
"origin": ""
}
}
```
**Example Exemple d'événement de mise à jour du dossier de support : dossier de support rouvert**
```
{
"version": "0",
"id": "3bb9d8fe-6089-ad27-9508-804209b233ad",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:47:19Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2021-27f40618fe0303ea",
"display-id": "1234563851",
"communication-id": "",
"event-name": "ReopenCase",
"origin": ""
}
}
```