Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) 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 *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.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-pipe`
Il seguente esempio di codice mostra come utilizzare`create-pipe`.
**AWS CLI**
**Come creare una pipe**
L'`create-pipe`esempio 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [CreatePipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/create-pipe.html)*Command Reference*.
### `delete-pipe`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [DeletePipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/delete-pipe.html)*Command Reference*.
### `describe-pipe`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [DescribePipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/describe-pipe.html)*Command Reference*.
### `list-pipes`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [ListPipes AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-pipes.html)*Command Reference*.
### `list-tags-for-resource`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-tags-for-resource.html)*Command Reference*.
### `start-pipe`
Il seguente esempio di codice 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 una EventBridge pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [StartPipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/start-pipe.html)*Command Reference.*
### `stop-pipe`
Il seguente esempio di codice 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 una EventBridge pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [StopPipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/stop-pipe.html)*Command Reference.*
### `tag-resource`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/tag-resource.html)*Command Reference*.
### `untag-resource`
Il seguente esempio di codice 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 [ EventBridge i concetti di Amazon Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/untag-resource.html)*Command Reference*.
### `update-pipe`
Il seguente esempio di codice mostra come utilizzare`update-pipe`.
**AWS CLI**
**Come aggiornare una pipe esistente**
L'`update-pipe`esempio 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) nella *Amazon EventBridge User Guide*.
+ Per i dettagli sull'API, consulta [UpdatePipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/update-pipe.html)*Command Reference*.