EventBridge Esempi di tubi che utilizzano AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

EventBridge Esempi di tubi che utilizzano AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with EventBridge Pipes.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-pipe.

AWS CLI

Come creare una pipe

L'create-pipeesempio seguente crea una Pipe denominata Demo_Pipe con SQS come origine e CloudWatch Log Group come destinazione per la Pipe.

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

Output:

{
    "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"
}

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-pipe.

AWS CLI

Come eliminare una pipe esistente

L’esempio delete-pipe seguente elimina una pipe denominata Demo_Pipe nell’account specificato.

aws pipes delete-pipe \
    --name Demo_Pipe

Output:

{
    "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"
}

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-pipe.

AWS CLI

Come recuperare le informazioni relative a una pipe

L’esempio describe-pipe seguente visualizza informazioni sulla pipe Demo_Pipe nell’account specificato.

aws pipes describe-pipe \
    --name Demo_Pipe

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzarelist-pipes.

AWS CLI

Come recuperare un elenco di pipe

L’esempio list-pipes seguente mostra tutte le pipe nell’account specificato.

aws pipes list-pipes

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag associati a una pipe esistente

L’esempio list-tags-for-resource seguente elenca tutti i tag associati a una pipe denominata Demo_Pipe nell’account specificato.

aws pipes list-tags-for-resource \
    --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe

Output:

{
    "tags": {
        "stack": "Production",
        "team": "DevOps"
    }
}

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzarestart-pipe.

AWS CLI

Come avviare una pipe esistente

L’esempio start-pipe seguente avvia una pipe denominata Demo_Pipe nell’account specificato.

aws pipes start-pipe \
    --name Demo_Pipe

Output:

{
    "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"
}

Per ulteriori informazioni, consulta Avvio o arresto di una EventBridge pipa Amazon nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzarestop-pipe.

AWS CLI

Come arrestare una pipe esistente

L’esempio stop-pipe seguente arresta una pipe denominata Demo_Pipe nell’account specificato.

aws pipes stop-pipe \
    --name Demo_Pipe

Output:

{
    "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"
}

Per ulteriori informazioni, consulta Avvio o arresto di una EventBridge pipa Amazon nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come taggare una pipe esistente

L’esempio tag-resource seguente tagga una pipe denominata Demo_Pipe. Se il comando va a buon fine, non viene restituito alcun output.

aws pipes tag-resource \
    --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
    --tags stack=Production

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere un tag da una pipe esistente

L’esempio untag-resource seguente rimuove il tag con la chiave stack per il nome della pipe denominata Demo_Pipe. Se il comando va a buon fine, non viene restituito alcun output.

aws pipes untag-resource \
    --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
    --tags stack

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.

Il seguente esempio di codice mostra come utilizzareupdate-pipe.

AWS CLI

Come aggiornare una pipe esistente

L'update-pipeesempio seguente aggiorna la Pipe denominata Demo_Pipe aggiungendo un parametro di configurazione CloudWatch Log, assicuratevi di aggiornare il ruolo di esecuzione della pipe in modo che abbia le autorizzazioni corrette per la destinazione Log.

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

Output:

{
    "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"
}

Per ulteriori informazioni, consulta EventBridge i concetti di Amazon Pipes nella Amazon EventBridge User Guide.