이벤트 구조 참조

다음 필드는 이벤트 버스로 전달되는 모든 이벤트에 나타나며 이벤트의 메타데이터를 구성합니다.

{
  "version": "0",
  "id": "UUID",
  "detail-type": "event name",
  "소스": "event source",
  "account": "ARN",
  "시간": "timestamp",
  "region": "region",
  "resources": [
    "ARN"
  ],
  "detail": {
    JSON object
  }
}

version

기본적으로 이 필드는 모든 이벤트에서 0으로 설정되어 있습니다.

id

모든 이벤트에 대해 생성되는 버전 4 UUID입니다. id를 사용하여 규칙을 통해 대상으로 이동하는 이벤트를 추적할 수 있습니다.

detail-type

source 필드를 함께 사용하여 detail 필드에 나타나는 필드와 값을 식별합니다.

에서 CloudTrail 전달한 이벤트는 의 AWS API Call via CloudTrail 값으로 사용됩니다. detail-type

소스

이벤트를 생성한 서비스를 식별합니다. AWS 서비스에서 발생하는 모든 이벤트는 ‘aws’로 시작합니다. 고객이 생성한 이벤트는 "aws"로 시작되지 않는 한 어떤 값이라도 가질 수 있습니다. Java 패키지 이름 스타일을 사용하여 도메인 이름 문자열을 역순으로 만드는 것이 좋습니다.

AWS 서비스의 올바른 값을 source 찾으려면 조건 키 테이블을 참조하고 목록에서 서비스를 선택한 다음 서비스 접두사를 찾으십시오. 예를 들어, Amazon의 source 가치는 CloudFront 다음과 같습니다aws.cloudfront.

account

AWS 계정을 식별하는 12자리 숫자.

시간

이벤트를 호출한 서비스에서 지정할 수 있는 이벤트 타임스탬프입니다. 이벤트가 시간 간격 내에 있으면 서비스는 시작 시간을 보고해서 이 값이 이벤트가 수신되는 시간보다 앞에 있도록 할 수 있습니다.

region

이벤트가 시작된 AWS 지역을 식별합니다.

resources

이벤트에서 간접 호출된 리소스를 식별하는 ARN이 포함된 JSON 배열입니다. 이벤트를 생성하는 서비스에 따라 이러한 ARN을 포함할지 여부가 결정됩니다. 예를 들어 Amazon EC2 인스턴스 상태 변경에는 Amazon EC2 인스턴스 ARN이 포함되어 있고, Auto Scaling 이벤트에는 인스턴스 및 Auto Scaling 그룹 모두에 대한 ARN이 포함되어 있지만, AWS CloudTrail 에서의 API 직접 호출에는 리소스 ARN이 포함되지 않습니다.

detail

이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다. "{}"이(가) 될 수 있습니다.

AWS API 호출 이벤트에는 여러 수준 깊이로 중첩된 약 50개의 필드가 있는 세부 객체가 있습니다.

참고

PutEventsJSON 형식의 데이터를 받아들입니다. JSON 숫자(정수) 데이터 유형의 경우 제약 조건은 최솟값 -9,223,372,036,854,775,808 및 최댓값 9,223,372,036,854,775,807입니다.

예: Amazon EC2 인스턴스 상태 변경 알림

Amazon에서 발생한 다음 이벤트는 Amazon EC2 인스턴스가 EventBridge 종료되었음을 나타냅니다.

{
  "version": "0",
  "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
  "detail-type": "EC2 Instance State-change Notification",
  "source": "aws.ec2",
  "account": "111122223333",
  "time": "2017-12-22T18:43:48Z",
  "region": "us-west-1",
  "resources": [
    "arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0"
  ],
  "detail": {
    "instance-id": " i-1234567890abcdef0",
    "state": "terminated"
  }
}

유효한 사용자 지정 이벤트에 필요한 최소 정보

사용자 지정 이벤트를 생성할 때는 다음 필드를 포함해야 합니다.

• detail

• detail-type

• source

{
  "detail-type": "event name",
  "source": "event source",
  "detail": {
  }
}