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

이벤트 알림을 구성합니다

기여자
PDF

알림 구성 XML을 생성하고 테넌트 관리자를 사용하여 XML을 버킷에 적용하여 버킷에 대한 알림을 활성화합니다.

시작하기 전에

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

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

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

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

이 작업에 대해

알림 구성 XML을 소스 버킷과 연결하여 이벤트 알림을 구성합니다. 알림 구성 XML은 끝점 URN으로 지정된 대상 Kafka 또는 Amazon SNS 항목과 함께 버킷 알림을 구성하는 S3 규칙을 따릅니다.

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

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

  • 유효한 알림 구성 XML을 만들고 적용할 때 각 대상에 대한 이벤트 알림 끝점의 URN을 사용해야 합니다.

  • S3 오브젝트 잠금이 설정된 버킷에서 이벤트 알림을 구성할 수 있지만, 오브젝트의 S3 오브젝트 잠금 메타데이터(보존 기한 및 법적 증거 자료 보관 상태 포함)는 알림 메시지에 포함되지 않습니다.

  • 이벤트 알림을 구성한 후 소스 버킷의 오브젝트에 대해 지정된 이벤트가 발생할 때마다 알림이 생성되어 대상 끝점으로 사용되는 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. 테넌트 관리자에서 * 스토리지(S3) * > * 버킷 * 을 선택합니다.

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

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

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

  5. 이벤트 알림 사용 * 확인란을 선택합니다.

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

    참고 그리드 관리자 또는 그리드 관리 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 알림에 대한 소스 버킷을 성공적으로 구성한 것입니다.

관련 정보

"버킷에 대한 알림을 이해합니다"

"S3 REST API 사용"

"플랫폼 서비스 끝점을 만듭니다"