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 de tuyaux 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 Pipes.
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
### `create-pipe`
L'exemple de code suivant montre comment utiliser`create-pipe`.
**AWS CLI**
**Pour créer un pipeline**
L'`create-pipe`exemple suivant crée un canal nommé `Demo_Pipe` avec SQS comme source et CloudWatch Log Group comme cible pour le canal.
```
aws pipes create-pipe \
--name Demo_Pipe \
--desired-state RUNNING \
--role-arn arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f \
--source arn:aws:sqs:us-east-1:123456789012:Demo_Queue \
--target arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup
```
Sortie :
```
{
"Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe",
"Name": "Demo_Pipe",
"DesiredState": "RUNNING",
"CurrentState": "CREATING",
"CreationTime": "2024-10-08T12:33:59-05:00",
"LastModifiedTime": "2024-10-08T12:33:59.684839-05:00"
}
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [CreatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/create-pipe.html)à la section *Référence des AWS CLI commandes*.
### `delete-pipe`
L'exemple de code suivant montre comment utiliser`delete-pipe`.
**AWS CLI**
**Pour supprimer un pipeline existant**
L’exemple `delete-pipe` suivant supprime le pipeline nommé `Demo_Pipe` dans le compte spécifié.
```
aws pipes delete-pipe \
--name Demo_Pipe
```
Sortie :
```
{
"Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe",
"Name": "Demo_Pipe",
"DesiredState": "STOPPED",
"CurrentState": "DELETING",
"CreationTime": "2024-10-08T09:29:10-05:00",
"LastModifiedTime": "2024-10-08T11:57:22-05:00"
}
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [DeletePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/delete-pipe.html)à la section *Référence des AWS CLI commandes*.
### `describe-pipe`
L'exemple de code suivant montre comment utiliser`describe-pipe`.
**AWS CLI**
**Pour extraire des informations sur un pipeline**
L’exemple `describe-pipe` suivant affiche des informations sur le pipeline `Demo_Pipe` dans le compte spécifié.
```
aws pipes describe-pipe \
--name Demo_Pipe
```
Sortie :
```
{
"Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe",
"Name": "Demo_Pipe",
"DesiredState": "RUNNING",
"CurrentState": "RUNNING",
"StateReason": "User initiated",
"Source": "arn:aws:sqs:us-east-1:123456789012:Demo_Queue",
"SourceParameters": {
"SqsQueueParameters": {
"BatchSize": 1
}
},
"EnrichmentParameters": {},
"Target": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup",
"TargetParameters": {},
"RoleArn": "arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f",
"Tags": {},
"CreationTime": "2024-10-08T09:29:10-05:00",
"LastModifiedTime": "2024-10-08T10:23:47-05:00",
"LogConfiguration": {
"CloudwatchLogsLogDestination": {
"LogGroupArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/vendedlogs/pipes/Demo_Pipe"
},
"Level": "ERROR"
}
}
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [DescribePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/describe-pipe.html)à la section *Référence des AWS CLI commandes*.
### `list-pipes`
L'exemple de code suivant montre comment utiliser`list-pipes`.
**AWS CLI**
**Pour extraire une liste de pipelines**
L’exemple `list-pipes` suivant montre tous les pipelines du compte spécifié.
```
aws pipes list-pipes
```
Sortie :
```
{
"Pipes": [
{
"Name": "Demo_Pipe",
"Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe",
"DesiredState": "RUNNING",
"CurrentState": "RUNNING",
"StateReason": "User initiated",
"CreationTime": "2024-10-08T09:29:10-05:00",
"LastModifiedTime": "2024-10-08T10:23:47-05:00",
"Source": "arn:aws:sqs:us-east-1:123456789012:Demo_Queue",
"Target": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup"
}
]
}
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [ListPipes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-pipes.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour répertorier les balises associées à un pipeline existant**
L’exemple `list-tags-for-resource` suivant répertorie toutes les balises associées à un pipeline nommé `Demo_Pipe` dans le compte spécifié.
```
aws pipes list-tags-for-resource \
--resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe
```
Sortie :
```
{
"tags": {
"stack": "Production",
"team": "DevOps"
}
}
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `start-pipe`
L'exemple de code suivant montre comment utiliser`start-pipe`.
**AWS CLI**
**Pour démarrer un pipeline existant**
L’exemple `start-pipe` suivant démarre un pipeline nommé `Demo_Pipe` dans le compte spécifié.
```
aws pipes start-pipe \
--name Demo_Pipe
```
Sortie :
```
{
"Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe",
"Name": "Demo_Pipe",
"DesiredState": "RUNNING",
"CurrentState": "STARTING",
"CreationTime": "2024-10-08T09:29:10-05:00",
"LastModifiedTime": "2024-10-08T10:17:24-05:00"
}
```
Pour plus d'informations, consultez la section [Démarrage ou arrêt d'un EventBridge canal Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [StartPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/start-pipe.html)à la section *Référence des AWS CLI commandes*.
### `stop-pipe`
L'exemple de code suivant montre comment utiliser`stop-pipe`.
**AWS CLI**
**Pour arrêter un pipeline existant**
L’exemple `stop-pipe` suivant arrête un pipeline nommé `Demo_Pipe` dans le compte spécifié.
```
aws pipes stop-pipe \
--name Demo_Pipe
```
Sortie :
```
{
"Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe",
"Name": "Demo_Pipe",
"DesiredState": "STOPPED",
"CurrentState": "STOPPING",
"CreationTime": "2024-10-08T09:29:10-05:00",
"LastModifiedTime": "2024-10-08T09:29:49-05:00"
}
```
Pour plus d'informations, consultez la section [Démarrage ou arrêt d'un EventBridge canal Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [StopPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/stop-pipe.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour baliser un pipeline existant**
L’exemple `tag-resource` suivant balise un pipeline nommé `Demo_Pipe`. Si la commande réussit, aucune sortie n’est renvoyée.
```
aws pipes tag-resource \
--resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
--tags stack=Production
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer une balise d’un pipeline existant**
L’exemple `untag-resource` suivant supprime une balise avec la clé `stack` du pipeline nommé `Demo_Pipe`. Si la commande réussit, aucune sortie n’est renvoyée.
```
aws pipes untag-resource \
--resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
--tags stack
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-pipe`
L'exemple de code suivant montre comment utiliser`update-pipe`.
**AWS CLI**
**Pour mettre à jour un pipeline existant**
L'`update-pipe`exemple suivant met à jour le canal nommé `Demo_Pipe` en ajoutant un paramètre de configuration CloudWatch Log. Assurez-vous de mettre à jour le rôle d'exécution du canal afin qu'il dispose des autorisations appropriées pour la destination du journal.
```
aws pipes update-pipe \
--name Demo_Pipe \
--desired-state RUNNING \
--log-configuration CloudwatchLogsLogDestination={LogGroupArn=arn:aws:logs:us-east-1:123456789012:log-group:/aws/vendedlogs/pipes/Demo_Pipe},Level=TRACE \
--role-arn arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f
```
Sortie :
```
{
"Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe",
"Name": "Demo_Pipe",
"DesiredState": "RUNNING",
"CurrentState": "UPDATING",
"CreationTime": "2024-10-08T09:29:10-05:00",
"LastModifiedTime": "2024-10-08T11:35:48-05:00"
}
```
Pour plus d'informations, consultez les [concepts d'Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Pour plus de détails sur l'API, reportez-vous [UpdatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/update-pipe.html)à la section *Référence des AWS CLI commandes*.