elasticsearch/docs/reference/query-languages/query-dsl/query-dsl-ids-query.md
Craig Taverner 94cad286bc
Restructure query-languages docs files for clarity (#124797)
In a few previous PR's we restructured the ES|QL docs to make it possible to generate them dynamically.

This PR just moves a few files around to make the query languages docs easier to work with, and a little more organized like the ES|QL docs.

A bit part of this was setting up redirects to the new locations, so other repo's could correctly link to the elasticsearch docs.
2025-03-17 17:58:58 +01:00

31 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).