本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

取得Bucket中繼資料通知組態要求

貢獻者

「Get Bucket中繼資料」通知組態要求可讓您擷取組態XML、以設定個別儲存區的搜尋整合。

您有S3:GetBucketMetadata通知權限、或是帳戶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來指定。

名稱 說明 必要

Metadata NotifyationConfiguration

用於指定中繼資料通知物件和目的地之規則的容器標籤。

包含一或多個規則元素。

是的

規則

規則的容器標記、用於識別應將中繼資料新增至指定索引的物件。

會拒絕具有重疊前置碼的規則。

包括在Metadata NotifyationConfiguration元素中。

是的

ID

規則的唯一識別碼。

包含在Rule元素中。

狀態

狀態可以是「已啟用」或「已停用」。不針對停用的規則採取任何行動。

包含在Rule元素中。

是的

前置碼

符合前置碼的物件會受到規則影響、其中繼資料會傳送到指定的目的地。

若要符合所有物件、請指定一個空白首碼。

包含在Rule元素中。

是的

目的地

規則目的地的容器標記。

包含在Rule元素中。

是的

urn

傳送物件中繼資料的目的地之一。必須是StorageGRID 具有下列屬性的不景端點的URN:

  • 第三個要素是「es」。

  • URN必須以索引結尾、並以「domain-name/myindex/mytype」格式輸入中繼資料的儲存位置。

端點是使用租戶管理程式或租戶管理API來設定。它們採用下列形式:

  • 「arn:AWS:es:_region:帳戶ID:網域/ mydomain/myindex/mytype」

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

端點必須在提交組態XML之前進行設定、否則組態將會失敗並顯示404錯誤。

目標元素中包含urn.

是的

回應範例

包含在「<Metadata NotifyationConfiguration></Metadata NotifyationConfiguration >」標籤之間的XML、顯示如何為儲存區設定與搜尋整合端點的整合。在此範例中、物件中繼資料會傳送至名為「目前」的ElasticSearch索引、並在名為「資源」的AWS網域中、輸入名為「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>