Envio de CloudEvents eventos para destinos de API

CloudEvents é uma especificação independente de fornecedor para formatação de eventos, com o objetivo de fornecer interoperabilidade entre serviços, plataformas e sistemas. Você pode usar EventBridge para transformar eventos de AWS serviço CloudEvents antes de serem enviados para um destino, como um destino de API.

nota

O procedimento a seguir explica como transformar eventos de origem em modo CloudEventsestruturado. Na CloudEvents especificação, uma mensagem de modo estruturado é aquela em que todo o evento (atributos e dados) é codificado na carga útil do evento.

Para obter mais informações sobre a CloudEvents especificação, consulte cloudevents.io.

Para transformar AWS eventos no CloudEvents formato usando o console

Para transformar eventos no CloudEvents formato antes da entrega a um destino, você começa criando uma regra de barramento de eventos. Como parte da definição da regra, você usa um transformador de entrada para ter eventos de EventBridge transformação antes de enviar para o destino especificado.

1. Siga as etapas no procedimento Como criar regras do Amazon EventBridge que reagem a eventos.

2. Na Selecione destinos etapa, quando solicitado a escolher um destino de API como tipo de destino:

   1. Selecione o destino EventBridge da API.

   2. Execute um destes procedimentos:

      • Escolha Usar um destino de API existente e selecione um destino de API existente

      • Escolha Criar um novo destino de API e especifique a configuração necessária para definir seu novo destino de API.

        Para obter mais informações sobre como especificar as configurações necessárias, consulteCriar um destino de API.

   3. Especifique os parâmetros de cabeçalho Content-Type necessários para os CloudEvents eventos:

      • Em Parâmetros de cabeçalho, escolha Adicionar parâmetro de cabeçalho.

      • Para chave, especifiqueContent-Type.

        Para valor, especifiqueapplication/cloudevents+json; charset=UTF-8.

3. Especifique uma função de execução para seu alvo.

4. Defina um transformador de entrada para transformar os dados do evento de origem no CloudEvents formato:

   1. Em Configurações adicionais, para Configurar entrada de destino, escolha Transformador de entrada.

      Em seguida, escolha Configurar transformador de entrada.

   2. Em Transformador de entrada de destino, especifique o caminho de entrada.

      No caminho de entrada abaixo, o atributo region é um atributo de extensão personalizado do CloudEvents formato. Como tal, não é necessário para cumprir a CloudEvents especificação.

      CloudEvents permite usar e criar atributos de extensão não definidos na especificação principal. Para obter mais informações, incluindo uma lista de atributos de extensão conhecidos, consulte Atributos de CloudEvents extensão na documentação de CloudEvents especificação em GitHub.

      {
        "detail": "$.detail",
        "detail-type": "$.detail-type",
        "id": "$.id",
        "region": "$.region",
        "source": "$.source",
        "time": "$.time"
      }

   3. Em Modelo, insira o modelo para transformar os dados do evento de origem no CloudEvents formato.

      No modelo abaixo, não region é estritamente obrigatório, pois o region atributo no caminho de entrada é um atributo de extensão da CloudEvents especificação.

      {
        "specversion":"1.0",
        "id":<id>,
        "source":<source>,
        "type":<detail-type>,
        "time":<time>,
        "region":<region>,
        "data":<detail>
      }

5. Conclua a criação da regra seguindo as etapas do procedimento.