Criação de arquivamentos de eventos no Amazon EventBridge - Amazon EventBridge
Definir o arquivoCriar o padrão de eventos (opcional)

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

Ao criar um arquivamento no EventBridge, você pode determinar quais eventos são enviados para o arquivo especificando um padrão de evento. 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. Esses arquivamentos têm uma política de retenção indefinida e nenhum filtro de eventos, embora isso possa ser atualizado assim que o arquivamento é criado.

Definir o arquivo

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

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

  3. Escolha Criar arquivo.

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

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

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

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

  8. Escolha Próximo.

Criar o padrão de eventos (opcional)

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 .

Para criar o padrão de eventos

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

  2. (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.

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

      3. Selecione Copiar.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    6. (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).

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

    3. (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.

  4. Escolha Criar arquivo.

Para confirmar se os eventos foram enviados com êxito para o arquivamento, você pode usar a operação DescribeArchive 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.