搜尋整合的組態XML
搜尋整合服務是使用「<Metadata NotifyationConfiguration >」和「</Metadata NotifyationConfiguration >」標記中所包含的一組規則來設定。每個規則都會指定規則適用的物件、StorageGRID 以及應將這些物件中繼資料傳送到哪個目的地。
物件可依物件名稱的前置詞進行篩選。例如、您可以將前置詞為「Images(影像)」的物件中繼資料傳送到一個目的地、並將前置詞為「videos(視訊)」的物件中繼資料傳送到另一個目的地。具有重疊前置碼的組態無效、在提交時會遭到拒絕。例如、不允許使用含有前置詞「test」的物件規則、以及含有前置詞「test2」之物件的第二個規則的組態。
目的地必須使用StorageGRID 已為搜尋整合服務建立的一個端點的URN來指定。這些端點是指在ElasticSearch叢集上定義的索引和類型。
<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>
下表說明中繼資料通知組態XML中的元素。
名稱 | 說明 | 必要 |
---|---|---|
Metadata NotifyationConfiguration |
用於指定中繼資料通知物件和目的地之規則的容器標籤。 包含一或多個規則元素。 |
是的 |
規則 |
規則的容器標記、用於識別應將中繼資料新增至指定索引的物件。 會拒絕具有重疊前置碼的規則。 包括在Metadata NotifyationConfiguration元素中。 |
是的 |
ID |
規則的唯一識別碼。 包含在Rule元素中。 |
否 |
狀態 |
狀態可以是「已啟用」或「已停用」。不針對停用的規則採取任何行動。 包含在Rule元素中。 |
是的 |
前置碼 |
符合前置碼的物件會受到規則影響、其中繼資料會傳送到指定的目的地。 若要符合所有物件、請指定一個空白首碼。 包含在Rule元素中。 |
是的 |
目的地 |
規則目的地的容器標記。 包含在Rule元素中。 |
是的 |
urn |
傳送物件中繼資料的目的地之一。必須是StorageGRID 具有下列屬性的不景端點的URN:
端點是使用租戶管理程式或租戶管理API來設定。它們採用下列形式:
端點必須在提交組態XML之前進行設定、否則組態將會失敗並顯示404錯誤。 目標元素中包含urn. |
是的 |
使用範例中繼資料通知組態XML來瞭解如何建構您自己的XML。
適用於所有物件的中繼資料通知組態
在此範例中、所有物件的物件中繼資料都會傳送到相同的目的地。
<MetadataNotificationConfiguration> <Rule> <ID>Rule-1</ID> <Status>Enabled</Status> <Prefix></Prefix> <Destination> <Urn>urn:myes:es:::sgws-notifications/test1/all</Urn> </Destination> </Rule> </MetadataNotificationConfiguration>
中繼資料通知組態有兩條規則
在此範例中、與首碼「/影像」相符的物件之物件中繼資料會傳送至一個目的地、而與首碼「/視訊」相符的物件之物件中繼資料則會傳送至第二個目的地。
<MetadataNotificationConfiguration> <Rule> <ID>Images-rule</ID> <Status>Enabled</Status> <Prefix>/images</Prefix> <Destination> <Urn>arn:aws:es:us-east-1:3333333:domain/es-domain/graphics/imagetype</Urn> </Destination> </Rule> <Rule> <ID>Videos-rule</ID> <Status>Enabled</Status> <Prefix>/videos</Prefix> <Destination> <Urn>arn:aws:es:us-west-1:22222222:domain/es-domain/graphics/videotype</Urn> </Destination> </Rule> </MetadataNotificationConfiguration>