Configurar a integração de pesquisa no StorageGRID com a solicitação GET Bucket metadata notification configuration
Sugerir alterações
PDFs
A solicitação GET Bucket metadata notification configuration permite que você recupere o XML de configuração usado para configurar a integração de pesquisa para buckets individuais.
Você deve ter a permissão s3:GetBucketMetadataNotification, ou ser o usuário raiz da conta, para concluir esta operação.
Exemplo de solicitação
Esta solicitação recupera a configuração de notificação de metadados para o bucket chamado bucket.
GET /bucket?x-ntap-sg-metadata-notification HTTP/1.1 Date: date Authorization: authorization string Host: host
Resposta
O corpo da resposta inclui a configuração de notificação de metadados para o bucket. A configuração de notificação de metadados permite que você determine como o bucket está configurado para integração de pesquisa. Ou seja, permite que você determine quais objetos são indexados e para quais endpoints os metadados dos objetos estão sendo enviados.
<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 configuração de notificação de metadados inclui uma ou mais regras. Cada regra especifica os objetos aos quais se aplica e o destino para onde o StorageGRID deve enviar os metadados dos objetos. Os destinos devem ser especificados usando o URN de um endpoint do StorageGRID.
| Nome | Descrição | Obrigatório |
|---|---|---|
MetadataNotificationConfiguration |
Tag de contêiner para regras usadas para especificar os objetos e o destino para notificações de metadados. Contém um ou mais elementos de Rule. |
Sim |
Regra |
Etiqueta de contêiner para uma regra que identifica os objetos cujos metadados devem ser adicionados a um índice específico. Regras com prefixos sobrepostos são rejeitadas. Incluído no elemento MetadataNotificationConfiguration. |
Sim |
ID |
Identificador único para a regra. Incluído no elemento Rule. |
Não |
Status |
O status pode ser 'Ativado' ou 'Desativado'. Nenhuma ação é executada para regras desativadas. Incluído no elemento Rule. |
Sim |
Prefixo |
Os objetos que correspondem ao prefixo são afetados pela regra e seus metadados são enviados para o destino especificado. Para corresponder a todos os objetos, especifique um prefixo vazio. Incluído no elemento Rule. |
Sim |
Destino |
Etiqueta de contêiner para o destino de uma regra. Incluído no elemento Rule. |
Sim |
Urna |
URN do destino para onde os metadados do objeto são enviados. Deve ser o URN de um endpoint do StorageGRID com as seguintes propriedades:
Os endpoints são configurados usando o Tenant Manager ou a Tenant Management API. Eles têm o seguinte formato:
O endpoint deve ser configurado antes do envio do XML de configuração, ou a configuração falhará com um erro 404. Urn está incluído no elemento Destination. |
Sim |
Exemplo de resposta
O XML incluído entre as <MetadataNotificationConfiguration></MetadataNotificationConfiguration> tags mostra como a integração com um endpoint de integração de pesquisa é configurada para o bucket. Neste exemplo, os metadados do objeto estão sendo enviados para um índice do Elasticsearch chamado current e tipo chamado 2017 que está hospedado em um domínio da AWS chamado 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>