

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á.

# Crie uma EventBridge regra para uma fonte do Amazon S3 (console)
<a name="create-cloudtrail-S3-source-console"></a>

Antes de configurar uma regra em EventBridge, você deve criar uma AWS CloudTrail trilha. Para obter mais informações, consulte [Criar uma trilha no console](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-a-trail-using-the-console-first-time.html).

**Importante**  
Se você usa o console para criar ou editar seu pipeline, sua EventBridge regra e AWS CloudTrail trilha são criadas para você.

**Para criar uma trilha**

1. Abra o AWS CloudTrail console.

1. No painel de navegação, selecione **Trilhas**.

1. Escolha **Create Trail (Criar trilha)**. Em **Trail name (Nome da trilha)**, informe um nome para a trilha.

1. Em **Storage location** (Local de armazenamento), crie ou especifique o bucket a ser usado para armazenar os arquivos de log. Por padrão, os buckets e objetos do Amazon S3 são privados. Somente o proprietário do recurso (a AWS conta que criou o bucket) pode acessar o bucket e seus objetos. O bucket deve ter uma política de recursos que permita AWS CloudTrail permissões para acessar os objetos no bucket.

1. Em **Bucket e pasta de log de trilha**, especifique um bucket do Amazon S3 e o prefixo do objeto (nome da pasta) para registrar em log os eventos de dados de todos os objetos da pasta. Para cada trilha, você pode adicionar até 250 objetos do Amazon S3. Preencha as informações necessárias da chave de criptografia e escolha **Próximo**.

1. Em **Tipo de evento**, escolha **Eventos de gerenciamento**.

1. Em **Eventos de gerenciamento**, escolha **Editar**. A trilha registra a atividade da API no nível do objeto do Amazon S3 (por exemplo, `GetObject` e `PutObject`) no bucket e no prefixo especificados.

1. Selecione **Write (Gravar)**. 

1. Se você estiver satisfeito com a trilha, escolha **Criar trilha**.

**Para criar uma EventBridge regra que tenha como alvo seu pipeline com uma fonte do Amazon S3**

1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Regras**. Deixe o barramento padrão selecionado ou escolha um barramento de eventos. Escolha **Criar regra**.

1. Em **Nome**, insira um nome para a regra.

1. Em **Tipo de regra**, escolha **Regra com um padrão de eventos**. Escolha **Próximo**.

1. Em **Fonte do evento**, escolha **AWS eventos ou eventos de EventBridge parceiros**.

1. Em **Tipo de evento de amostra**, escolha **Eventos do AWS **.

1. Em **Eventos de amostra**, digite S3 como a palavra-chave que servirá como base para a filtragem. Escolha a **chamada de AWS API via CloudTrail**.

1. Em **Método de criação**, escolha **Padrão personalizado (editor JSON)**.

   Cole o padrão de evento fornecido abaixo. Certifique-se de adicionar o nome do bucket e a chave de objeto do S3 (ou o nome da chave) que identifica o objeto no bucket como `requestParameters`. Neste exemplo, uma regra é criada para um bucket chamado `amzn-s3-demo-source-bucket` e a chave de objeto `my-files.zip`. Quando você usa a janela **Edit** (Editar) para especificar os recursos, a regra é atualizada para usar um padrão de evento personalizado.

   Veja a seguir um exemplo de padrão de evento para copiar e colar:

   ```
   {
       "source": [
           "aws.s3"
       ],
       "detail-type": [
           "AWS API Call via CloudTrail"
       ],
       "detail": {
           "eventSource": [
               "s3.amazonaws.com"
           ],
           "eventName": [
               "CopyObject",
               "CompleteMultipartUpload",
               "PutObject"
           ],
           "requestParameters": {
               "bucketName": [
                   "amzn-s3-demo-source-bucket"
               ],
               "key": [
                   "my-files.zip"
               ]
           }
       }
   }
   ```

1. Escolha **Próximo**.

1. Em **Tipos de destino**, escolha **Serviço da AWS **.

1. Em **Selecionar um alvo**, escolha **CodePipeline**. Em **ARN do pipeline**, insira o ARN do pipeline a ser iniciado por esta regra.
**nota**  
Para obter o ARN do pipeline, execute o comando **get-pipeline**. O ARN do pipeline é exibido na saída. Ele é construído neste formato:   
arn: aws:codepipeline::: *region* *account* *pipeline-name*  
Exemplo de ARN do pipeline:  
arn:aws:codepipeline:us-east- 2:80398 EXEMPLO: MyFirstPipeline 

1. Para criar ou especificar uma função de serviço do IAM que conceda EventBridge permissões para invocar o destino associado à sua EventBridge regra (nesse caso, o alvo é CodePipeline): 
   + Escolha **Criar uma nova função para esse recurso específico** para criar uma função de serviço que dê EventBridge permissões para você iniciar suas execuções de funil.
   + Escolha **Usar função existente** para inserir uma função de serviço que conceda EventBridge permissões para você iniciar suas execuções de funil.

1. (Opcional) Para especificar substituições de origem com um ID de imagem específico, use o transformador de entrada para passar os dados como parâmetros JSON. Você também pode usar o transformador de entrada para passar variáveis de pipeline.
   + Expanda **Additional settings** (Configurações adicionais).

     Em **Configurar entrada de destino**, escolha **Configurar transformador de entrada**.

     Na janela de diálogo, escolha **Inserir um próprio**. Na caixa **Caminho de entrada**, digite os pares de chave-valor a seguir.

     ```
     {"revisionValue": "$.detail.object.version-id"}
     ```
   + Na caixa **Modelo**, digite os pares de chave-valor a seguir.

     ```
                                     
                                     {
         "sourceRevisions": [
             {
                 "actionName": "Source",
                 "revisionType": "S3_OBJECT_VERSION_ID",
                 "revisionValue": "<revisionValue>"
             }
         ],
          "variables": [
             {
                 "name": "Variable_Name",
                 "value": "Variable_Value"
             }
         ]
     }
     ```
   + Escolha **Confirmar**.

1. Escolha **Próximo**.

1. Na página **Tags**, selecione **Próximo**.

1. Na página **Revisar e criar**, revise a configuração da regra. Se você estiver satisfeito com a regra, escolha **Create rule**.