EventBridge 이벤트 메시지 구조 - Amazon Simple Storage Service
이벤트 메시지 구조 예제이벤트 메시지 세부 정보 필드

EventBridge 이벤트 메시지 구조

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

  • 버전(version) - 현재 모든 이벤트에 대해 0(영)입니다.

  • id - 모든 이벤트에 대해 생성된 버전 4 UUID입니다.

  • detail-type - 전송 중인 이벤트의 유형입니다. 이벤트 유형 목록은 EventBridge 사용 섹션을 참조하십시오.

  • 소스(source) - 이벤트를 생성한 서비스를 식별합니다.

  • 계정(account) - S3 버킷 소유자의 12자리 AWS 계정 ID입니다.

  • time(시간) - 이벤트가 발생한 시간입니다.

  • 리전(region) - 버킷의 AWS 리전을 식별합니다.

  • resource(리소스) - 버킷의 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:::DOC-EXAMPLE-BUCKET1"
  ],
  "detail": {
    "version": "0",
    "bucket": {
      "name": "DOC-EXAMPLE-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:::DOC-EXAMPLE-BUCKET1"
  ],
  "detail": {
    "version": "0",
    "bucket": {
      "name": "DOC-EXAMPLE-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:::DOC-EXAMPLE-BUCKET1"
  ],
  "detail": {
    "version": "0",
    "bucket": {
      "name": "DOC-EXAMPLE-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:::DOC-EXAMPLE-BUCKET1"
  ],
  "detail": {
    "version": "0",
    "bucket": {
      "name": "DOC-EXAMPLE-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"
  }
}

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

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

  • 버전(version) - 현재 모든 이벤트에 대해 0(영)입니다.

  • 버킷(bucket) - 이벤트와 관련된 Amazon S3 버킷에 대한 정보입니다.

  • 객체(object) - 이벤트와 관련된 Amazon S3 객체에 대한 정보입니다.

  • request-id - S3 응답의 요청 ID입니다.

  • 요청자(requester) - AWS 계정 ID 또는 요청자의 AWS 서비스 보안 주체입니다.

  • source-ip-address - S3 요청의 소스 IP 주소입니다. S3 요청에 의해 트리거된 이벤트의 경우에만 있습니다.

  • 이유(reason) - 객체 생성됨(Object Created) 이벤트의 경우 객체 생성에 사용된 S3 API(PutObject, POST Object, CopyObject 또는 CompleteMultipartUpload)입니다. 객체 삭제됨(Object Deleted) 이벤트의 경우 객체가 S3 API 호출에 의해 삭제되면 DeleteObject로 설정되고, S3 수명 주기 만료 규칙에 의해 객체가 삭제되면 수명 주기 만료(Lifecycle Expiration)로 설정됩니다. 자세한 내용은 객체 만료 단원을 참조하십시오.

  • deletion-type - 객체 삭제됨(Object Deleted) 이벤트의 경우 버전이 지정되지 않은 객체가 삭제되거나 버전이 지정된 객체가 영구적으로 삭제되면 영구 삭제됨(Permanently Deleted)으로 설정됩니다. 버전이 지정된 객체에 대해 삭제 마커가 생성되면 삭제 마커 생성됨(Delete Marker Created)으로 설정됩니다. 자세한 내용은 버전 관리가 사용 설정된 버킷에서 객체 버전 삭제 단원을 참조하십시오.

  • restore-expiry-time - 객체 복원 완료됨(Object Restore Completed) 이벤트의 경우 객체의 임시 복사본이 S3에서 삭제되는 시간입니다. 자세한 내용은 아카이브된 객체 작업 단원을 참조하십시오.

  • source-storage-class - 객체 복원 시작됨(Object Restore Initiated) 및 객체 복원 완료됨(Object Restore Completed) 이벤트의 경우 복원 중인 객체의 스토리지 클래스입니다. 자세한 내용은 아카이브된 객체 작업 단원을 참조하십시오.

  • destination-storage-class - 객체 스토리지 클래스 변경됨(Object Storage Class Changed) 이벤트의 경우 객체의 새 스토리지 클래스입니다. 자세한 내용은 Amazon S3 수명 주기를 사용하여 객체 전환 단원을 참조하십시오.

  • destination-access-tier - 객체 액세스 계층 변경됨(Object Access Tier Changed) 이벤트의 경우 객체의 새 액세스 계층입니다. 자세한 내용은 Amazon S3 Intelligent Tiering 단원을 참조하십시오.