Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# EventBridge Exemplos de tubos usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with EventBridge Pipes.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-pipe`
O código de exemplo a seguir mostra como usar `create-pipe`.
**AWS CLI**
**Como criar um pipe**
O `create-pipe` exemplo a seguir cria um Pipe nomeado `Demo_Pipe` com SQS como origem e CloudWatch Log Group como destino para o 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
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [CreatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/create-pipe.html)em *Referência de AWS CLI Comandos*.
### `delete-pipe`
O código de exemplo a seguir mostra como usar `delete-pipe`.
**AWS CLI**
**Como excluir um pipe existente**
O exemplo de `delete-pipe` a seguir exclui um pipe chamado `Demo_Pipe` na conta especificada.
```
aws pipes delete-pipe \
--name Demo_Pipe
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [DeletePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/delete-pipe.html)em *Referência de AWS CLI Comandos*.
### `describe-pipe`
O código de exemplo a seguir mostra como usar `describe-pipe`.
**AWS CLI**
**Como recuperar informações sobre um pipe**
O exemplo de `describe-pipe` a seguir exibe as informações sobre o pipe `Demo_Pipe` na conta especificada.
```
aws pipes describe-pipe \
--name Demo_Pipe
```
Saída:
```
{
"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"
}
}
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [DescribePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/describe-pipe.html)em *Referência de AWS CLI Comandos*.
### `list-pipes`
O código de exemplo a seguir mostra como usar `list-pipes`.
**AWS CLI**
**Como recuperar uma lista de pipes**
O exemplo de `list-pipes` a seguir mostra todos os pipes na conta especificada.
```
aws pipes list-pipes
```
Saída:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [ListPipes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-pipes.html)em *Referência de AWS CLI Comandos*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Como listar as tags associadas a um pipe existente**
O exemplo de `list-tags-for-resource` a seguir lista todas as tags associadas a um pipe chamado `Demo_Pipe` na conta especificada.
```
aws pipes list-tags-for-resource \
--resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe
```
Saída:
```
{
"tags": {
"stack": "Production",
"team": "DevOps"
}
}
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*.
### `start-pipe`
O código de exemplo a seguir mostra como usar `start-pipe`.
**AWS CLI**
**Como iniciar um pipe existente**
O exemplo de `start-pipe` a seguir inicia um pipe chamado `Demo_Pipe` na conta especificada.
```
aws pipes start-pipe \
--name Demo_Pipe
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte [Iniciando ou parando uma EventBridge tubulação da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) *no Guia EventBridge do usuário* da Amazon.
+ Para obter detalhes da API, consulte [StartPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/start-pipe.html)em *Referência de AWS CLI Comandos*.
### `stop-pipe`
O código de exemplo a seguir mostra como usar `stop-pipe`.
**AWS CLI**
**Como interromper um pipe existente**
O exemplo de `stop-pipe` a seguir interrompe um pipe chamado `Demo_Pipe` na conta especificada.
```
aws pipes stop-pipe \
--name Demo_Pipe
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte [Iniciando ou parando uma EventBridge tubulação da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) *no Guia EventBridge do usuário* da Amazon.
+ Para obter detalhes da API, consulte [StopPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/stop-pipe.html)em *Referência de AWS CLI Comandos*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como marcar um pipe existente**
O exemplo de `tag-resource` a seguir marca um pipe chamado `Demo_Pipe`. Se o comando for bem-sucedido, nenhuma saída será retornada.
```
aws pipes tag-resource \
--resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
--tags stack=Production
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/tag-resource.html)em *Referência de AWS CLI Comandos*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Como remover uma tag de um pipe existente**
O exemplo de `untag-resource` a seguir remove uma tag com a chave `stack` do pipe chamado `Demo_Pipe`. Se o comando for bem-sucedido, nenhuma saída será retornada.
```
aws pipes untag-resource \
--resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
--tags stack
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/untag-resource.html)em *Referência de AWS CLI Comandos*.
### `update-pipe`
O código de exemplo a seguir mostra como usar `update-pipe`.
**AWS CLI**
**Como atualizar um pipeline existente**
O `update-pipe` exemplo a seguir atualiza o Pipe nomeado `Demo_Pipe` adicionando um parâmetro de configuração CloudWatch Log. Certifique-se de atualizar a função de execução do pipe para que ele tenha as permissões corretas para o destino do 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
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte os [conceitos do Amazon EventBridge Pipes](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) no *Guia EventBridge do usuário da Amazon*.
+ Para obter detalhes da API, consulte [UpdatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/update-pipe.html)em *Referência de AWS CLI Comandos*.