Skip to main content
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

获取存储分段元数据通知配置

贡献者

使用获取分段元数据通知配置请求,您可以检索用于为各个分段配置搜索集成的配置 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>

每个元数据通知配置都包含一个或多个规则。每个规则都指定其适用场景 的对象以及 StorageGRID 应将对象元数据发送到的目标。必须使用 StorageGRID 端点的 URN 指定目标。

Name Description Required

MetadataNotificationConfiguration

用于指定元数据通知的对象和目标的规则的容器标记。

包含一个或多个规则元素。

是的。

规则

用于标识应将其元数据添加到指定索引中的对象的规则的容器标记。

拒绝前缀重叠的规则。

包含在 MetadataNotificationConfiguration 元素中。

是的。

ID

规则的唯一标识符。

包含在 Rule 元素中。

Status

状态可以是 " 已启用 " 或 " 已禁用 " 。不会对已禁用的规则执行任何操作。

包含在 Rule 元素中。

是的。

前缀

与前缀匹配的对象受此规则的影响,其元数据将发送到指定目标。

要匹配所有对象,请指定一个空前缀。

包含在 Rule 元素中。

是的。

目标

规则目标的容器标记。

包含在 Rule 元素中。

是的。

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 包含在目标元素中。

是的。

响应示例

包含在之间的XML <MetadataNotificationConfiguration></MetadataNotificationConfiguration> 标记显示了如何为存储分段配置与搜索集成端点的集成。在此示例中、对象元数据将发送到名为的Elasticsearch索引 current 并键入named 2017 托管在名为的AWS域中 records

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>
相关信息

"使用租户帐户"