Skip to main content
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Configurez l'intégration de la recherche dans StorageGRID avec la requête de configuration de notification des métadonnées du compartiment GET

PDF

La requête de configuration de notification des métadonnées GET Bucket vous permet de récupérer le fichier XML de configuration utilisé pour configurer l'intégration de la recherche pour des compartiments individuels.

Vous devez disposer de l'autorisation s3:GetBucketMetadataNotification, ou être administrateur du compte, pour effectuer cette opération.

Exemple de requête

Cette requête récupère la configuration de notification des métadonnées pour le compartiment nommé bucket.

GET /bucket?x-ntap-sg-metadata-notification HTTP/1.1
Date: date
Authorization: authorization string
Host: host

Réponse

Le corps de la réponse inclut la configuration de notification des métadonnées du compartiment. La configuration de notification des métadonnées vous permet de déterminer comment le compartiment est configuré pour l'intégration à la recherche. Autrement dit, elle vous permet de déterminer quels objets sont indexés et vers quels points de terminaison les métadonnées de leurs objets sont envoyées.

<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>

Chaque configuration de notification de métadonnées comprend une ou plusieurs règles. Chaque règle spécifie les objets auxquels elle s'applique et la destination où StorageGRID doit envoyer les métadonnées des objets. Les destinations doivent être spécifiées à l'aide de l'URN d'un point de terminaison StorageGRID.

Nom Description Obligatoire

MetadataNotificationConfiguration

Balise conteneur pour les règles utilisées pour spécifier les objets et la destination des notifications de métadonnées.

Contient un ou plusieurs éléments de règle.

Oui

Règle

Balise conteneur pour une règle qui identifie les objets dont les métadonnées doivent être ajoutées à un index spécifié.

Les règles comportant des préfixes qui se chevauchent sont rejetées.

Inclus dans l’élément MetadataNotificationConfiguration.

Oui

ID

Identifiant unique de la règle.

Inclus dans l’élément Rule.

Non

Statut

Le statut peut être « Activé » ou « Désactivé ». Aucune action n'est entreprise pour les règles désactivées.

Inclus dans l’élément Rule.

Oui

Préfixe

Les objets correspondant au préfixe sont concernés par la règle et leurs métadonnées sont envoyées à la destination spécifiée.

Pour faire correspondre tous les objets, spécifiez un préfixe vide.

Inclus dans l’élément Rule.

Oui

Destination

Étiquette conteneur pour la destination d'une règle.

Inclus dans l’élément Rule.

Oui

Urn

URN de la destination où les métadonnées de l'objet sont envoyées. Doit être l'URN d'un point de terminaison StorageGRID possédant les propriétés suivantes :

  • es doit être le troisième élément.

  • L'URN doit se terminer par l'index et le type où les métadonnées sont stockées, sous la forme domain-name/myindex/mytype.

Les points de terminaison sont configurés à l'aide du Gestionnaire de locataires ou de l'API de gestion des locataires. Ils se présentent sous la forme suivante :

  • arn:aws:es:_region:account-ID_:domain/mydomain/myindex/mytype

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

Le point de terminaison doit être configuré avant la soumission du fichier XML de configuration, sinon la configuration échouera avec une erreur 404.

Urn est inclus dans l'élément Destination.

Oui

Exemple de réponse

Le code XML inclus entre les <MetadataNotificationConfiguration></MetadataNotificationConfiguration> balises montre comment l'intégration avec un point de terminaison d'intégration de recherche est configurée pour le compartiment. Dans cet exemple, les métadonnées de l'objet sont envoyées à un index Elasticsearch nommé current et de type nommé 2017 qui est hébergé dans un domaine AWS nommé 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>
Informations connexes

"Utilisez un compte locataire"