112 lines
2.6 KiB
Plaintext
112 lines
2.6 KiB
Plaintext
[role="xpack"]
|
|
[testenv="basic"]
|
|
[[execute-enrich-policy-api]]
|
|
=== Execute enrich policy API
|
|
++++
|
|
<titleabbrev>Execute enrich policy</titleabbrev>
|
|
++++
|
|
|
|
Executes an existing <<enrich-policy,enrich policy>>.
|
|
|
|
////
|
|
|
|
[source,console]
|
|
----
|
|
PUT /users/_doc/1?refresh
|
|
{
|
|
"email": "mardy.brown@asciidocsmith.com",
|
|
"first_name": "Mardy",
|
|
"last_name": "Brown",
|
|
"city": "New Orleans",
|
|
"county": "Orleans",
|
|
"state": "LA",
|
|
"zip": 70116,
|
|
"web": "mardy.asciidocsmith.com"
|
|
}
|
|
|
|
PUT /_enrich/policy/my-policy
|
|
{
|
|
"match": {
|
|
"indices": "users",
|
|
"match_field": "email",
|
|
"enrich_fields": ["first_name", "last_name", "city", "zip", "state"]
|
|
}
|
|
}
|
|
----
|
|
// TESTSETUP
|
|
////
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
PUT /_enrich/policy/my-policy/_execute
|
|
--------------------------------------------------
|
|
|
|
////
|
|
[source,console]
|
|
--------------------------------------------------
|
|
DELETE /_enrich/policy/my-policy
|
|
--------------------------------------------------
|
|
// TEST[continued]
|
|
////
|
|
|
|
|
|
[[execute-enrich-policy-api-request]]
|
|
==== {api-request-title}
|
|
|
|
`PUT /_enrich/policy/<enrich-policy>/_execute`
|
|
|
|
`POST /_enrich/policy/<enrich-policy>/_execute`
|
|
|
|
|
|
[[execute-enrich-policy-api-prereqs]]
|
|
==== {api-prereq-title}
|
|
|
|
include::put-enrich-policy.asciidoc[tag=enrich-policy-api-prereqs]
|
|
|
|
|
|
[[execute-enrich-policy-api-desc]]
|
|
==== {api-description-title}
|
|
|
|
Use the execute enrich policy API
|
|
to create the enrich index for an existing enrich policy.
|
|
|
|
// tag::execute-enrich-policy-def[]
|
|
The _enrich index_ contains documents from the policy's source indices.
|
|
Enrich indices always begin with `.enrich-*`,
|
|
are read-only,
|
|
and are <<indices-forcemerge,force merged>>.
|
|
|
|
[WARNING]
|
|
====
|
|
Enrich indices should be used by the <<enrich-processor,enrich processor>> only.
|
|
Avoid using enrich indices for other purposes.
|
|
====
|
|
// end::execute-enrich-policy-def[]
|
|
|
|
// tag::update-enrich-index[]
|
|
Once created, you cannot update
|
|
or index documents to an enrich index.
|
|
Instead, update your source indices
|
|
and <<execute-enrich-policy-api,execute>> the enrich policy again.
|
|
This creates a new enrich index from your updated source indices
|
|
and deletes the previous enrich index.
|
|
// end::update-enrich-index[]
|
|
|
|
Because this API request performs several operations,
|
|
it may take a while to return a response.
|
|
|
|
[[execute-enrich-policy-api-path-params]]
|
|
==== {api-path-parms-title}
|
|
|
|
`<enrich-policy>`::
|
|
(Required, string)
|
|
Enrich policy to execute.
|
|
|
|
[[execute-enrich-policy-api-request-body]]
|
|
==== {api-request-body-title}
|
|
|
|
`wait_for_completion`::
|
|
(Required, boolean)
|
|
If `true`, the request blocks other enrich policy execution requests until
|
|
complete. Defaults to `true`.
|