Configuración de notificación de metadatos del depósito GET
La solicitud de configuración de notificación de metadatos de bucket GET le permite recuperar el XML de configuración utilizado para configurar la integración de búsqueda para buckets individuales.
Debe tener el permiso s3:GetBucketMetadataNotification o ser la cuenta root para completar esta operación.
Ejemplo de solicitud
Esta solicitud recupera la configuración de notificación de metadatos para el depósito denominado bucket
.
GET /bucket?x-ntap-sg-metadata-notification HTTP/1.1 Date: date Authorization: authorization string Host: host
Respuesta
El cuerpo de la respuesta incluye la configuración de notificación de metadatos para el depósito. La configuración de notificación de metadatos le permite determinar cómo se configura el depósito para la integración de búsqueda. Es decir, permite determinar qué objetos están indexados y a qué puntos finales se envían sus metadatos de objetos.
<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>
Cada configuración de notificación de metadatos incluye una o más reglas. Cada regla especifica los objetos a los que se aplica y el destino donde StorageGRID debe enviar los metadatos de los objetos. Los destinos deben especificarse utilizando el URN de un punto final de StorageGRID .
Nombre | Descripción | Requerido |
---|---|---|
Configuración de notificación de metadatos |
Etiqueta contenedora para reglas utilizadas para especificar los objetos y el destino de las notificaciones de metadatos. Contiene uno o más elementos de regla. |
Sí |
Regla |
Etiqueta contenedora para una regla que identifica los objetos cuyos metadatos deben agregarse a un índice específico. Se rechazan las reglas con prefijos superpuestos. Incluido en el elemento MetadataNotificationConfiguration. |
Sí |
IDENTIFICACIÓN |
Identificador único de la regla. Incluido en el elemento Regla. |
No |
Estado |
El estado puede ser 'Habilitado' o 'Deshabilitado'. No se realiza ninguna acción para las reglas que están deshabilitadas. Incluido en el elemento Regla. |
Sí |
Prefijo |
Los objetos que coinciden con el prefijo se ven afectados por la regla y sus metadatos se envían al destino especificado. Para que coincida con todos los objetos, especifique un prefijo vacío. Incluido en el elemento Regla. |
Sí |
Destino |
Etiqueta de contenedor para el destino de una regla. Incluido en el elemento Regla. |
Sí |
Urna |
URN del destino donde se envían los metadatos del objeto. Debe ser la URN de un punto final de StorageGRID con las siguientes propiedades:
Los puntos finales se configuran mediante el Administrador de inquilinos o la API de administración de inquilinos. Toman la siguiente forma:
El punto final debe configurarse antes de enviar el XML de configuración; de lo contrario, la configuración fallará con un error 404. La urna está incluida en el elemento Destino. |
Sí |
Ejemplo de respuesta
El XML incluido entre el <MetadataNotificationConfiguration></MetadataNotificationConfiguration>
Las etiquetas muestran cómo se configura la integración con un punto final de integración de búsqueda para el depósito. En este ejemplo, los metadatos del objeto se envían a un índice de Elasticsearch llamado current
y tipo nombrado 2017
que está alojado en un dominio de AWS llamado 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>