Skip to content

Commit c4e8edc

Browse files
committed
API: Update Elasticsearch APIs for 7.10
1 parent bc6ed13 commit c4e8edc

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

124 files changed

+2238
-684
lines changed

elasticsearch/_async/client/__init__.py

+40
Original file line numberDiff line numberDiff line change
@@ -266,6 +266,7 @@ async def close(self):
266266
async def ping(self, params=None, headers=None):
267267
"""
268268
Returns whether the cluster is running.
269+
269270
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/index.html>`_
270271
"""
271272
try:
@@ -279,6 +280,7 @@ async def ping(self, params=None, headers=None):
279280
async def info(self, params=None, headers=None):
280281
"""
281282
Returns basic information about the cluster.
283+
282284
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/index.html>`_
283285
"""
284286
return await self.transport.perform_request(
@@ -298,6 +300,7 @@ async def create(self, index, id, body, doc_type=None, params=None, headers=None
298300
"""
299301
Creates a new document in the index. Returns a 409 response when a document
300302
with a same ID already exists in the index.
303+
301304
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-index_.html>`_
302305
303306
:arg index: The name of the index
@@ -352,6 +355,7 @@ async def index(
352355
):
353356
"""
354357
Creates or updates a document in an index.
358+
355359
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-index_.html>`_
356360
357361
:arg index: The name of the index
@@ -415,6 +419,7 @@ async def index(
415419
async def bulk(self, body, index=None, doc_type=None, params=None, headers=None):
416420
"""
417421
Allows to perform multiple index/update/delete operations in a single request.
422+
418423
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-bulk.html>`_
419424
420425
:arg body: The operation definition and data (action-data
@@ -461,6 +466,7 @@ async def bulk(self, body, index=None, doc_type=None, params=None, headers=None)
461466
async def clear_scroll(self, body=None, scroll_id=None, params=None, headers=None):
462467
"""
463468
Explicitly clears the search context for a scroll.
469+
464470
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/clear-scroll-api.html>`_
465471
466472
:arg body: A comma-separated list of scroll IDs to clear if none
@@ -499,6 +505,7 @@ async def count(
499505
):
500506
"""
501507
Returns number of documents matching a query.
508+
502509
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-count.html>`_
503510
504511
:arg body: A query to restrict the results specified with the
@@ -556,6 +563,7 @@ async def count(
556563
async def delete(self, index, id, doc_type=None, params=None, headers=None):
557564
"""
558565
Removes a document from the index.
566+
559567
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-delete.html>`_
560568
561569
:arg index: The name of the index
@@ -633,6 +641,7 @@ async def delete_by_query(
633641
):
634642
"""
635643
Deletes documents matching the provided query.
644+
636645
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-delete-by-query.html>`_
637646
638647
:arg index: A comma-separated list of index names to search; use
@@ -729,6 +738,7 @@ async def delete_by_query_rethrottle(self, task_id, params=None, headers=None):
729738
"""
730739
Changes the number of requests per second for a particular Delete By Query
731740
operation.
741+
732742
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-delete-by-query.html>`_
733743
734744
:arg task_id: The task id to rethrottle
@@ -749,6 +759,7 @@ async def delete_by_query_rethrottle(self, task_id, params=None, headers=None):
749759
async def delete_script(self, id, params=None, headers=None):
750760
"""
751761
Deletes a script.
762+
752763
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/modules-scripting.html>`_
753764
754765
:arg id: Script ID
@@ -777,6 +788,7 @@ async def delete_script(self, id, params=None, headers=None):
777788
async def exists(self, index, id, doc_type=None, params=None, headers=None):
778789
"""
779790
Returns information about whether a document exists in an index.
791+
780792
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-get.html>`_
781793
782794
:arg index: The name of the index
@@ -827,6 +839,7 @@ async def exists(self, index, id, doc_type=None, params=None, headers=None):
827839
async def exists_source(self, index, id, doc_type=None, params=None, headers=None):
828840
"""
829841
Returns information about whether a document source exists in an index.
842+
830843
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-get.html>`_
831844
832845
:arg index: The name of the index
@@ -882,6 +895,7 @@ async def explain(
882895
):
883896
"""
884897
Returns information about why a specific matches (or doesn't match) a query.
898+
885899
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-explain.html>`_
886900
887901
:arg index: The name of the index
@@ -934,6 +948,7 @@ async def field_caps(self, body=None, index=None, params=None, headers=None):
934948
"""
935949
Returns the information about the capabilities of fields among multiple
936950
indices.
951+
937952
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-field-caps.html>`_
938953
939954
:arg body: An index filter specified with the Query DSL
@@ -974,6 +989,7 @@ async def field_caps(self, body=None, index=None, params=None, headers=None):
974989
async def get(self, index, id, doc_type=None, params=None, headers=None):
975990
"""
976991
Returns a document.
992+
977993
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-get.html>`_
978994
979995
:arg index: The name of the index
@@ -1014,6 +1030,7 @@ async def get(self, index, id, doc_type=None, params=None, headers=None):
10141030
async def get_script(self, id, params=None, headers=None):
10151031
"""
10161032
Returns a script.
1033+
10171034
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/modules-scripting.html>`_
10181035
10191036
:arg id: Script ID
@@ -1040,6 +1057,7 @@ async def get_script(self, id, params=None, headers=None):
10401057
async def get_source(self, index, id, doc_type=None, params=None, headers=None):
10411058
"""
10421059
Returns the source of a document.
1060+
10431061
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-get.html>`_
10441062
10451063
:arg index: The name of the index
@@ -1089,6 +1107,7 @@ async def get_source(self, index, id, doc_type=None, params=None, headers=None):
10891107
async def mget(self, body, index=None, doc_type=None, params=None, headers=None):
10901108
"""
10911109
Allows to get multiple documents in one request.
1110+
10921111
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-multi-get.html>`_
10931112
10941113
:arg body: Document identifiers; can be either `docs`
@@ -1135,6 +1154,7 @@ async def mget(self, body, index=None, doc_type=None, params=None, headers=None)
11351154
async def msearch(self, body, index=None, doc_type=None, params=None, headers=None):
11361155
"""
11371156
Allows to execute several search operations in one request.
1157+
11381158
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-multi-search.html>`_
11391159
11401160
:arg body: The request definitions (metadata-search request
@@ -1191,6 +1211,7 @@ async def msearch_template(
11911211
):
11921212
"""
11931213
Allows to execute several search template operations in one request.
1214+
11941215
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-multi-search.html>`_
11951216
11961217
:arg body: The request definitions (metadata-search request
@@ -1243,6 +1264,7 @@ async def mtermvectors(
12431264
):
12441265
"""
12451266
Returns multiple termvectors in one request.
1267+
12461268
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-multi-termvectors.html>`_
12471269
12481270
:arg body: Define ids, documents, parameters or a list of
@@ -1295,6 +1317,7 @@ async def mtermvectors(
12951317
async def put_script(self, id, body, context=None, params=None, headers=None):
12961318
"""
12971319
Creates or updates a script.
1320+
12981321
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/modules-scripting.html>`_
12991322
13001323
:arg id: Script ID
@@ -1322,6 +1345,7 @@ async def rank_eval(self, body, index=None, params=None, headers=None):
13221345
"""
13231346
Allows to evaluate the quality of ranked search results over a set of typical
13241347
search queries
1348+
13251349
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-rank-eval.html>`_
13261350
13271351
:arg body: The ranking evaluation search definition, including
@@ -1365,6 +1389,7 @@ async def reindex(self, body, params=None, headers=None):
13651389
Allows to copy documents from one index to another, optionally filtering the
13661390
source documents by a query, changing the destination index settings, or
13671391
fetching the documents from a remote cluster.
1392+
13681393
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-reindex.html>`_
13691394
13701395
:arg body: The search definition using the Query DSL and the
@@ -1400,6 +1425,7 @@ async def reindex(self, body, params=None, headers=None):
14001425
async def reindex_rethrottle(self, task_id, params=None, headers=None):
14011426
"""
14021427
Changes the number of requests per second for a particular Reindex operation.
1428+
14031429
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-reindex.html>`_
14041430
14051431
:arg task_id: The task id to rethrottle
@@ -1422,6 +1448,7 @@ async def render_search_template(
14221448
):
14231449
"""
14241450
Allows to use the Mustache language to pre-render a search definition.
1451+
14251452
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-template.html#_validating_templates>`_
14261453
14271454
:arg body: The search definition template and its params
@@ -1439,6 +1466,7 @@ async def render_search_template(
14391466
async def scripts_painless_execute(self, body=None, params=None, headers=None):
14401467
"""
14411468
Allows an arbitrary script to be executed and a result to be returned
1469+
14421470
`<https://www.elastic.co/guide/en/elasticsearch/painless/master/painless-execute-api.html>`_
14431471
14441472
:arg body: The script to execute
@@ -1455,6 +1483,7 @@ async def scripts_painless_execute(self, body=None, params=None, headers=None):
14551483
async def scroll(self, body=None, scroll_id=None, params=None, headers=None):
14561484
"""
14571485
Allows to retrieve a large numbers of results from a single search request.
1486+
14581487
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-request-body.html#request-body-search-scroll>`_
14591488
14601489
:arg body: The scroll ID if not passed by URL or query
@@ -1525,6 +1554,7 @@ async def search(
15251554
):
15261555
"""
15271556
Returns results matching a query.
1557+
15281558
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-search.html>`_
15291559
15301560
:arg body: The search definition using the Query DSL
@@ -1647,6 +1677,7 @@ async def search_shards(self, index=None, params=None, headers=None):
16471677
"""
16481678
Returns information about the indices and shards that a search request would be
16491679
executed against.
1680+
16501681
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-shards.html>`_
16511682
16521683
:arg index: A comma-separated list of index names to search; use
@@ -1689,6 +1720,7 @@ async def search_template(
16891720
):
16901721
"""
16911722
Allows to use the Mustache language to pre-render a search definition.
1723+
16921724
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/search-template.html>`_
16931725
16941726
:arg body: The search definition template and its params
@@ -1755,6 +1787,7 @@ async def termvectors(
17551787
"""
17561788
Returns information and statistics about terms in the fields of a particular
17571789
document.
1790+
17581791
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-termvectors.html>`_
17591792
17601793
:arg index: The index in which the document resides.
@@ -1813,6 +1846,7 @@ async def termvectors(
18131846
async def update(self, index, id, body, doc_type=None, params=None, headers=None):
18141847
"""
18151848
Updates a document with a script or partial document.
1849+
18161850
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-update.html>`_
18171851
18181852
:arg index: The name of the index
@@ -1905,6 +1939,7 @@ async def update_by_query(
19051939
"""
19061940
Performs an update on every document in the index without changing the source,
19071941
for example to pick up a mapping change.
1942+
19081943
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-update-by-query.html>`_
19091944
19101945
:arg index: A comma-separated list of index names to search; use
@@ -2004,6 +2039,7 @@ async def update_by_query_rethrottle(self, task_id, params=None, headers=None):
20042039
"""
20052040
Changes the number of requests per second for a particular Update By Query
20062041
operation.
2042+
20072043
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-update-by-query.html>`_
20082044
20092045
:arg task_id: The task id to rethrottle
@@ -2024,6 +2060,7 @@ async def update_by_query_rethrottle(self, task_id, params=None, headers=None):
20242060
async def get_script_context(self, params=None, headers=None):
20252061
"""
20262062
Returns all script contexts.
2063+
20272064
`<https://www.elastic.co/guide/en/elasticsearch/painless/master/painless-contexts.html>`_
20282065
"""
20292066
return await self.transport.perform_request(
@@ -2034,6 +2071,7 @@ async def get_script_context(self, params=None, headers=None):
20342071
async def get_script_languages(self, params=None, headers=None):
20352072
"""
20362073
Returns available script types, languages and contexts
2074+
20372075
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/modules-scripting.html>`_
20382076
"""
20392077
return await self.transport.perform_request(
@@ -2044,6 +2082,7 @@ async def get_script_languages(self, params=None, headers=None):
20442082
async def close_point_in_time(self, body=None, params=None, headers=None):
20452083
"""
20462084
Close a point in time
2085+
20472086
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/point-in-time-api.html>`_
20482087
20492088
:arg body: a point-in-time id to close
@@ -2058,6 +2097,7 @@ async def close_point_in_time(self, body=None, params=None, headers=None):
20582097
async def open_point_in_time(self, index=None, params=None, headers=None):
20592098
"""
20602099
Open a point in time that can be used in subsequent searches
2100+
20612101
`<https://www.elastic.co/guide/en/elasticsearch/reference/7.10/point-in-time-api.html>`_
20622102
20632103
:arg index: A comma-separated list of index names to open point

0 commit comments

Comments
 (0)