2013-08-29 07:24:34 +08:00
|
|
|
[[query-dsl-ids-query]]
|
2019-07-18 22:18:11 +08:00
|
|
|
=== IDs
|
|
|
|
|
++++
|
|
|
|
|
<titleabbrev>IDs</titleabbrev>
|
|
|
|
|
++++
|
|
|
|
|
|
2019-04-11 02:35:24 +08:00
|
|
|
Returns documents based on their IDs. This query uses document IDs stored in
|
|
|
|
|
the <<mapping-id-field,`_id`>> field.
|
2013-08-29 07:24:34 +08:00
|
|
|
|
2019-04-11 02:35:24 +08:00
|
|
|
==== Example request
|
2013-08-29 07:24:34 +08:00
|
|
|
|
2019-09-09 22:45:37 +08:00
|
|
|
[source,console]
|
2013-08-29 07:24:34 +08:00
|
|
|
--------------------------------------------------
|
2016-05-24 17:58:43 +08:00
|
|
|
GET /_search
|
2013-08-29 07:24:34 +08:00
|
|
|
{
|
2016-05-24 17:58:43 +08:00
|
|
|
"query": {
|
|
|
|
|
"ids" : {
|
|
|
|
|
"values" : ["1", "4", "100"]
|
|
|
|
|
}
|
2013-08-29 07:24:34 +08:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
--------------------------------------------------
|
2019-04-11 02:35:24 +08:00
|
|
|
|
2019-04-30 22:19:09 +08:00
|
|
|
[[ids-query-top-level-parameters]]
|
2019-04-11 02:35:24 +08:00
|
|
|
==== Top-level parameters for `ids`
|
|
|
|
|
|
2019-05-09 21:51:12 +08:00
|
|
|
`values`::
|
2019-08-01 02:18:22 +08:00
|
|
|
(Required, array of strings) An array of <<mapping-id-field, document IDs>>.
|
