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 usando AWS CLI
<a name="cli_2_eventbridge_code_examples"></a>

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.

*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
<a name="actions"></a>

### `delete-rule`
<a name="eventbridge_DeleteRule_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-rule`.

**AWS CLI**  
**Para excluir uma regra de CloudWatch eventos**  
Este exemplo exclui a regra chamada EC2InstanceStateChanges:  

```
aws events delete-rule --name "EC2InstanceStateChanges"
```
+  Para obter detalhes da API, consulte [DeleteRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/delete-rule.html)em *Referência de AWS CLI Comandos*. 

### `describe-rule`
<a name="eventbridge_DescribeRule_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `describe-rule`.

**AWS CLI**  
**Para exibir informações sobre uma regra de CloudWatch Eventos**  
Este exemplo exibe informações sobre a regra chamada DailyLambdaFunction:  

```
aws events describe-rule --name "DailyLambdaFunction"
```
+  Para obter detalhes da API, consulte [DescribeRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/describe-rule.html)em *Referência de AWS CLI Comandos*. 

### `disable-rule`
<a name="eventbridge_DisableRule_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `disable-rule`.

**AWS CLI**  
**Para desativar uma regra de CloudWatch eventos**  
Este exemplo desativa a regra chamada DailyLambdaFunction. A regra não é excluída:  

```
aws events disable-rule --name "DailyLambdaFunction"
```
+  Para obter detalhes da API, consulte [DisableRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/disable-rule.html)em *Referência de AWS CLI Comandos*. 

### `enable-rule`
<a name="eventbridge_EnableRule_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `enable-rule`.

**AWS CLI**  
**Para habilitar uma regra de CloudWatch Eventos**  
Este exemplo ativa a regra chamada DailyLambdaFunction, que havia sido desativada anteriormente:  

```
aws events enable-rule --name "DailyLambdaFunction"
```
+  Para obter detalhes da API, consulte [EnableRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/enable-rule.html)em *Referência de AWS CLI Comandos*. 

### `list-rule-names-by-target`
<a name="eventbridge_ListRuleNamesByTarget_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-rule-names-by-target`.

**AWS CLI**  
**Como exibir todas as regras que têm um destino especificado**  
Este exemplo exibe todas as regras que têm a função Lambda chamada "MyFunctionName" como destino:  

```
aws events list-rule-names-by-target --target-arn "arn:aws:lambda:us-east-1:123456789012:function:MyFunctionName"
```
+  Para obter detalhes da API, consulte [ListRuleNamesByTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-rule-names-by-target.html)em *Referência de AWS CLI Comandos*. 

### `list-rules`
<a name="eventbridge_ListRules_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-rules`.

**AWS CLI**  
**Para exibir uma lista de todas as regras de CloudWatch eventos**  
Este exemplo exibe todas as regras de CloudWatch eventos na região:  

```
aws events list-rules
```
**Para exibir uma lista de regras de CloudWatch eventos começando com uma determinada string.**  
Este exemplo exibe todas as regras de CloudWatch eventos na região que têm um nome começando com “Diário”:  

```
aws events list-rules --name-prefix "Daily"
```
+  Para obter detalhes da API, consulte [ListRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-rules.html)em *Referência de AWS CLI Comandos*. 

### `list-targets-by-rule`
<a name="eventbridge_ListTargetsByRule_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-targets-by-rule`.

**AWS CLI**  
**Para exibir todos os alvos de uma regra de CloudWatch Eventos**  
Este exemplo exibe todos os alvos da regra chamada DailyLambdaFunction:  

```
aws events list-targets-by-rule --rule  "DailyLambdaFunction"
```
+  Para obter detalhes da API, consulte [ListTargetsByRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-targets-by-rule.html)em *Referência de AWS CLI Comandos*. 

### `put-events`
<a name="eventbridge_PutEvents_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `put-events`.

**AWS CLI**  
**Para enviar um evento personalizado para CloudWatch Eventos**  
Este exemplo envia um evento personalizado para CloudWatch Eventos. O evento está contido no arquivo putevents.json:  

```
aws events put-events --entries file://putevents.json
```
Veja a seguir o conteúdo do arquivo putevent.json:  

```
[
  {
    "Source": "com.mycompany.myapp",
    "Detail": "{ \"key1\": \"value1\", \"key2\": \"value2\" }",
    "Resources": [
      "resource1",
      "resource2"
    ],
    "DetailType": "myDetailType"
  },
  {
    "Source": "com.mycompany.myapp",
    "Detail": "{ \"key1\": \"value3\", \"key2\": \"value4\" }",
    "Resources": [
      "resource1",
      "resource2"
    ],
    "DetailType": "myDetailType"
   }
]
```
+  Para obter detalhes da API, consulte [PutEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-events.html)em *Referência de AWS CLI Comandos*. 

### `put-rule`
<a name="eventbridge_PutRule_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `put-rule`.

**AWS CLI**  
**Para criar regras de CloudWatch eventos**  
Este exemplo cria uma regra que é acionada todos os dias, às 9h UTC. Se você usar put-targets para adicionar uma função do Lambda como destino dessa regra, poderá executar a função do Lambda todos os dias no horário especificado:  

```
aws events put-rule --name "DailyLambdaFunction" --schedule-expression "cron(0 9 * * ? *)"
```
Este exemplo cria uma regra que é acionada quando qualquer instância do EC2 na região muda de estado:  

```
aws events put-rule --name "EC2InstanceStateChanges" --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"]}"  --role-arn "arn:aws:iam::123456789012:role/MyRoleForThisRule"
```
Este exemplo cria uma regra que é acionada quando qualquer instância do EC2 na região é interrompida ou encerrada:  

```
aws events put-rule --name "EC2InstanceStateChangeStopOrTerminate" --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"],\"detail\":{\"state\":[\"stopped\",\"terminated\"]}}" --role-arn "arn:aws:iam::123456789012:role/MyRoleForThisRule"
```
+  Para obter detalhes da API, consulte [PutRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-rule.html)em *Referência de AWS CLI Comandos*. 

### `put-targets`
<a name="eventbridge_PutTargets_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `put-targets`.

**AWS CLI**  
**Para adicionar alvos às regras de CloudWatch eventos**  
Este exemplo adiciona uma função do Lambda como o destino de uma regra:  

```
aws events put-targets --rule DailyLambdaFunction --targets "Id"="1","Arn"="arn:aws:lambda:us-east-1:123456789012:function:MyFunctionName"
```
Este exemplo define um fluxo do Amazon Kinesis como o destino. Desta forma, os eventos capturados pela regra são retransmitidos para o fluxo:  

```
aws events put-targets --rule EC2InstanceStateChanges --targets "Id"="1","Arn"="arn:aws:kinesis:us-east-1:123456789012:stream/MyStream","RoleArn"="arn:aws:iam::123456789012:role/MyRoleForThisRule"
```
Este exemplo define dois fluxos do Amazon Kinesis como destinos de uma regra:  

```
aws events put-targets --rule DailyLambdaFunction --targets "Id"="Target1","Arn"="arn:aws:kinesis:us-east-1:379642911888:stream/MyStream1","RoleArn"="arn:aws:iam::379642911888:role/ MyRoleToAccessLambda"  "Id"="Target2"," Arn"="arn:aws:kinesis:us-east-1:379642911888:stream/MyStream2","RoleArn"="arn:aws:iam::379642911888:role/MyRoleToAccessLambda"
```
+  Para obter detalhes da API, consulte [PutTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-targets.html)em *Referência de AWS CLI Comandos*. 

### `remove-targets`
<a name="eventbridge_RemoveTargets_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `remove-targets`.

**AWS CLI**  
**Como remover um destino de um evento**  
Este exemplo remove o stream do Amazon Kinesis chamado MyStream 1 de ser um alvo da regra. DailyLambdaFunction Quando DailyLambdaFunction foi criado, esse fluxo foi definido como um destino com um ID de Target1:  

```
aws events remove-targets --rule "DailyLambdaFunction" --ids "Target1"
```
+  Para obter detalhes da API, consulte [RemoveTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/remove-targets.html)em *Referência de AWS CLI Comandos*. 

### `test-event-pattern`
<a name="eventbridge_TestEventPattern_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `test-event-pattern`.

**AWS CLI**  
**Verificar se um padrão de evento corresponde a um evento especificado**  
Este exemplo testa se o padrão “source:com.mycompany.myapp” corresponde ao evento especificado. Neste exemplo, o resultado seria “verdadeiro”:  

```
aws events test-event-pattern --event-pattern "{\"source\":[\"com.mycompany.myapp\"]}" --event "{\"id\":\"1\",\"source\":\"com.mycompany.myapp\",\"detail-type\":\"myDetailType\",\"account\":\"123456789012\",\"region\":\"us-east-1\",\"time\":\"2017-04-11T20:11:04Z\"}"
```
+  Para obter detalhes da API, consulte [TestEventPattern](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/test-event-pattern.html)em *Referência de AWS CLI Comandos*.