Integração com aplicativos AWS Clean Rooms orientados a eventos usando a Amazon EventBridge

Você pode AWS Clean Rooms incorporar aplicativos orientados a eventos (EDAs) que usam eventos que ocorrem AWS Clean Rooms para se comunicar entre os componentes do aplicativo e iniciar processos posteriores. Você faz isso usando EventBridge a Amazon para rotear eventos de AWS Clean Rooms outros componentes de software. EventBridge A Amazon é um serviço sem servidor que usa eventos para conectar componentes do aplicativo, facilitando a integração de AWS serviços, como AWS Clean Rooms em arquiteturas orientadas por eventos, sem código e operações adicionais.

A arquitetura orientada a eventos é um estilo de criação de sistemas de software com acoplamento fraco que funcionam juntos emitindo e respondendo a eventos. Nesse modelo, um evento representa uma mudança em um recurso ou ambiente.

Veja como EventBridge funciona com AWS Clean Rooms:

Como acontece com muitos AWS serviços, AWS Clean Rooms gera e envia eventos para o barramento de eventos EventBridge padrão. Um barramento de eventos é um roteador que recebe eventos e os encaminha para os destinos, ou alvos, que você especificar. Os destinos podem incluir outros AWS serviços, aplicativos personalizados e aplicativos SaaS de parceiros.

EventBridge roteia os eventos de acordo com as regras que você cria no ônibus do evento. Para cada regra, você especifica um filtro ou padrão de evento para selecionar somente os eventos desejados. Sempre que um evento é enviado para o barramento de eventos, EventBridge compare-o com cada regra. Se o evento corresponder à regra, EventBridge roteará o evento para o (s) destino (s) especificado (s).

Por exemplo, suponha que você queira saber sempre que uma nova AWS Clean Rooms colaboração for criada em sua conta. Você pode criar uma regra no barramento de eventos padrão. Na regra, você criaria um padrão de evento que especificasse eventos do AWS Clean Rooms chamadosCollaboration Created. Toda vez que EventBridge recebia um evento correspondente a essas propriedades, ele roteava o evento para o fluxo de trabalho especificado.

AWS Clean Rooms eventos

AWS os serviços podem enviar eventos diretamente para o barramento de eventos EventBridge padrão. Além disso, também AWS CloudTrail envia eventos provenientes de vários AWS serviços. EventBridge Esses eventos podem incluir chamadas de API, logins e ações do console, eventos de serviço e CloudTrail Insights. Para obter mais informações, consulte os eventos de AWS serviço fornecidos AWS CloudTrail no Guia EventBridge do usuário.

Para obter uma lista completa dos AWS Clean Rooms eventos enviados EventBridge, consulte o AWS Clean Rooms tópico na Referência de EventBridge eventos.

Tipo de detalhe de evento	Descrição
Colaboração criada	Colaboração criada
Colaboração atualizada	Colaboração atualizada
Associação criada	Associação criada
Adesão atualizada	Associação atualizada
Associação excluída	Associação excluída
Consulta protegida enviada	Consulta protegida enviada
Consulta protegida bem-sucedida	Consulta protegida bem-sucedida
Falha na consulta protegida	Falha na consulta protegida
O tempo limite da consulta protegida atingiu o tempo limite	O tempo limite da consulta protegida atingiu o tempo limite
Protected Job enviado	Protected Job enviado
Protected Job foi bem-sucedido	Protected Job foi bem-sucedido
Falha no trabalho protegido	Falha no trabalho protegido
Protected Job cancelado	Protected Job cancelado

AWS Clean Rooms Eventos de roteamento usando EventBridge

Para EventBridge rotear AWS Clean Rooms eventos para um destino, você deve criar uma regra. Cada regra contém um padrão de evento, que EventBridge corresponde a cada evento recebido no barramento de eventos. Se os dados do evento corresponderem ao padrão de evento especificado, EventBridge roteará esse evento para o (s) destino (s) da regra.

Para obter instruções abrangentes de como criar regras de barramento de eventos, consulte Criar regras que reagem a eventos no Guia do usuário do EventBridge .

Criação de padrões de eventos que correspondam aos AWS Clean Rooms eventos

Cada padrão de evento é um objeto JSON que contém:

• (Opcional): um source atributo que identifica o serviço que envia o evento. Para AWS Clean Rooms eventos, a fonte éaws.cleanrooms.

• (Opcional): um detail-type atributo que contém uma matriz dos nomes de eventos correspondentes.

• (Opcional): um atributo detail que contém quaisquer outros dados relacionados aos eventos a serem correlacionados.

Por exemplo, o padrão de eventos a seguir corresponde a todos os eventos do Membership Updated dos quais a colaboração foi excluída AWS Clean Rooms:

{
  "source": ["aws.cleanrooms"],
  "detail-type": ["Membership Updated"],
  "detail": {
    "status": ["COLLABORATION_DELETED"]
  }
}

Para obter mais informações sobre como escrever padrões de eventos, consulte Padrões de eventos no Guia do usuário do EventBridge .