EventBridge Esempi di pipe che utilizzano AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi AWS SDK nel repository AWS Doc SDK Examples. GitHub

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 pipe 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 operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-pipe.

AWS CLI

Per creare una pipa

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

Per eliminare una pipe esistente

L'delete-pipeesempio 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

Per recuperare informazioni su una Pipe

L'describe-pipeesempio seguente visualizza le 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

Per recuperare un elenco di Pipes

L'list-pipesesempio 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

Per elencare i tag associati a una pipe esistente

L'list-tags-for-resourceesempio 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

Per avviare una pipe esistente

L'start-pipeesempio 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

Per fermare una tubazione esistente

L'stop-pipeesempio 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

Per etichettare una tubazione esistente

L'tag-resourceesempio seguente etichetta una Pipe denominataDemo_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

Per rimuovere un tag da una pipe esistente

L'untag-resourceesempio seguente rimuove un tag con la chiave stack dalla Pipe denominataDemo_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

Per 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 disponga delle 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.