mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-28 09:28:55 -04:00
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.
31 lines
682 B
Markdown
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).
|
|
|
|
|