Skip to content

Commit 15baf40

Browse files
authored
[DOCS] Remove _term and _time agg order keys (#78209)
Adds an 8.0 breaking change for the removal of the `_term` and `_time` agg `order` keys. Relates to #39450
1 parent 979f297 commit 15baf40

File tree

2 files changed

+26
-2
lines changed

2 files changed

+26
-2
lines changed

docs/reference/aggregations/bucket/terms-aggregation.asciidoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -248,8 +248,6 @@ GET /_search
248248
}
249249
--------------------------------------------------
250250

251-
deprecated[6.0.0, Use `_key` instead of `_term` to order buckets by their term]
252-
253251
Ordering the buckets by single value metrics sub-aggregation (identified by the aggregation name):
254252

255253
[source,console,id=terms-aggregation-subaggregation-example]

docs/reference/migration/migrate_8_0/aggregations.asciidoc

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,32 @@
77

88
//tag::notable-breaking-changes[]
99

10+
[[remove-term-order-key]]
11+
.The `terms` aggregation no longer supports the `_term` order key.
12+
[%collapsible]
13+
====
14+
*Details* +
15+
The `terms` aggregation no longer supports the `_term` key in `order` values. To
16+
sort buckets by their term, use `_key` instead.
17+
18+
*Impact* +
19+
Discontinue use of the `_term` order key. Requests that include a `_term` order
20+
key will return an error.
21+
====
22+
23+
[[remove-time-order-key]]
24+
.The `date_histogram` aggregation no longer supports the `_time` order key.
25+
[%collapsible]
26+
====
27+
*Details* +
28+
The `date_histogram` aggregation no longer supports the `_time` key in `order`
29+
values. To sort buckets by their key, use `_key` instead.
30+
31+
*Impact* +
32+
Discontinue use of the `_time` order key. Requests that include a `_time` order
33+
key will return an error.
34+
====
35+
1036
[[remove-moving-avg-agg]]
1137
.The `moving_avg` aggregation has been removed.
1238
[%collapsible]

0 commit comments

Comments
 (0)