Skip to main content
이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

StorageGRID에서 이벤트 알림을 구성합니다

PDF

버킷에 대한 알림을 활성화하려면 알림 구성 XML을 생성하고 Tenant Manager를 사용하여 해당 XML을 버킷에 적용하면 됩니다.

시작하기 전에

  • 플랫폼 서비스는 StorageGRID 관리자가 테넌트 계정에 대해 활성화했습니다.

  • 이미 알림 소스로 사용할 버킷을 생성했습니다.

  • 이벤트 알림 대상으로 사용하려는 엔드포인트가 이미 존재하며, 해당 URN을 알고 있습니다.

  • 귀하는 "모든 버킷 또는 루트 액세스 권한 관리"을(를) 가진 사용자 그룹에 속해 있습니다. 이러한 권한은 테넌트 관리자를 사용하여 버킷을 구성할 때 그룹 또는 버킷 정책의 권한 설정을 재정의합니다.

이 작업 정보

이벤트 알림은 알림 구성 XML을 소스 버킷과 연결하여 구성합니다. 알림 구성 XML은 버킷 알림 구성을 위한 S3 규칙을 따르며, 대상 Amazon SNS 토픽, Kafka 토픽 또는 웹훅 엔드포인트는 엔드포인트의 URN으로 지정됩니다.

이벤트 알림 및 구성 방법에 대한 일반 정보는 "Amazon 문서"을 참조하십시오. StorageGRID가 S3 버킷 알림 구성 API를 구현하는 방법에 대한 자세한 내용은 "S3 클라이언트 애플리케이션 구현 지침"을 참조하십시오.

버킷에 대한 이벤트 알림을 구성할 때 다음 요구 사항 및 특징을 참고하십시오.

  • 유효한 알림 구성 XML을 생성하고 적용할 때는 각 대상에 대해 이벤트 알림 엔드포인트의 URN을 사용해야 합니다.

  • S3 Object Lock이 활성화된 버킷에서 이벤트 알림을 구성할 수 있지만, 알림 메시지에는 객체의 S3 Object Lock 메타데이터(보존 기한 및 법적 보존 상태 포함)가 포함되지 않습니다.

  • 이벤트 알림을 구성하면 소스 버킷의 객체에 대해 지정된 이벤트가 발생할 때마다 알림이 생성되어 대상으로 사용된 Amazon SNS 토픽, Kafka 토픽 또는 웹훅 엔드포인트로 전송됩니다.

  • 객체가 포함된 버킷에 대해 이벤트 알림을 활성화하면 알림 구성이 저장된 후에 수행된 작업에 대해서만 알림이 전송됩니다.

단계

  1. 소스 버킷에 대한 알림을 활성화합니다.

    • 텍스트 편집기를 사용하여 S3 알림 API에 명시된 대로 이벤트 알림을 활성화하는 데 필요한 알림 구성 XML을 생성합니다.

    • XML을 구성할 때 대상 토픽으로 이벤트 알림 엔드포인트의 URN을 사용하십시오.

      <NotificationConfiguration>
  <TopicConfiguration>
     <Id>Image-created</Id>
     <Filter>
        <S3Key>
          <FilterRule>
            <Name>prefix</Name>
            <Value>images/</Value>
          </FilterRule>
        </S3Key>
    </Filter>
    <Topic>arn:aws:sns:us-east-1:050340950352:sgws-topic</Topic>
    <Event>s3:ObjectCreated:*</Event>
   </TopicConfiguration>
 </NotificationConfiguration>

  2. 테넌트 관리자에서 STORAGE (S3) > *Buckets*를 선택합니다.

  3. 소스 버킷의 이름을 선택합니다.

    버킷 상세 정보 페이지가 나타납니다.

  4. 플랫폼 서비스 > *이벤트 알림*을 선택합니다.

  5. 이벤트 알림 활성화 확인란을 선택합니다.

  6. 알림 구성 XML을 텍스트 상자에 붙여넣고 *변경 사항 저장*을 선택합니다.

    참고 각 테넌트 계정에 대해 플랫폼 서비스를 활성화하려면 Grid Manager 또는 Grid Management API를 사용하는 StorageGRID 관리자가 필요합니다. 구성 XML을 저장할 때 오류가 발생하면 StorageGRID 관리자에게 문의하십시오.

  7. 이벤트 알림이 올바르게 구성되었는지 확인하십시오.

    1. 구성 XML에 설정된 대로 알림을 트리거하기 위한 요구 사항을 충족하는 소스 버킷의 객체에 대해 작업을 수행합니다.

      예시에서는 images/ 접두사가 붙은 객체가 생성될 때마다 이벤트 알림이 전송됩니다.

    2. 알림이 대상 Amazon SNS 토픽, Kafka 토픽 또는 웹훅 엔드포인트로 전달되었는지 확인하십시오.

      예를 들어, 대상 주제가 Amazon SNS에 호스팅되어 있는 경우, 알림이 전달될 때 이메일을 보내도록 서비스를 구성할 수 있습니다.

    {
   "Records":[
      {
         "eventVersion":"2.0",
         "eventSource":"sgws:s3",
         "eventTime":"2017-08-08T23:52:38Z",
         "eventName":"ObjectCreated:Put",
         "userIdentity":{
            "principalId":"1111111111111111111"
         },
         "requestParameters":{
            "sourceIPAddress":"193.51.100.20"
         },
         "responseElements":{
            "x-amz-request-id":"122047343"
         },
         "s3":{
            "s3SchemaVersion":"1.0",
            "configurationId":"Image-created",
            "bucket":{
               "name":"test1",
               "ownerIdentity":{
                  "principalId":"1111111111111111111"
               },
               "arn":"arn:sgws:s3:::test1"
            },
            "object":{
               "key":"images/cat.jpg",
               "size":0,
               "eTag":"d41d8cd98f00b204e9800998ecf8427e",
               "sequencer":"14D90402421461C7"
            }
         }
      }
   ]
}

    + 대상 토픽에서 알림을 수신하면 StorageGRID 알림에 대한 소스 버킷 구성이 성공적으로 완료된 것입니다.

관련 정보