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.
# EventBridge exemples utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with EventBridge.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `règle de suppression`
L'exemple de code suivant montre comment utiliser`delete-rule`.
**AWS CLI**
**Pour supprimer une règle CloudWatch relative aux événements **
Cet exemple supprime la règle nommée EC2InstanceStateChanges :
```
aws events delete-rule --name {{"EC2InstanceStateChanges"}}
```
+ Pour plus de détails sur l'API, consultez [ DeleteRule ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/delete-rule.html) la section Référence des *AWS CLI commandes*.
### `règle de description`
L'exemple de code suivant montre comment utiliser`describe-rule`.
**AWS CLI**
**Pour afficher des informations sur une règle CloudWatch relative aux événements **
Cet exemple affiche des informations sur la règle nommée DailyLambdaFunction :
```
aws events describe-rule --name {{"DailyLambdaFunction"}}
```
+ Pour plus de détails sur l'API, consultez [ DescribeRule ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/describe-rule.html) la section Référence des *AWS CLI commandes*.
### `règle de désactivation`
L'exemple de code suivant montre comment utiliser`disable-rule`.
**AWS CLI**
**Pour désactiver une règle CloudWatch relative aux événements **
Cet exemple désactive la règle nommée DailyLambdaFunction. La règle n’est pas supprimée :
```
aws events disable-rule --name {{"DailyLambdaFunction"}}
```
+ Pour plus de détails sur l'API, consultez [ DisableRule ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/disable-rule.html) la section Référence des *AWS CLI commandes*.
### `règle d'activation`
L'exemple de code suivant montre comment utiliser`enable-rule`.
**AWS CLI**
**Pour activer une règle CloudWatch relative aux événements **
Cet exemple active la règle nommée DailyLambdaFunction, qui avait été précédemment désactivée :
```
aws events enable-rule --name {{"DailyLambdaFunction"}}
```
+ Pour plus de détails sur l'API, consultez [ EnableRule ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/enable-rule.html) la section Référence des *AWS CLI commandes*.
### `lister les noms des règles par cible`
L'exemple de code suivant montre comment utiliser`list-rule-names-by-target`.
**AWS CLI**
**Pour afficher toutes les règles ayant une cible spécifiée**
Cet exemple affiche toutes les règles dont la fonction Lambda nommée « MyFunctionName » est la cible :
```
aws events list-rule-names-by-target --target-arn {{"arn:aws:lambda:us-east-1:123456789012:function:MyFunctionName"}}
```
+ Pour plus de détails sur l'API, consultez [ ListRuleNamesByTarget ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-rule-names-by-target.html) la section Référence des *AWS CLI commandes*.
### `règles de la liste`
L'exemple de code suivant montre comment utiliser`list-rules`.
**AWS CLI**
**Pour afficher la liste de toutes les règles relatives aux CloudWatch événements **
Cet exemple affiche toutes les règles relatives aux CloudWatch événements de la région :
```
aws events list-rules
```
**Afficher la liste des règles relatives aux CloudWatch événements commençant par une chaîne donnée. **
Cet exemple affiche toutes les règles relatives aux CloudWatch événements de la région dont le nom commence par « Quotidien » :
```
aws events list-rules --name-prefix {{"Daily"}}
```
+ Pour plus de détails sur l'API, consultez [ ListRules ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-rules.html) la section Référence des *AWS CLI commandes*.
### `lister les cibles par règle`
L'exemple de code suivant montre comment utiliser`list-targets-by-rule`.
**AWS CLI**
**Pour afficher toutes les cibles d'une règle relative CloudWatch aux événements **
Cet exemple affiche toutes les cibles de la règle nommée DailyLambdaFunction :
```
aws events list-targets-by-rule --rule {{"DailyLambdaFunction"}}
```
+ Pour plus de détails sur l'API, consultez [ ListTargetsByRule ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-targets-by-rule.html) la section Référence des *AWS CLI commandes*.
### `événements Put-Events`
L'exemple de code suivant montre comment utiliser`put-events`.
**AWS CLI**
**Pour envoyer un événement personnalisé à CloudWatch Events **
Cet exemple envoie un événement personnalisé à CloudWatch Events. L’événement est contenu dans le fichier putevents.json :
```
aws events put-events --entries {{file://putevents.json}}
```
Voici le contenu du fichier putevents.json :
```
[
{
"Source": "com.mycompany.myapp",
"Detail": "{ \"key1\": \"value1\", \"key2\": \"value2\" }",
"Resources": [
"resource1",
"resource2"
],
"DetailType": "myDetailType"
},
{
"Source": "com.mycompany.myapp",
"Detail": "{ \"key1\": \"value3\", \"key2\": \"value4\" }",
"Resources": [
"resource1",
"resource2"
],
"DetailType": "myDetailType"
}
]
```
+ Pour plus de détails sur l'API, consultez [ PutEvents ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-events.html) la section Référence des *AWS CLI commandes*.
### `put-rule`
L'exemple de code suivant montre comment utiliser`put-rule`.
**AWS CLI**
**Pour créer des règles relatives aux CloudWatch événements **
Cet exemple crée une règle qui se déclenche chaque jour à 9 h 00 (UTC). Si vous utilisez put-targets pour ajouter une fonction Lambda comme cible de cette règle, vous pouvez exécuter la fonction Lambda tous les jours à l’heure spécifiée :
```
aws events put-rule --name {{"DailyLambdaFunction"}} --schedule-expression {{"cron(0 9 * * ? *)"}}
```
Cet exemple crée une règle qui se déclenche lorsqu’une instance EC2 de la région change d’état :
```
aws events put-rule --name {{"EC2InstanceStateChanges"}} --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"]}" --role-arn {{"arn:aws:iam::123456789012:role/MyRoleForThisRule"}}
```
Cet exemple crée une règle qui se déclenche lorsqu’une instance EC2 de la région est arrêtée ou supprimée :
```
aws events put-rule --name {{"EC2InstanceStateChangeStopOrTerminate"}} --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"],\"detail\":{\"state\":[\"stopped\",\"terminated\"]}}" --role-arn {{"arn:aws:iam::123456789012:role/MyRoleForThisRule"}}
```
+ Pour plus de détails sur l'API, consultez [ PutRule ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-rule.html) la section Référence des *AWS CLI commandes*.
### `cibles de mise`
L'exemple de code suivant montre comment utiliser`put-targets`.
**AWS CLI**
**Pour ajouter des cibles aux règles relatives aux CloudWatch événements **
Cet exemple ajoute une fonction Lambda comme cible d’une règle :
```
aws events put-targets --rule {{DailyLambdaFunction}} --targets "Id"="1","Arn"="arn:aws:lambda:us-east-1:123456789012:function:MyFunctionName"
```
Cet exemple définit un flux Amazon Kinesis comme cible, afin que les événements concernés par cette règle soient relayés vers le flux :
```
aws events put-targets --rule {{EC2InstanceStateChanges}} --targets "Id"="1","Arn"="arn:aws:kinesis:us-east-1:123456789012:stream/MyStream","RoleArn"="arn:aws:iam::123456789012:role/MyRoleForThisRule"
```
Cet exemple définit deux flux Amazon Kinesis comme cibles pour une règle :
```
aws events put-targets --rule {{DailyLambdaFunction}} --targets "Id"="Target1","Arn"="arn:aws:kinesis:us-east-1:379642911888:stream/MyStream1","RoleArn"="arn:aws:iam::379642911888:role/ MyRoleToAccessLambda" "Id"="Target2"," Arn"="arn:aws:kinesis:us-east-1:379642911888:stream/MyStream2","RoleArn"="arn:aws:iam::379642911888:role/MyRoleToAccessLambda"
```
+ Pour plus de détails sur l'API, consultez [ PutTargets ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-targets.html) la section Référence des *AWS CLI commandes*.
### `supprimer des cibles`
L'exemple de code suivant montre comment utiliser`remove-targets`.
**AWS CLI**
**Pour supprimer une cible pour un événement**
Cet exemple supprime le flux Amazon Kinesis nommé MyStream 1 de la liste des cibles de la règle DailyLambdaFunction. Lors DailyLambdaFunction de sa création, ce flux était défini comme cible avec l'ID Target1 :
```
aws events remove-targets --rule {{"DailyLambdaFunction"}} --ids {{"Target1"}}
```
+ Pour plus de détails sur l'API, consultez [ RemoveTargets ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/remove-targets.html) la section Référence des *AWS CLI commandes*.
### `modèle d'événement de test`
L'exemple de code suivant montre comment utiliser`test-event-pattern`.
**AWS CLI**
**Pour vérifier si un modèle d’événement correspond à un événement spécifié**
Cet exemple teste si le modèle « source:com.mycompany.myapp » correspond à l’événement spécifié. Dans cet exemple, le résultat serait « true » :
```
aws events test-event-pattern --event-pattern "{\"source\":[\"com.mycompany.myapp\"]}" --event "{\"id\":\"1\",\"source\":\"com.mycompany.myapp\",\"detail-type\":\"myDetailType\",\"account\":\"123456789012\",\"region\":\"us-east-1\",\"time\":\"2017-04-11T20:11:04Z\"}"
```
+ Pour plus de détails sur l'API, consultez [ TestEventPattern ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/test-event-pattern.html) la section Référence des *AWS CLI commandes*.