Configura l'integrazione della ricerca in StorageGRID con la richiesta di configurazione della notifica dei metadati del bucket GET
Suggerisci modifiche
PDF
La richiesta GET Bucket metadata notification configuration consente di recuperare il file XML di configurazione utilizzato per configurare l'integrazione della ricerca per i singoli bucket.
Devi avere l'autorizzazione s3:GetBucketMetadataNotification, oppure essere l'utente root, per completare questa operazione.
Esempio di richiesta
Questa richiesta recupera la configurazione di notifica dei metadati per il bucket denominato bucket.
GET /bucket?x-ntap-sg-metadata-notification HTTP/1.1 Date: date Authorization: authorization string Host: host
Risposta
Il corpo della risposta include la configurazione della notifica dei metadati per il bucket. La configurazione della notifica dei metadati ti permette di determinare come il bucket è configurato per l'integrazione con la ricerca. Cioè, ti permette di stabilire quali oggetti vengono indicizzati e a quali endpoint vengono inviati i metadati degli oggetti.
<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>
Ogni configurazione di notifica dei metadati include una o più regole. Ciascuna regola specifica gli oggetti a cui si applica e la destinazione a cui StorageGRID deve inviare i metadati degli oggetti. Le destinazioni devono essere specificate utilizzando l'URN di un endpoint StorageGRID.
| Nome | Descrizione | Richiesto |
|---|---|---|
MetadataNotificationConfiguration |
Tag contenitore per le regole utilizzate per specificare gli oggetti e la destinazione per le notifiche dei metadati. Contiene uno o più elementi Rule. |
Sì |
Regola |
Etichetta contenitore per una regola che identifica gli oggetti i cui metadati devono essere aggiunti a un indice specificato. Le regole con prefissi sovrapposti vengono rifiutate. Incluso nell'elemento MetadataNotificationConfiguration. |
Sì |
ID |
Identificativo univoco per la regola. Incluso nell'elemento Regola. |
No |
Stato |
Lo stato può essere "Abilitato" o "Disabilitato". Per le regole disabilitate non viene intrapresa alcuna azione. Incluso nell'elemento Regola. |
Sì |
Prefisso |
Gli oggetti che corrispondono al prefisso sono interessati dalla regola e i loro metadati vengono inviati alla destinazione specificata. Per selezionare tutti gli oggetti, specifica un prefisso vuoto. Incluso nell'elemento Regola. |
Sì |
Destinazione |
Etichetta contenitore per la destinazione di una regola. Incluso nell'elemento Regola. |
Sì |
Urn |
URN della destinazione a cui vengono inviati i metadati dell'oggetto. Deve essere l'URN di un endpoint StorageGRID con le seguenti proprietà:
Gli endpoint vengono configurati tramite Tenant Manager o Tenant Management API. Hanno la seguente forma:
L'endpoint deve essere configurato prima dell'invio del file XML di configurazione, altrimenti la configurazione fallirà con un errore 404. Urn è incluso nell'elemento Destinazione. |
Sì |
Esempio di risposta
Il codice XML incluso tra i <MetadataNotificationConfiguration></MetadataNotificationConfiguration> tag mostra come è configurata l'integrazione con un endpoint di integrazione di ricerca per il bucket. In questo esempio, i metadati degli oggetti vengono inviati a un indice Elasticsearch denominato current e di tipo denominato 2017 che è ospitato in un dominio AWS denominato 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>