Updated opensearch-py to reflect the latest OpenSearch API spec (2024-07-12) (#773)

Signed-off-by: GitHub <noreply@github.com>
Co-authored-by: saimedhi <saimedhi@users.noreply.github.com>
This commit is contained in:
opensearch-trigger-bot[bot]
2024-07-11 22:33:22 -07:00
committed by GitHub
parent 9ee0b23c63
commit 04a2350ba0
11 changed files with 37 additions and 30 deletions
+1
View File
@@ -10,6 +10,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
### Fixed
- Fixed Search helper to ensure proper retention of the _collapse attribute in chained operations. ([#771](https://github.com/opensearch-project/opensearch-py/pull/771))
### Updated APIs
- Updated opensearch-py APIs to reflect [opensearch-api-specification@d5ca873](https://github.com/opensearch-project/opensearch-api-specification/commit/d5ca873d20ff54be16ec48e7bd629cda7c4a6332)
- Updated opensearch-py APIs to reflect [opensearch-api-specification@7452827](https://github.com/opensearch-project/opensearch-api-specification/commit/745282767026703ea27967d2705633c3e2661c97)
- Updated opensearch-py APIs to reflect [opensearch-api-specification@f2afd71](https://github.com/opensearch-project/opensearch-api-specification/commit/f2afd7171406c7477fbd644d74087bb0e2948c75)
- Updated opensearch-py APIs to reflect [opensearch-api-specification@49cd814](https://github.com/opensearch-project/opensearch-api-specification/commit/49cd8140663f32f7c8b638ddc295683344edba61)
+6 -6
View File
@@ -339,9 +339,9 @@ class AsyncOpenSearch(Client):
:arg index: Name of the data stream or index to target. If the
target doesnt exist and matches the name or wildcard (`*`) pattern of
target doesn't exist and matches the name or wildcard (`*`) pattern of
an index template with a `data_stream` definition, this request creates
the data stream. If the target doesnt exist and doesnt match a data
the data stream. If the target doesn't exist and doesn't match a data
stream template, this request creates the index.
:arg id: Unique identifier for the document.
:arg body: The document
@@ -536,7 +536,7 @@ class AsyncOpenSearch(Client):
shards to make this operation visible to search, if `wait_for` then wait
for a refresh to make this operation visible to search, if `false` do
nothing with refreshes.Valid values: `true`, `false`, `wait_for`.
:arg require_alias: If `true`, the requests actions must target
:arg require_alias: If `true`, the request's actions must target
an index alias. Default is false.
:arg routing: Custom value used to route operations to a
specific shard.
@@ -1934,7 +1934,7 @@ class AsyncOpenSearch(Client):
:arg scroll: Specifies how long a consistent view of the index
should be maintained for scrolled search.
:arg slices: The number of slices this task should be divided
into.Defaults to 1 slice, meaning the task isnt sliced into subtasks.
into.Defaults to 1 slice, meaning the task isn't sliced into subtasks.
Valid choices are auto.
:arg source: The URL-encoded request definition. Useful for
libraries that do not accept a request body for non-POST requests.
@@ -2087,9 +2087,9 @@ class AsyncOpenSearch(Client):
statistics.
:arg pretty: Whether to pretty format the returned JSON
response.
:arg rest_total_hits_as_int: If true, the API responses
:arg rest_total_hits_as_int: If true, the API response's
hit.total property is returned as an integer. If false, the API
responses hit.total property is returned as an object. Default is
response's hit.total property is returned as an object. Default is
false.
:arg scroll: Period to retain the search context for scrolling.
:arg source: The URL-encoded request definition. Useful for
+2 -2
View File
@@ -288,7 +288,7 @@ class ClusterClient(NamespacedClient):
:arg timeout: Period to wait for each node to respond.If a node
does not respond before its timeout expires, the response does not
include its stats.However, timed out nodes are included in the
responses `_nodes.failed` property. Defaults to no timeout.
response's `_nodes.failed` property. Defaults to no timeout.
"""
return await self.transport.perform_request(
"GET",
@@ -656,7 +656,7 @@ class ClusterClient(NamespacedClient):
to configure backing indices for its data streams. If you use OpenSearch
Agent and want to overwrite one of these templates, set the `version`
for your replacement template higher than the current version. If you
dont use OpenSearch Agent and want to disable all built-in component
don't use OpenSearch Agent and want to disable all built-in component
and index templates, set `stack.templates.enabled` to `false` using the
cluster update settings API.
:arg body: The template definition
+6 -3
View File
@@ -749,8 +749,8 @@ class IndicesClient(NamespacedClient):
:arg index: Comma-separated list of data streams, indices, and
aliases used to limit the request. Supports wildcards (`*`). To target
all data streams and indices, omit this parameter or use `*` or `_all`.
aliases used to limit the request.Supports wildcards (`*`).To target all
data streams and indices, omit this parameter or use `*` or `_all`.
:arg allow_no_indices: If `false`, the request returns an error
if any wildcard expression, index alias, or `_all` value targets only
missing or closed indices.This behavior applies even if the request
@@ -874,7 +874,7 @@ class IndicesClient(NamespacedClient):
:arg index: Comma-separated list of data streams or indices to
add. Supports wildcards (`*`). Wildcard patterns that match both data
streams and indices return an error.
:arg name: Alias to update. If the alias doesnt exist, the
:arg name: Alias to update. If the alias doesn't exist, the
request creates it. Index alias names support date math.
:arg body: The settings for the alias, such as `routing` or
`filter`
@@ -1693,6 +1693,7 @@ class IndicesClient(NamespacedClient):
"expand_wildcards",
"fielddata",
"fields",
"file",
"filter_path",
"human",
"ignore_unavailable",
@@ -1728,6 +1729,8 @@ class IndicesClient(NamespacedClient):
`fields` parameter to clear the cache of specific fields only.
:arg fields: Comma-separated list of field names used to limit
the `fielddata` parameter.
:arg file: If true, clears the unused entries from the file
cache on nodes with the Search role. Default is false.
:arg filter_path: Comma-separated list of filters used to reduce
the response.
:arg human: Whether to return human readable values for
+1 -1
View File
@@ -204,7 +204,7 @@ class IngestClient(NamespacedClient):
:arg body: The simulate definition
:arg id: Pipeline to test. If you dont specify a `pipeline` in
:arg id: Pipeline to test. If you don't specify a `pipeline` in
the request body, this parameter is required.
:arg error_trace: Whether to include the stack trace of returned
errors.
+3 -3
View File
@@ -219,16 +219,16 @@ class TransformsClient(NamespacedClient):
errors.
:arg filter_path: Comma-separated list of filters used to reduce
the response.
:arg from_: The starting transform to return. Default is 0.
:arg from_: The starting transform to return. Default is `0`.
:arg human: Whether to return human readable values for
statistics.
:arg pretty: Whether to pretty format the returned JSON
response.
:arg search: The search term to use to filter results.
:arg size: Specifies the number of transforms to return. Default
is 10.
is `10`.
:arg sortDirection: Specifies the direction to sort results in.
Can be ASC or DESC. Default is ASC.
Can be `ASC` or `DESC`. Default is `ASC`.
:arg sortField: The field to sort results with.
:arg source: The URL-encoded request definition. Useful for
libraries that do not accept a request body for non-POST requests.
+6 -6
View File
@@ -339,9 +339,9 @@ class OpenSearch(Client):
:arg index: Name of the data stream or index to target. If the
target doesnt exist and matches the name or wildcard (`*`) pattern of
target doesn't exist and matches the name or wildcard (`*`) pattern of
an index template with a `data_stream` definition, this request creates
the data stream. If the target doesnt exist and doesnt match a data
the data stream. If the target doesn't exist and doesn't match a data
stream template, this request creates the index.
:arg id: Unique identifier for the document.
:arg body: The document
@@ -536,7 +536,7 @@ class OpenSearch(Client):
shards to make this operation visible to search, if `wait_for` then wait
for a refresh to make this operation visible to search, if `false` do
nothing with refreshes.Valid values: `true`, `false`, `wait_for`.
:arg require_alias: If `true`, the requests actions must target
:arg require_alias: If `true`, the request's actions must target
an index alias. Default is false.
:arg routing: Custom value used to route operations to a
specific shard.
@@ -1934,7 +1934,7 @@ class OpenSearch(Client):
:arg scroll: Specifies how long a consistent view of the index
should be maintained for scrolled search.
:arg slices: The number of slices this task should be divided
into.Defaults to 1 slice, meaning the task isnt sliced into subtasks.
into.Defaults to 1 slice, meaning the task isn't sliced into subtasks.
Valid choices are auto.
:arg source: The URL-encoded request definition. Useful for
libraries that do not accept a request body for non-POST requests.
@@ -2087,9 +2087,9 @@ class OpenSearch(Client):
statistics.
:arg pretty: Whether to pretty format the returned JSON
response.
:arg rest_total_hits_as_int: If true, the API responses
:arg rest_total_hits_as_int: If true, the API response's
hit.total property is returned as an integer. If false, the API
responses hit.total property is returned as an object. Default is
response's hit.total property is returned as an object. Default is
false.
:arg scroll: Period to retain the search context for scrolling.
:arg source: The URL-encoded request definition. Useful for
+2 -2
View File
@@ -288,7 +288,7 @@ class ClusterClient(NamespacedClient):
:arg timeout: Period to wait for each node to respond.If a node
does not respond before its timeout expires, the response does not
include its stats.However, timed out nodes are included in the
responses `_nodes.failed` property. Defaults to no timeout.
response's `_nodes.failed` property. Defaults to no timeout.
"""
return self.transport.perform_request(
"GET",
@@ -656,7 +656,7 @@ class ClusterClient(NamespacedClient):
to configure backing indices for its data streams. If you use OpenSearch
Agent and want to overwrite one of these templates, set the `version`
for your replacement template higher than the current version. If you
dont use OpenSearch Agent and want to disable all built-in component
don't use OpenSearch Agent and want to disable all built-in component
and index templates, set `stack.templates.enabled` to `false` using the
cluster update settings API.
:arg body: The template definition
+6 -3
View File
@@ -749,8 +749,8 @@ class IndicesClient(NamespacedClient):
:arg index: Comma-separated list of data streams, indices, and
aliases used to limit the request. Supports wildcards (`*`). To target
all data streams and indices, omit this parameter or use `*` or `_all`.
aliases used to limit the request.Supports wildcards (`*`).To target all
data streams and indices, omit this parameter or use `*` or `_all`.
:arg allow_no_indices: If `false`, the request returns an error
if any wildcard expression, index alias, or `_all` value targets only
missing or closed indices.This behavior applies even if the request
@@ -874,7 +874,7 @@ class IndicesClient(NamespacedClient):
:arg index: Comma-separated list of data streams or indices to
add. Supports wildcards (`*`). Wildcard patterns that match both data
streams and indices return an error.
:arg name: Alias to update. If the alias doesnt exist, the
:arg name: Alias to update. If the alias doesn't exist, the
request creates it. Index alias names support date math.
:arg body: The settings for the alias, such as `routing` or
`filter`
@@ -1693,6 +1693,7 @@ class IndicesClient(NamespacedClient):
"expand_wildcards",
"fielddata",
"fields",
"file",
"filter_path",
"human",
"ignore_unavailable",
@@ -1728,6 +1729,8 @@ class IndicesClient(NamespacedClient):
`fields` parameter to clear the cache of specific fields only.
:arg fields: Comma-separated list of field names used to limit
the `fielddata` parameter.
:arg file: If true, clears the unused entries from the file
cache on nodes with the Search role. Default is false.
:arg filter_path: Comma-separated list of filters used to reduce
the response.
:arg human: Whether to return human readable values for
+1 -1
View File
@@ -204,7 +204,7 @@ class IngestClient(NamespacedClient):
:arg body: The simulate definition
:arg id: Pipeline to test. If you dont specify a `pipeline` in
:arg id: Pipeline to test. If you don't specify a `pipeline` in
the request body, this parameter is required.
:arg error_trace: Whether to include the stack trace of returned
errors.
+3 -3
View File
@@ -219,16 +219,16 @@ class TransformsClient(NamespacedClient):
errors.
:arg filter_path: Comma-separated list of filters used to reduce
the response.
:arg from_: The starting transform to return. Default is 0.
:arg from_: The starting transform to return. Default is `0`.
:arg human: Whether to return human readable values for
statistics.
:arg pretty: Whether to pretty format the returned JSON
response.
:arg search: The search term to use to filter results.
:arg size: Specifies the number of transforms to return. Default
is 10.
is `10`.
:arg sortDirection: Specifies the direction to sort results in.
Can be ASC or DESC. Default is ASC.
Can be `ASC` or `DESC`. Default is `ASC`.
:arg sortField: The field to sort results with.
:arg source: The URL-encoded request definition. Useful for
libraries that do not accept a request body for non-POST requests.