EventBridge Exemples de tuyaux utilisant AWS CLI - AWS Command Line Interface
Actions

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.

Rubriques

Actions

L'exemple de code suivant montre comment utilisercreate-pipe.

AWS CLI

Pour créer un pipeline

L'create-pipeexemple 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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous CreatePipeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous DeletePipeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous DescribePipeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous ListPipesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstart-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous StartPipeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstop-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous StopPipeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-pipe.

AWS CLI

Pour mettre à jour un pipeline existant

L'update-pipeexemple 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 dans le guide de EventBridge l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous UpdatePipeà la section Référence des AWS CLI commandes.