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

GET 버킷 메타데이터 알림 구성 요청을 사용하여 StorageGRID에서 검색 통합을 구성합니다

PDF

GET 버킷 메타데이터 알림 구성 요청을 사용하면 개별 버킷에 대한 검색 통합을 구성하는 데 사용되는 구성 XML을 검색할 수 있습니다.

이 작업을 완료하려면 s3:GetBucketMetadataNotification 권한이 있거나 계정 루트여야 합니다.

요청 예시

이 요청은 `bucket`라는 이름의 버킷에 대한 메타데이터 알림 구성을 검색합니다.

GET /bucket?x-ntap-sg-metadata-notification HTTP/1.1
Date: date
Authorization: authorization string
Host: host

응답

응답 본문에는 버킷에 대한 메타데이터 알림 구성이 포함됩니다. 메타데이터 알림 구성을 통해 검색 통합을 위해 버킷을 구성하는 방법을 결정할 수 있습니다. 즉, 어떤 객체를 인덱싱할지, 그리고 해당 객체의 메타데이터가 어떤 엔드포인트로 전송될지를 지정할 수 있습니다.

<MetadataNotificationConfiguration>
    <Rule>
        <ID>Rule-1</ID>
        <Status>rule-status</Status>
        <Prefix>key-prefix</Prefix>
        <Destination>
           <Urn>arn:aws:es:_region:account-ID_:domain/_mydomain/myindex/mytype_</Urn>
        </Destination>
    </Rule>
    <Rule>
        <ID>Rule-2</ID>
         ...
    </Rule>
     ...
</MetadataNotificationConfiguration>

각 메타데이터 알림 구성에는 하나 이상의 규칙이 포함됩니다. 각 규칙은 적용 대상 객체와 StorageGRID가 객체 메타데이터를 전송해야 하는 대상을 지정합니다. 대상은 StorageGRID 엔드포인트의 URN을 사용하여 지정해야 합니다.

이름 설명 필수

MetadataNotificationConfiguration

메타데이터 알림의 객체와 대상을 지정하는 데 사용되는 규칙의 컨테이너 태그입니다.

하나 이상의 Rule 요소를 포함합니다.

예

규칙

지정된 인덱스에 메타데이터를 추가해야 하는 객체를 식별하는 규칙에 대한 컨테이너 태그입니다.

접두사가 겹치는 규칙은 허용되지 않습니다.

MetadataNotificationConfiguration 요소에 포함되어 있습니다.

예

ID

규칙에 대한 고유 식별자입니다.

규칙 요소에 포함됩니다.

아니요

상태

상태는 '활성화됨' 또는 '비활성화됨'일 수 있습니다. 비활성화된 규칙에 대해서는 아무런 조치도 취해지지 않습니다.

규칙 요소에 포함됩니다.

예

접두사

접두사와 일치하는 객체는 해당 규칙의 영향을 받으며, 해당 객체의 메타데이터가 지정된 대상으로 전송됩니다.

모든 객체와 일치시키려면 빈 접두사를 지정하십시오.

규칙 요소에 포함됩니다.

예

목적지

규칙의 대상에 대한 컨테이너 태그입니다.

규칙 요소에 포함됩니다.

예

Urn

객체 메타데이터가 전송되는 대상의 URN입니다. 다음 속성을 가진 StorageGRID 엔드포인트의 URN이어야 합니다.

  • `es`세 번째 요소여야 합니다.

  • URN은 메타데이터가 저장된 인덱스와 유형으로 끝나야 하며, 형식은 `domain-name/myindex/mytype`입니다.

엔드포인트는 테넌트 관리자 또는 테넌트 관리 API를 사용하여 구성됩니다. 다음과 같은 형식을 사용합니다.

  • arn:aws:es:_region:account-ID_:domain/mydomain/myindex/mytype

  • urn:mysite:es:::mydomain/myindex/mytype

엔드포인트는 구성 XML을 제출하기 전에 구성되어야 합니다. 그렇지 않으면 구성이 실패하고 404 오류가 발생합니다.

URN은 대상 요소에 포함됩니다.

예

응답 예시

`<MetadataNotificationConfiguration></MetadataNotificationConfiguration>`태그 사이에 포함된 XML은 버킷에 대한 검색 통합 엔드포인트와의 통합 구성 방식을 보여줍니다. 이 예에서는 객체 메타데이터가 `current`라는 이름의 Elasticsearch 인덱스와 `2017`라는 유형으로 전송되며, 이 인덱스는 `records`라는 이름의 AWS 도메인에 호스팅됩니다.
HTTP/1.1 200 OK
Date: Thu, 20 Jul 2017 18:24:05 GMT
Connection: KEEP-ALIVE
Server: StorageGRID/11.0.0
x-amz-request-id: 3832973499
Content-Length: 264
Content-Type: application/xml

<MetadataNotificationConfiguration>
    <Rule>
        <ID>Rule-1</ID>
        <Status>Enabled</Status>
        <Prefix>2017</Prefix>
        <Destination>
           <Urn>arn:aws:es:us-east-1:3333333:domain/records/current/2017</Urn>
        </Destination>
    </Rule>
</MetadataNotificationConfiguration>
관련 정보

"테넌트 계정 사용"