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á. # O que é o EventBridge Custom Event Bus? O EventBridge Custom Event Bus é um barramento de eventos sem servidor que uma equipe administra e muitas equipes e contas usam. Você publica eventos nele com `PutEvents` ou`PutRawEvents`. Ele encaminha cada evento para os assinantes cujos filtros correspondem e mantém uma cópia de cada evento por um período de retenção definido no ônibus. Você compartilha o ônibus com outras contas por meio de AWS Resource Access Manager (AWS RAM), e cada uma dessas contas vincula seus próprios assinantes. O proprietário do ônibus não escreve nenhuma rota em seu nome. No EventBridge console, o tipo de ônibus é mostrado como ** Custom Event Bus ** para esse ônibus e ** Custom Event Bus - Classic ** para os ônibus que usam regras e metas. Para os nomes CLI, SDK e IAM, consulte. [Nomes, endpoints e permissões do IAM para o barramento de eventos personalizado](eb-custom-bus-names.md) ## Recursos principais + Cross-account compartilhando AWS RAM, com quatro permissões gerenciadas que permitem que uma conta de consumidor publique, assine, anexe fontes de eventos ou todas as três. + Retenção de cada evento por 1 a 365 dias, definido no ônibus. + Entrega solicitada (FIFO) dentro de um grupo de eventos, por assinante. + Uma posição inicial para cada assinante, para que um novo assinante possa ler os eventos retidos e um assinante pausado possa continuar sem perdas. + Desduplicação no momento da publicação, por conteúdo ou por uma chave fornecida por você, em uma janela de 5 minutos. + `PutRawEvents`para JSON, Avro, Protobuf ou bytes brutos, com desserialização do registro do esquema para filtragem. + Metas universais que acionam diretamente qualquer ação de AWS API que mude o estado, junto com as metas personalizadas. ## Recursos Você trabalha com três recursos. Barramento de eventos O ônibus de eventos recebe os eventos com os quais você publica `PutEvents` ou`PutRawEvents`, os encaminha para os assinantes e os retém. Você define o período de retenção, uma AWS KMS chave opcional e o compartilhamento opcional entre contas no ônibus. Para os estados pelos quais um ônibus passa, consulte[Estados dos ônibus e o que cada um permite](eb-custom-bus-create.md#eb-custom-bus-lifecycle-states). Assinante Um assinante nomeia os eventos que você deseja, com filtros, e o único alvo que os recebe. Você o cria com`CreateSubscriber`. Ele observa um ônibus, guarda os eventos que correspondem aos seus filtros, transforma opcionalmente cada um deles e o entrega exatamente a um alvo. Para enviar um evento para vários destinos, crie um assinante para cada alvo. Origem do evento. Uma fonte de eventos ingere eventos em um barramento de um AWS serviço ou de um parceiro de software como serviço (SaaS). Você o cria com`CreateEventSource`, nomeando o ônibus de origem e o de destino e EventBridge move os eventos para você. Os nomes de recursos da Amazon (ARNs) do ônibus e do assinante terminam em um identificador que EventBridge gera, por exemplo. `arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef` Armazene o ARN completo em vez do nome. Se você excluir um barramento e criar outro com o mesmo nome, o novo barramento terá um identificador diferente. ## Um ônibus, muitas contas Para permitir que outra conta use seu ônibus, compartilhe-o AWS RAM e anexe uma das permissões gerenciadas, por exemplo, `AWSRAMEventBridgeEventBusV2SubscribeOnly` para permitir que essa conta vincule assinantes. A conta então cria e possui seus próprios assinantes em seu ônibus: ela vê apenas seus assinantes quando os lista e você vê todos eles. Uma conta de consumidor não pode alterar ou excluir o ônibus, e você pode retirar qualquer um de seus assinantes com`RevokeResource`. Para obter as permissões, políticas de recursos e revogação, consulte. [Compartilhando um Event Bus personalizado com outras contas](eb-custom-bus-sharing.md) ## Como o Custom Event Bus direciona e retém eventos O ônibus encaminha cada evento para combinar assinantes à medida que ele chega. O ônibus também retém o evento pelo número de dias que você configura. A retenção possibilita duas capacidades. + Um assinante pode começar de um ponto no passado. É assim que você reproduz eventos retidos e como um assinante que você cria hoje lê eventos que foram publicados ontem. + Um assinante pode pausar e retomar posteriormente sem perder eventos. Para obter mais informações, consulte [Escolhendo o período de retenção](eb-custom-bus-create.md#eb-custom-bus-create-retention) e [Reproduzir eventos retidos para um assinante](eb-custom-bus-replay.md). ## Como o Custom Event Bus difere do Custom Event Bus - Classic | Recurso | Ônibus de eventos personalizado | Ônibus de eventos personalizado - Clássico | | --- | --- | --- | | Cross-account usar | Compartilhe o ônibus com AWS RAM. Cada conta de consumidor cria e possui seus assinantes no ônibus. | Conceda outras contas por meio da política de recursos de ônibus ou encaminhe eventos para um ônibus na outra conta. | | Retenção | Embutido no ônibus, por um período definido por você. | Não retido. Para manter os eventos, adicione um arquivo. | | Ordem | Entrega de FIFO dentro de um grupo de eventos, por assinante. | Não disponível. | | Reproduzir | A posição inicial de um assinante sobre os eventos retidos. | Reproduzir a partir de um arquivo. | | APIs de publicação | PutEventspara JSON e PutRawEvents para qualquer formato, incluindo Avro e Protobuf. | PutEventspara JSON. | | Desduplicação | No momento da publicação, por conteúdo ou por uma chave fornecida por você. | Não disponível. | | Metas por recurso de roteamento | Um alvo por assinante. | Até cinco alvos por regra. | ## Casos de uso + Uma equipe da plataforma opera um `orders` ônibus e o compartilha com as contas das equipes de atendimento, cobrança e análise. Cada equipe atribui seus próprios assinantes; a equipe da plataforma nunca edita o roteamento para eles. + Um serviço de pagamentos publica com um número `EventGroupId` por conta e um assinante FIFO entrega os eventos de cada conta em uma fila em ordem. + Um novo consumidor de análise é criado com uma posição inicial há 30 dias e lê um mês de eventos retidos antes de acessar o tráfego ao vivo. ## Preços Você paga pelos eventos que publica, pelas entregas aos assinantes e pela retenção. Para as tarifas, consulte os EventBridge preços [ da Amazon](https://aws.amazon.com/eventbridge/pricing/). ## Próximas etapas + Saiba quais nomes usar na CLI, nos SDKs e no IAM:. [Nomes, endpoints e permissões do IAM para o barramento de eventos personalizado](eb-custom-bus-names.md) + Publique seus primeiros eventos:[Publicação de eventos em um ônibus de eventos personalizado](eb-custom-bus-publish.md). + Crie um assinante que os entregue:[Inscrever-se em eventos em um ônibus de eventos personalizado](eb-custom-bus-subscribers.md).