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

# Criação de arquivamentos de eventos no Amazon EventBridge
<a name="eb-archive-event"></a>

Ao criar um arquivamento no EventBridge, você pode determinar quais eventos são enviados para o arquivo especificando um [padrão de evento](eb-event-patterns.md). O EventBridge envia eventos que correspondem ao padrão do evento para o arquivo. Também é definido o período de retenção para armazenar eventos no arquivo antes que eles sejam descartados.

Você também pode criar arquivamentos como parte da [criação de um barramento de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html). Esses arquivamentos têm uma política de retenção indefinida e nenhum filtro de eventos, embora isso possa ser [atualizado](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html) assim que o arquivamento é criado.

**Topics**
+ [Definir o arquivo](#eb-create-archive-define)
+ [Criar o padrão de eventos (opcional)](#eb-create-archive-event-pattern)

## Definir o arquivo
<a name="eb-create-archive-define"></a>

Primeiro, insira um nome e uma descrição para o arquivamento e especifique o barramento de eventos do qual ele recebe eventos. Você também pode definir por quanto tempo reter eventos no arquivamento.

**Para definir o arquivamento**

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

1. Navegue até o barramento de eventos de origem ou crie diretamente o arquivamento:
   + No painel de navegação, selecione **Event buses (Barramentos de eventos)**.

     Na página de detalhes do barramento de eventos, selecione a guia **Arquivos**.
   + No painel de navegação, selecione **Arquivos**.

1. Escolha **Criar arquivo**.

1. Em **Detalhe do arquivo**, insira um nome e, como opção, uma descrição para o arquivamento. 

    O nome deve ser exclusivo na sua conta na sua região selecionada. Não é possível alterar o nome depois de criar o conjunto de IP.

1. Para **Origem**, selecione o barramento de eventos cujos eventos você deseja enviar para o arquivamento

   Se você tiver navegado em uma página de detalhes do barramento de eventos existente, o nome desse barramento de eventos será exibido por padrão.

   Você não poderá alterar o barramento de eventos de origem depois de ter criado o arquivamento.

1. Para **Período de retenção**, especifique por quanto tempo reter os eventos no arquivamento:
   + Escolha **Indefinido** para reter os eventos no arquivo e nunca excluí-los.
   + Para um período de retenção definido, insira o número de dias após os quais o EventBridge deve excluir os eventos do arquivo.

1. Para **Criptografia**, escolha a chave KMS para o EventBridge usar ao criptografar os eventos armazenados no arquivamento.
**Importante**  
Se você tiver especificado que o EventBridge use uma chave gerenciada pelo cliente para criptografar o barramento de eventos de origem, será altamente recomendável você também especificar uma chave gerenciada pelo cliente para qualquer arquivo do barramento de eventos.
   + Escolha **Usar Chave pertencente à AWS** para o EventBridge criptografar os dados usando uma Chave pertencente à AWS.

     Esta Chave pertencente à AWS é uma chave KMS de propriedade do EventBridge e que gerencia para uso em várias contas da AWS. Em geral, a menos que seja necessário auditar ou controlar a chave de criptografia que protege os recursos, uma Chave pertencente à AWS é uma boa escolha. 

     Esse é o padrão.
   + Escolha **Usar chave gerenciada pelo cliente** para o EventBridge criptografar os dados usando a chave gerenciada pelo cliente especificada ou criada por você.

     As chaves gerenciadas pelo cliente são KMS na conta da AWS que você cria, detém e gerencia. Você tem controle total sobre essas chaves KMS.

     1. Especifique uma chave gerenciada pelo cliente existente ou escolha **Criar uma nova chave KMS**.

       O EventBridge exibe o status da chave e todos os aliases de chave que tenham sido associados à chave gerenciada pelo cliente especificada.

1. Escolha **Próximo**.

## Criar o padrão de eventos (opcional)
<a name="eb-create-archive-event-pattern"></a>

Em seguida, como uma etapa opcional, você poderá criar um padrão de evento para filtrar quais eventos o EventBridge envia para o arquivamento. Para fazer isso, especifique a origem do evento, escolha a base para o padrão do evento e defina os atributos e valores aos quais corresponder. Também é possível gerar o padrão de evento em JSON e testá-lo em um evento de amostra.

Para obter mais informações sobre padrões de eventos, consulte [](eb-event-patterns.md).

**Para criar o padrão de eventos**

1. Em **Origem do evento**, escolha **Eventos da AWS ou eventos de parceiro do EventBridge**.

1. (Opcional) Na seção **Eventos de amostra**, escolha um **Tipo de evento de amostra** com o qual deseja testar seu padrão de evento. 

   Os seguintes tipos de eventos estão disponíveis:
   + **Eventos da AWS**: selecione entre os eventos emitidos pelos Serviços da AWS compatíveis.
   + **Eventos de parceiros do EventBridge**: selecione entre os eventos emitidos por serviços de terceiros que são compatíveis com o EventBridge, como o Salesforce.
   + **Inserir o meu próprio**: insira o seu próprio evento em texto JSON.

     Também é possível usar um evento da AWS ou um evento de um parceiro como ponto de partida para criar seu próprio evento personalizado.

     1. Selecione **Eventos da AWS** ou **Eventos de parceiros do EventBridge**.

     1. Use o menu suspenso **Exemplos de eventos** para selecionar o evento que deseja usar como ponto de partida para seu evento personalizado.

        O EventBridge exibe o evento de amostra.

     1. Selecione **Copiar**.

     1. Selecione **Inserir meu próprio** para o **Tipo de evento**.

     1. Exclua a estrutura de eventos de amostra no painel de edição JSON e cole o evento da AWS ou do parceiro no lugar.

     1. Edite o JSON do evento para criar seu próprio evento de amostra.

1. Escolha um **Método de criação**. Também é possível criar um padrão de evento a partir de um esquema ou modelo do EventBridge ou criar um padrão de evento personalizado.

------
#### [ Existing schema ]

   Para usar um esquema do EventBridge existente para criar o padrão de evento, faça o seguinte:

   1. Na seção **Método de criação**, em **Método**, selecione **Usar esquema**.

   1. Na seção **Padrão de evento**, em **Tipo de esquema**, selecione **Selecionar esquema do registro do esquema**.

   1. Em **Registro do esquema**, escolha a caixa suspensa e insira o nome de um registro do esquema, como `aws.events`. Também é possível selecionar uma opção na lista suspensa que aparece.

   1. Em **Esquema**, escolha a caixa suspensa e insira o nome do esquema a ser usado. Por exemplo, `aws.s3@ObjectDeleted`. Também é possível selecionar uma opção na lista suspensa que aparece.

   1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**  
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.  
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.

   1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON. 

   1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**. 

      O EventBridge exibe uma caixa de mensagem informando se seu evento de amostra corresponde ao padrão do evento.

      Também é possível escolher uma das seguintes opções:
      + **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
      + **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.

------
#### [ Custom schema ]

   Para escrever um esquema personalizado e convertê-lo em um padrão de evento, faça o seguinte:

   1. Na seção **Método de criação**, em **Método**, escolha **Usar esquema**.

   1. Na seção **Padrão de evento**, em **Tipo de esquema**, escolha **Inserir esquema**.

   1. Insira o seu esquema na caixa de texto. É preciso formatar o esquema como texto JSON válido.

   1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**  
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.  
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.

   1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON. 

   1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**. 

      O EventBridge exibe uma caixa de mensagem informando se seu evento de amostra corresponde ao padrão do evento.

      Também é possível escolher uma das seguintes opções:
      + **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
      + **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.

------
#### [ Event pattern ]

   Para escrever um padrão de evento personalizado no formato JSON, faça o seguinte:

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

   1. Em **Padrão de evento**, insira seu padrão de evento personalizado em texto formatado em JSON. 

   1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**. 

      O EventBridge exibe uma caixa de mensagem informando se seu evento de amostra corresponde ao padrão do evento.

      Também é possível escolher uma das seguintes opções:
      + **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
      + **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
      + **Formulário de padrão de evento**: abre o padrão de evento no Criador de padrões. Se o padrão não puder ser renderizado no Criador do Padrão no estado em que se encontra, o EventBridge avisará antes de abrir o Criador do Padrão.

------

1. Escolha **Criar arquivo**.

Para confirmar se os eventos foram enviados com êxito para o arquivamento, você pode usar a operação [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) da API do EventBridge para ver se a `EventCount` reflete o número de eventos no arquivamento. Se for 0, não há eventos no arquivo.