View a markdown version of this page

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

Sono disponibili altri esempi di 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 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

L’esempio di codice seguente mostra come utilizzare create-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.

  • Per i dettagli sulle API, consulta la sezione CreatePipe AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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.

  • Per i dettagli sulle API, consulta la sezione DeletePipe AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-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.

  • Per i dettagli sulle API, consulta la sezione DescribePipe AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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.

  • Per i dettagli sulle API, consulta la sezione ListPipes AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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.

L’esempio di codice seguente mostra come utilizzare start-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 Amazon EventBridge Pipe nella Amazon EventBridge User Guide.

  • Per i dettagli sulle API, consulta la sezione StartPipe AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare stop-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 Amazon EventBridge Pipe nella Amazon EventBridge User Guide.

  • Per i dettagli sulle API, consulta la sezione StopPipe AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-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.

  • Per i dettagli sulle API, consulta la sezione TagResource AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-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 \
    --tag-keys stack

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

  • Per i dettagli sulle API, consulta la sezione UntagResource AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-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, assicurati 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.

  • Per i dettagli sulle API, consulta la sezione UpdatePipe AWS CLI Command Reference.