아마존 EventBridge 타겟 - 아마존 EventBridge
EventBridge 콘솔에서 대상을 사용할 수 있습니다.대상 파라미터권한EventBridge 대상 세부 사항

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

아마존 EventBridge 타겟

대상은 이벤트가 규칙에 정의된 이벤트 패턴과 일치할 때 이벤트를 EventBridge 보내는 리소스 또는 엔드포인트입니다. 규칙은 이벤트 데이터를 처리하고 관련 정보를 대상으로 보냅니다. 이벤트 데이터를 대상에 전달하려면 대상 리소스에 액세스할 수 있는 권한이 EventBridge 필요합니다. 각 규칙에 대해 최대 5개의 대상을 정의할 수 있습니다.

규칙에 대상을 추가하고 해당 규칙이 바로 실행되는 경우 새 대상이나 업데이트된 대상이 즉시 간접 호출되지 않을 수 있습니다. 변경 사항이 적용될 때까지 잠시 기다리십시오.

다음 동영상에서는 대상의 기본 사항을 다룹니다.

EventBridge 콘솔에서 대상을 사용할 수 있습니다.

EventBridge 콘솔에서 다음과 같은 이벤트 대상을 구성할 수 있습니다.

대상 파라미터

일부 대상은 이벤트 페이로드의 정보를 대상으로 보내지 않고 대신 이벤트를 특정 API를 호출하는 트리거로 취급합니다. EventBridge Target 매개변수를 사용하여 해당 대상에 어떤 일이 발생하는지 결정합니다. 여기에는 다음이 포함됩니다.

  • API 대상(API 대상으로 전송되는 데이터는 API의 구조와 일치해야 합니다. InputTransformer 객체를 사용하여 데이터가 올바르게 구조화되었는지 확인해야 합니다. 원본 이벤트 페이로드를 포함하려면 InputTransformer에서 해당 페이로드를 참조하세요.)

  • API Gateway(API Gateway로 전송되는 데이터는 API의 구조와 일치해야 합니다. InputTransformer 객체를 사용하여 데이터가 올바르게 구조화되었는지 확인해야 합니다. 원본 이벤트 페이로드를 포함하려면 InputTransformer에서 해당 페이로드를 참조하세요.)

  • Amazon EC2 Image Builder

  • RedshiftDataParameters(Amazon Redshift Data API 클러스터)

  • SageMakerPipelineParameters(Amazon SageMaker 런타임 모델 구축 파이프라인)

참고

EventBridge 모든 JSON Path 구문을 지원하지는 않으며 런타임에 이를 평가합니다. 지원되는 구문은 다음과 같습니다.

  • 점 표기법(예: $.detail)

  • 대시

  • 밑줄

  • 영숫자

  • 배열 인덱스

  • 와일드카드(*)

동적 경로 파라미터

일부 대상 파라미터는 선택적인 동적 JSON 경로 구문을 지원합니다. 이 구문을 사용하면 정적 값 대신 JSON 경로를 지정할 수 있습니다(예: $.detail.state). 전체 값은 일부가 아닌 JSON 경로여야 합니다. 예를 들어 RedshiftParameters.Sql은 $.detail.state일 수 있지만 "SELECT * FROM $.detail.state"일 수는 없습니다. 이러한 경로는 런타임 시 지정된 경로에 있는 이벤트 페이로드 자체의 데이터로 동적으로 대체됩니다. 동적 경로 파라미터는 입력 변환으로 생성된 새 값이나 변환된 값을 참조할 수 없습니다. 동적 파라미터 JSON 경로에 지원되는 구문은 입력을 변환할 때와 동일합니다. 자세한 내용은 아마존 EventBridge 인풋 트랜스포메이션 섹션을 참조하세요.

다음 파라미터의 열거형이 아닌 모든 문자열 필드에 동적 구문을 사용할 수 있습니다.

권한

소유한 리소스에서 API를 호출하려면 적절한 권한이 EventBridge 필요합니다. AWS Lambda 및 Amazon SNS 리소스의 경우, 리소스 기반 정책을 EventBridge 사용합니다. EC2 인스턴스, Kinesis 데이터 스트림 및 Step Functions 상태 머신의 EventBridge 경우 파라미터에 지정한 IAM 역할을 사용합니다. RoleARN PutTargets 구성된 IAM 권한 부여로 API Gateway 엔드포인트를 간접 호출할 수 있지만 권한 부여를 구성하지 않은 경우 역할은 선택 사항입니다. 자세한 정보는 아마존 EventBridge 및 AWS Identity and Access Management을 참조하세요.

다른 계정이 동일한 리전에 있고 권한을 부여한 경우 해당 계정으로 이벤트를 보낼 수 있습니다. 자세한 정보는 AWS 계정 간 Amazon EventBridge 이벤트 전송 및 수신을 참조하세요.

대상이 암호화된 경우 KMS 키 정책에 다음 섹션을 포함해야 합니다.

{
    "Sid": "Allow EventBridge to use the key",
    "Effect": "Allow",
    "Principal": {
        "Service": "events.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*"
}

EventBridge 대상 세부 사항

AWS Batch 작업 대기열

를 통해 특정 매개변수를 구성할 AWS Batch submitJob 수 있습니다. BatchParameters

이벤트 페이로드에서 기타 항목을 지정할 수 있습니다. 이벤트 페이로드 (통과 또는 통과 InputTransformers) 에 다음 키가 포함된 경우 해당 키는 submitJob 요청 파라미터에 매핑됩니다.

  • ContainerOverrides: containerOverrides

    참고

    여기에는 명령, 환경, 메모리 및 vcpu만 포함됩니다.

  • DependsOn: dependsOn

    참고

    여기에는 jobId만 포함됩니다.

  • Parameters: parameters

CloudWatch 로그 그룹

CloudWatch Logs InputTransformer대상과 함께 사용하지 않는 경우 이벤트 페이로드가 로그 메시지로 사용되고 이벤트 소스가 타임스탬프로 사용됩니다. 를 사용하는 경우 템플릿은 InputTransformer 다음과 같아야 합니다.

{"timestamp":<timestamp>,"message":<message>}

EventBridge 로그 스트림으로 전송된 항목을 일괄 처리하므로 트래픽에 따라 로그 스트림에 단일 또는 여러 이벤트를 전달할 EventBridge 수 있습니다.

CodeBuild 프로젝트

를 사용하여 InputTransformers입력 이벤트를 Target에 맞게 CodeBuild StartBuildRequest구성하면 매개변수가 일대일로 매핑되어 전달됩니다. codeBuild.StartBuild

Amazon ECS 태스크

를 사용하여 InputTransformersAmazon ECS RunTask TaskOverride구조와 일치하도록 Target에 대한 입력 이벤트를 구성하면 파라미터가 일대일로 매핑되어 전달됩니다. ecs.RunTask

Incident Manager 대응 계획

일치하는 이벤트가 경보에서 CloudWatch 발생한 경우 경보 상태 변경 세부 정보가 인시던트 관리자 호출의 트리거 세부 정보에 채워집니다. StartIncidentRequest