GET Bucket metadata notification configuration要求では、個々のバケットで検索統合を設定するために使用する設定XMLを読み出すことができます。
この処理を完了するには、s3:GetBucketMetadataNotification権限またはrootアカウントが必要です。
次の要求は、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>
各メタデータ通知設定には、1つ以上のルールが含まれています。各ルールは、その適用対象であるオブジェクトと、StorageGRIDがオブジェクト メタデータを送信するデスティネーションを指定します。デスティネーションは、StorageGRIDエンドポイントのURNを使用して指定する必要があります。
名前 | 説明 | 必須 |
---|---|---|
MetadataNotificationConfiguration | メタデータ通知でオブジェクトとデスティネーションの指定に使用されるルール用のコンテナ タグ。 1つ以上のルール要素が含まれています。 |
○ |
Rule | 指定したインデックスにメタデータを追加する必要があるオブジェクトを特定するルール用のコンテナ タグ。 プレフィックスが重複しているルールは拒否されます。 MetadataNotificationConfiguration要素に含まれています。 |
○ |
ID | ルールの一意の識別子。 Rule要素に含まれています。 |
× |
Status | Statusには「Enabled」または「Disabled」を指定できます。無効になっているルールについては操作が実行されません。 Rule要素に含まれています。 |
○ |
Prefix | このプレフィックスと一致するオブジェクトにルールが適用され、そのメタデータが指定したデスティネーションに送信されます。 すべてのオブジェクトを対象にする場合は、空のプレフィックスを指定します。 Rule要素に含まれています。 |
○ |
Destination | ルールのデスティネーション用のコンテナ タグ。 Rule要素に含まれています。 |
○ |
Urn | オブジェクト メタデータが送信されるデスティネーションのURN。次のプロパティを持つStorageGRIDエンドポイントのURNを指定する必要があります。
エンドポイントは、Tenant Managerまたはテナント管理APIを使用して設定されます。形式は次のとおりです。
エンドポイントは設定XMLを送信する前に設定する必要があります。そうしないと、404エラーで設定が失敗します。 UrnはDestination要素に含まれています。 |
○ |
<MetadataNotificationConfiguration>タグと</MetadataNotificationConfiguration>タグの間にあるXMLは、バケットで検索統合エンドポイントとの統合がどのように設定されているかを示します。次の例では、recordsという名前のAWSドメインでホストされているcurrentという名前のElasticsearchインデックスと2017という名前のタイプに、オブジェクト メタデータが送信されます。
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>