API목적지로 CloudEvents 이벤트 전송 - Amazon EventBridge

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

API목적지로 CloudEvents 이벤트 전송

CloudEvents 서비스, 플랫폼 및 시스템 전반의 상호 운용성을 제공하는 것을 목표로 하는 벤더 중립적인 이벤트 형식 지정 사양입니다. 를 EventBridge 사용하여 AWS 서비스 이벤트를 대상 (예: 대상) 으로 CloudEvents 전송되기 전으로 변환할 수 있습니다. API

참고

다음 절차는 소스 이벤트를 구조적 CloudEvents 모드로 변환하는 방법을 설명합니다. CloudEvents 사양에서 구조적 모드 메시지는 전체 이벤트 (속성 및 데이터) 가 이벤트의 페이로드에 인코딩되는 메시지입니다.

사양에 대한 자세한 내용은 cloudevents.io를 CloudEvents 참조하십시오.

콘솔을 사용하여 AWS 이벤트를 해당 형식으로 변환하려면 CloudEvents

이벤트를 대상에 전달하기 전에 CloudEvents 형식으로 변환하려면 먼저 이벤트 버스 규칙을 만들어야 합니다. 규칙 정의의 일환으로 입력 변환기를 사용하여 지정한 대상으로 보내기 전에 EventBridge 변환 이벤트를 생성하십시오.

  1. Amazon의 이벤트에 반응하는 규칙 생성 EventBridge 절차에서 해당 단계를 따릅니다.

  2. 대상 선택 단계에서 대상을 대상으로 선택하라는 메시지가 표시되면 다음을 입력합니다. API

    1. EventBridge API목적지를 선택합니다.

    2. 다음 중 하나를 수행합니다.

      • 기존 API 목적지 사용을 선택하고 기존 API 목적지를 선택합니다.

      • 새 API 목적지 생성을 선택하고 새 목적지를 정의하는 데 필요한 설정을 지정합니다. API

        필수 설정 지정에 대한 자세한 내용은 을 참조하십시오아마존에서 API 목적지 만들기 EventBridge.

    3. 이벤트에 필요한 Content-Type 헤더 파라미터를 지정하십시오. CloudEvents

      • 헤더 파라미터에서 헤더 파라미터 추가를 선택합니다.

      • 키에 대해 지정합니다Content-Type.

        값으로 지정하십시오application/cloudevents+json; charset=UTF-8.

  3. 대상의 실행 역할을 지정하십시오.

  4. 소스 이벤트 데이터를 다음과 같은 CloudEvents 형식으로 변환하는 입력 변환기를 정의합니다.

    1. 추가 설정에서 대상 입력 구성에서 입력 변환기를 선택합니다.

      그런 다음 입력 변압기 구성을 선택합니다.

    2. 대상 입력 트랜스포머에서 입력 경로를 지정합니다.

      아래 입력 경로에서 region 속성은 해당 CloudEvents 형식의 사용자 지정 확장 속성입니다. 따라서 CloudEvents 사양을 준수하는 데 반드시 필요한 것은 아닙니다.

      CloudEvents 핵심 사양에 정의되지 않은 확장 속성을 사용하고 생성할 수 있습니다. 알려진 확장 속성 목록을 비롯한 자세한 내용은 에 대한 CloudEvents 사양 설명서의 CloudEvents 확장 속성을 참조하십시오 GitHub.

      { "detail": "$.detail", "detail-type": "$.detail-type", "id": "$.id", "region": "$.region", "source": "$.source", "time": "$.time" }
    3. 템플릿의 경우 템플릿을 입력하여 소스 이벤트 데이터를 해당 CloudEvents 형식으로 변환합니다.

      아래 템플릿에서는 입력 경로의 region 속성이 CloudEvents 사양의 확장 속성이므로 반드시 필요한 region 것은 아닙니다.

      { "specversion":"1.0", "id":<id>, "source":<source>, "type":<detail-type>, "time":<time>, "region":<region>, "data":<detail> }
  5. 절차 단계에 따라 규칙 생성을 완료하십시오.