Esempi per pipe EventBridge con AWS CLI - AWS Command Line Interface
Operazioni

Esempi per pipe EventBridge con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con il servizio pipe per EventBridge.

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 link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare create-pipe.

AWS CLI

Come creare una pipe

L’esempio create-pipe seguente crea una pipe denominata Demo_Pipe con SQS come origine e un gruppo di log CloudWatch 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 Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull’API, consulta CreatePipe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-pipe.

AWS CLI

Come eliminare una pipe esistente

Nell’esempio seguente delete-pipe 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 Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull’API, consulta DeletePipe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-pipe.

AWS CLI

Come recuperare le informazioni relative a una pipe

Nell’esempio describe-pipe seguente vengono visualizzate 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 Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull’API, consulta DescribePipe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-pipes.

AWS CLI

Come recuperare un elenco di pipe

Nell’esempio seguente list-pipes elenca 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 Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull’API, consulta ListPipes in 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

Nell’esempio seguente list-tags-for-resource 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 Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull'API, consulta ListTagsForResource nella Documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare start-pipe.

AWS CLI

Come avviare una pipe esistente

Nell’esempio seguente start-pipe 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 la pagina Starting or stopping an Amazon EventBridge pipe nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull’API, consulta StartPipe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare stop-pipe.

AWS CLI

Come arrestare una pipe esistente

Nell’esempio seguente stop-pipe 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 la pagina Starting or stopping an Amazon EventBridge pipe nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull’API, consulta StopPipe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come taggare una pipe esistente

Nell’esempio seguente tag-resource 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 Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sulle API, consulta TagResource nel Riferimento ai comandi AWS CLI.

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 \
    --tags stack

Per ulteriori informazioni, consulta Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per i dettagli dell'API, consulta UntagResource in Riferimento ai comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare update-pipe.

AWS CLI

Come aggiornare una pipe esistente

L’esempio update-pipe seguente aggiorna la pipe denominata Demo_Pipe aggiungendo un parametro di configurazione CloudWatch Log, assicurandosi 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 Amazon EventBridge pipes concepts nella Guida per l’utente di Amazon EventBridge.

  • Per informazioni dettagliate sull’API, consulta UpdatePipe in AWS CLI Command Reference.