규칙 생성 과정으로 입력 변환기 구성 - 아마존 EventBridge

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

규칙 생성 과정으로 입력 변환기 구성

규칙을 만드는 과정에서 지정된 대상으로 이벤트를 보내기 전에 일치하는 이벤트를 처리하는 EventBridge 데 사용할 입력 변환기를 지정할 수 있습니다. AWS 서비스 또는 API 대상인 대상에 대해 입력 변환기를 구성할 수 있습니다.

규칙의 일부로 대상 입력 변환기를 생성하려면
  1. 이벤트에 반응하는 Amazon EventBridge 규칙 생성에 설명된 대로 규칙을 생성하는 단계를 따르세요.

  2. 3단계 - 대상 선택에서 추가 설정을 확장합니다.

  3. 대상 입력 구성의 경우 드롭다운에서 입력 변환기를 선택합니다.

    입력 변환기 구성을 클릭합니다.

    EventBridge 입력 변환기 구성 대화 상자를 표시합니다.

  4. 샘플 이벤트 섹션에서 이벤트 패턴을 테스트할 샘플 이벤트 유형을 선택합니다. AWS 이벤트 또는 파트너 이벤트를 선택하거나 사용자 지정 이벤트를 입력할 수 있습니다.

    AWS events

    지원되는 AWS 서비스에서 발생한 이벤트 중에서 선택합니다.

    1. AWS 이벤트를 선택합니다.

    2. 샘플 이벤트에서 원하는 AWS 이벤트를 선택합니다. 이벤트는 AWS 서비스별로 구성됩니다.

      이벤트를 선택하면 샘플 이벤트가 EventBridge 채워집니다.

      예를 들어, S3 객체 생성을 선택하면 샘플 S3 객체 생성 이벤트가 EventBridge 표시됩니다.

    3. (선택 사항) 복사를 선택하여 샘플 이벤트를 디바이스의 클립보드에 복사할 수도 있습니다.

    Partner events

    지원하는 타사 서비스 (예: Salesforce) 에서 EventBridge 생성된 이벤트 중에서 선택하십시오.

    1. 파트너 이벤트를 선택하세요EventBridge .

    2. 샘플 이벤트에서 원하는 파트너 이벤트를 선택합니다. 이벤트는 파트너별로 구성됩니다.

      이벤트를 선택하면 샘플 이벤트가 EventBridge 채워집니다.

    3. (선택 사항) 복사를 선택하여 샘플 이벤트를 디바이스의 클립보드에 복사할 수도 있습니다.

    Enter your own

    JSON 텍스트로 자체 이벤트를 입력합니다.

    1. 직접 입력을 선택합니다.

    2. EventBridge 필수 이벤트 속성의 템플릿으로 샘플 이벤트를 채웁니다.

    3. 필요에 따라 샘플 이벤트를 편집하고 추가합니다. 샘플 이벤트는 유효한 JSON이어야 합니다.

    4. (선택 사항) 다음 옵션 중 하나를 선택할 수도 있습니다.

      • 복사 - 샘플 이벤트를 디바이스의 클립보드에 복사합니다.

      • 정리 - 줄 바꿈, 탭, 공백을 추가하여 JSON 텍스트를 더 쉽게 읽을 수 있습니다.

  5. (선택 사항) 예시 입력 경로, 템플릿 및 출력 섹션을 확장하여 다음 예를 확인합니다.

    • JSON 경로를 사용하여 이벤트 데이터를 나타내는 변수를 정의하는 방법

    • 입력 변환기 템플릿에서 해당 변수를 사용하는 방법

    • 타겟으로 EventBridge 전송되는 결과 출력입니다.

    입력 변환의 자세한 예는 입력 변환 예제 섹션을 참조하세요.

  6. 대상 입력 변환기 섹션에서 입력 템플릿에 사용할 변수를 정의합니다.

    변수는 JSON 경로를 사용하여 원래 이벤트 소스의 값을 참조합니다. 그런 다음 입력 템플릿에서 해당 변수를 참조하여 대상으로 EventBridge 전달되는 변환된 이벤트에 원본 소스 이벤트의 데이터를 포함시킬 수 있습니다. 최대 100개의 변수를 정의할 수 있습니다. 입력 변환기는 유효한 JSON이어야 합니다.

    예를 들어 이 입력 변환기의 샘플 AWS 이벤트로 S3 Object Created 이벤트를 선택했다고 가정해 보겠습니다. 그러면 템플릿에서 사용할 다음 변수를 정의할 수 있습니다.

    { "requester": "$.detail.requester", "key": "$.detail.object.key", "bucket": "$.detail.bucket.name" }

    (선택 사항) 복사를 선택하여 입력 변환기를 디바이스의 클립보드에 복사할 수도 있습니다.

  7. 템플릿 섹션에서 대상으로 EventBridge 전달되는 내용을 결정하는 데 사용할 템플릿을 작성합니다.

    JSON, 문자열, 정적 정보, 정의한 변수 및 예약된 변수를 사용할 수 있습니다. 입력 변환의 자세한 예는 입력 변환 예제 섹션을 참조하세요.

    예를 들어 이전 예에서 변수를 정의했다고 가정하겠습니다. 그러면 해당 변수, 예약된 변수 및 정적 정보를 참조하는 다음 템플릿을 작성할 수 있습니다.

    { "message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"", "RuleName": <aws.events.rule-name>, "ruleArn" : <aws.events.rule-arn>, "Transformed": "Yes" }

    (선택 사항) 복사를 선택하여 템플릿을 디바이스의 클립보드에 복사할 수도 있습니다.

  8. 템플릿을 테스트하려면 출력 생성을 선택합니다.

    EventBridge 입력 템플릿을 기반으로 샘플 이벤트를 처리하고 출력에서 생성된 변환된 출력을 표시합니다. 이 정보는 원래 소스 이벤트 대신 대상에 EventBridge 전달될 정보입니다.

    위에서 설명한 예시 입력 템플릿에 대해 생성된 출력은 다음과 같습니다.

    { "message": "123456789012 has created the object "example-key" in the bucket "example-bucket"", "RuleName": rule-name, "ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name, "Transformed": "Yes" }

    (선택 사항) 복사를 선택하여 생성된 출력을 디바이스의 클립보드에 복사할 수도 있습니다.

  9. 확인을 선택합니다.

  10. 이벤트에 반응하는 Amazon EventBridge 규칙 생성에 설명된 대로 규칙을 생성하는 나머지 단계를 따르세요.