EventBridge 이벤트 메시지 구조

이벤트를 게시하기 위해 Amazon S3이 전송하는 알림 메시지는 JSON 형식입니다. Amazon S3가 이벤트를 Amazon EventBridge로 전송하는 경우 때 다음 필드가 있습니다.

version – 현재 모든 이벤트에 대해 0(영)입니다.
id – 모든 이벤트에 대해 생성되는 UUID입니다.
detail-type – 전송 중인 이벤트의 유형입니다. 이벤트 유형 목록은 EventBridge 사용 섹션을 참조하십시오.
source – 이벤트를 생성한 서비스를 식별합니다.
account – 버킷 소유자의 12자리 AWS 계정 ID입니다.
time - 이벤트가 발생한 시간입니다.
region – 버킷의 AWS 리전을 식별합니다.
resources – 버킷의 Amazon 리소스 이름(ARN)을 포함하는 JSON 배열입니다.
detail – 이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이 필드에 포함될 수 있는 항목에 대한 자세한 내용은 이벤트 메시지 세부 정보 필드 섹션을 참조하십시오.

이벤트 메시지 구조 예제

다음은 Amazon EventBridge로 전송할 수 있는 일부 Amazon S3 이벤트 알림 메시지의 예입니다.

객체 생성됨(Object created)


{
  "version": "0",
  "id": "17793124-05d4-b198-2fde-7ededc63b103",
  "detail-type": "Object Created",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2021-11-12T00:00:00Z",
  "region": "ca-central-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "1.0",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "size": 5,
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
      "sequencer": "617f08299329d189"
    },
    "request-id": "N4N7GDK58NMKJ12R",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "PutObject"
  }
}

객체 삭제됨(DeleteObject)(Object deleted (using DeleteObject))


{
  "version": "0",
  "id": "2ee9cc15-d022-99ea-1fb8-1b1bac4850f9",
  "detail-type": "Object Deleted",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2021-11-12T00:00:00Z",
  "region": "ca-central-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "1.0",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "d41d8cd98f00b204e9800998ecf8427e",
      "version-id": "1QW9g1Z99LUNbvaaYVpW9xDlOLU.qxgF",
      "sequencer": "617f0837b476e463"
    },
    "request-id": "0BH729840619AG5K",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "DeleteObject",
    "deletion-type": "Delete Marker Created"
  }
}

객체 삭제됨(수명 주기 만료)(Object deleted (using lifecycle expiration))


{
  "version": "0",
  "id": "ad1de317-e409-eba2-9552-30113f8d88e3",
  "detail-type": "Object Deleted",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2021-11-12T00:00:00Z",
  "region": "ca-central-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "1.0",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "d41d8cd98f00b204e9800998ecf8427e",
      "version-id": "mtB0cV.jejK63XkRNceanNMC.qXPWLeK",
      "sequencer": "617b398000000000"
    },
    "request-id": "20EB74C14654DC47",
    "requester": "s3.amazonaws.com",
    "reason": "Lifecycle Expiration",
    "deletion-type": "Delete Marker Created"
  }
}

객체 복원 완료됨(Object restore completed)


{
  "version": "0",
  "id": "6924de0d-13e2-6bbf-c0c1-b903b753565e",
  "detail-type": "Object Restore Completed",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2021-11-12T00:00:00Z",
  "region": "ca-central-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "1.0",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "size": 5,
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "KKsjUC1.6gIjqtvhfg5AdMI0eCePIiT3"
    },
    "request-id": "189F19CB7FB1B6A4",
    "requester": "s3.amazonaws.com",
    "restore-expiry-time": "2021-11-13T00:00:00Z",
    "source-storage-class": "GLACIER"
  }
}

객체 주석 생성됨


{
  "version": "0",
  "id": "8c2bfa57-4a67-b2ea-c4e0-6d420ea3b3a6",
  "detail-type": "Object Annotation Created",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2025-03-15T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "2.4",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
      "sequencer": "617f08299329d189"
    },
    "request-id": "4B4NGD358NMKJ12R",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "PutObjectAnnotation",
    "object-annotation": {
      "name": "my-annotation",
      "size": 24,
      "etag": "05df351ea190dffc26f55c74425b9d7a"
    }
  }
}

객체 주석 제거됨


{
  "version": "0",
  "id": "a3d1bc94-5f82-c7e1-d290-7e531fb4c5b8",
  "detail-type": "Object Annotation Removed",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2025-03-15T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "2.4",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
      "sequencer": "617f08299329d190"
    },
    "request-id": "7C5NGD358NMKJ34S",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "DeleteObjectAnnotation",
    "object-annotation": {
      "name": "my-annotation"
    }
  }
}

이벤트 메시지 세부 정보 필드

세부 정보 필드에는 이벤트에 대한 정보가 포함된 JSON 객체가 있습니다. 세부 정보 필드에 다음 필드가 있을 수 있습니다.

version – 현재 모든 이벤트에 대해 0(영)입니다.
event-version - major.minor 형식의 이벤트 스키마 버전입니다(예: 1.0).

Amazon S3가 이전 버전과 호환되지 않는 이벤트 구조를 변경하는 경우 주 버전이 증가합니다. 여기에는 이미 존재하는 JSON 필드를 제거하거나 필드의 콘텐츠가 표시되는 방식(예: 날짜 형식)을 변경하는 것이 포함됩니다.

Amazon S3가 이벤트 구조에 대해 하위 호환성을 유지하는 변경 사항을 적용하는 경우 마이너 버전이 증가합니다. 여기에는 이벤트 구조에 새 필드를 추가하거나 새 이벤트 유형을 도입하는 것이 포함됩니다. 이벤트 구조의 새로운 마이너 버전과 호환성을 유지하려면 애플리케이션에서 새 필드를 무시하는 것이 좋습니다.

애플리케이션이 이벤트 구조의 구문을 올바로 분석할 수 있도록 메이저 버전 번호에 대해 같은 값인지 비교하는 것이 좋습니다. 애플리케이션이 예상하는 필드가 반드시 존재할 수 있도록 마이너 버전에 대해 크거나 같은 값인지 비교하는 것이 좋습니다.
bucket – 이벤트와 관련된 Amazon S3 버킷에 대한 정보입니다.
object – 이벤트와 관련된 Amazon S3 객체에 대한 정보입니다.
request-id – S3 응답의 요청 ID입니다.
requester – 요청자의 AWS 계정 ID 또는 AWS 서비스 보안 주체입니다.
source-ip-address – S3 요청의 소스 IP 주소입니다. S3 요청에 의해 트리거된 이벤트의 경우에만 있습니다.
reason – 객체 생성됨 이벤트의 경우 객체를 생성하는 데 사용된 S3 API입니다(예: PutObject, POST Object, CopyObject 또는 CompleteMultipartUpload). 객체 삭제됨 이벤트의 경우 객체가 S3 API 직접 호출에 의해 삭제되면 DeleteObject로 설정되고, S3 수명 주기 만료 규칙에 의해 객체가 삭제되면 수명 주기 만료로 설정됩니다. 자세한 내용은 객체 만료 섹션을 참조하세요.
deletion-type – 객체 삭제됨 이벤트의 경우 버전이 지정되지 않은 객체가 삭제되거나 버전이 관리되는 객체가 영구적으로 삭제되면 영구 삭제됨으로 설정됩니다. 버전이 지정된 객체에 대해 삭제 마커가 생성되면 삭제 마커 생성됨(Delete Marker Created)으로 설정됩니다. 자세한 내용은 버전 관리가 사용 설정된 버킷에서 객체 버전 삭제 섹션을 참조하세요.

참고
일부 객체 속성(예: etag 및 size)은 삭제 마커가 생성된 경우에만 표시됩니다.
restore-expiry-time – 객체 복원 완료됨 이벤트의 경우 객체의 임시 복사본이 S3에서 삭제되는 시간입니다. 자세한 내용은 아카이브된 객체 작업 섹션을 참조하세요.
source-storage-class – 객체 복원 시작됨 및 객체 복원 완료됨 이벤트의 경우 복원 중인 객체의 스토리지 클래스입니다. 자세한 내용은 아카이브된 객체 작업 섹션을 참조하세요.
destination-storage-class – 객체 스토리지 클래스 변경됨 이벤트의 경우 객체의 새 스토리지 클래스입니다. 자세한 내용은 Amazon S3 수명 주기를 사용하여 객체 전환 섹션을 참조하세요.
destination-access-tier – 객체 액세스 계층 변경됨 이벤트의 경우 객체의 새 액세스 계층입니다. 자세한 내용은 Amazon S3 Intelligent-Tiering을 사용한 스토리지 비용 관리 섹션을 참조하세요.
object-annotation - 객체 주석 생성됨 및 객체 주석 제거됨 이벤트의 경우 detail 필드에는 주석에 대한 정보가 포함된 object-annotation 필드가 포함됩니다.
has-object-annotation - 이유가 CopyObject인 객체 생성됨 이벤트의 경우 object 블록에는 복사된 객체에 주석이 있는지 여부를 나타내는 has-object-annotation 부울 필드가 포함됩니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

EventBridge 사용 설정

Amazon EventBridge 매핑 및 문제 해결