32 lines
682 B
Markdown
32 lines
682 B
Markdown
|
---
|
||
|
|
navigation_title: "IDs"
|
||
|
|
mapped_pages:
|
||
|
|
- https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-ids-query.html
|
||
|
|
---
|
||
|
|
|
||
|
|
# IDs [query-dsl-ids-query]
|
||
|
|
|
||
|
|
|
||
|
|
Returns documents based on their IDs. This query uses document IDs stored in the [`_id`](/reference/elasticsearch/mapping-reference/mapping-id-field.md) field.
|
||
|
|
|
||
|
|
## Example request [_example_request_3]
|
||
|
|
|
||
|
|
```console
|
||
|
|
GET /_search
|
||
|
|
{
|
||
|
|
"query": {
|
||
|
|
"ids" : {
|
||
|
|
"values" : ["1", "4", "100"]
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Top-level parameters for `ids` [ids-query-top-level-parameters]
|
||
|
|
|
||
|
|
`values`
|
||
|
|
: (Required, array of strings) An array of [document IDs](/reference/elasticsearch/mapping-reference/mapping-id-field.md).
|
||
|
|
|
||
|
|
|