elasticsearch 9.2.0__py3-none-any.whl → 9.3.0__py3-none-any.whl

elasticsearch/_sync/client/slm.py

@@ -40,8 +40,8 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Delete a policy.
-          Delete a snapshot lifecycle policy definition.
+          <p>Delete a policy.</p>
+          <p>Delete a snapshot lifecycle policy definition.
           This operation prevents any future snapshots from being taken but does not cancel in-progress snapshots or remove previously-taken snapshots.</p>
 
 
@@ -96,8 +96,8 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Run a policy.
-          Immediately create a snapshot according to the snapshot lifecycle policy without waiting for the scheduled time.
+          <p>Run a policy.</p>
+          <p>Immediately create a snapshot according to the snapshot lifecycle policy without waiting for the scheduled time.
           The snapshot policy is normally applied according to its schedule, but you might want to manually run a policy before performing an upgrade or other maintenance.</p>
 
 
@@ -151,8 +151,8 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Run a retention policy.
-          Manually apply the retention policy to force immediate removal of snapshots that are expired according to the snapshot lifecycle policy retention rules.
+          <p>Run a retention policy.</p>
+          <p>Manually apply the retention policy to force immediate removal of snapshots that are expired according to the snapshot lifecycle policy retention rules.
           The retention policy is normally applied according to its schedule.</p>
 
 
@@ -204,13 +204,13 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get policy information.
-          Get snapshot lifecycle policy definitions and information about the latest snapshot attempts.</p>
+          <p>Get policy information.</p>
+          <p>Get snapshot lifecycle policy definitions and information about the latest snapshot attempts.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-get-lifecycle>`_
 
-        :param policy_id: Comma-separated list of snapshot lifecycle policies to retrieve
+        :param policy_id: A comma-separated list of snapshot lifecycle policy identifiers.
         :param master_timeout: The period to wait for a connection to the master node.
             If no response is received before the timeout expires, the request fails
             and returns an error.
@@ -261,8 +261,8 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get snapshot lifecycle management statistics.
-          Get global and policy-level statistics about actions taken by snapshot lifecycle management.</p>
+          <p>Get snapshot lifecycle management statistics.</p>
+          <p>Get global and policy-level statistics about actions taken by snapshot lifecycle management.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-get-stats>`_
@@ -373,8 +373,8 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Create or update a policy.
-          Create or update a snapshot lifecycle policy.
+          <p>Create or update a policy.</p>
+          <p>Create or update a snapshot lifecycle policy.
           If the policy already exists, this request increments the policy version.
           Only the latest version of a policy is stored.</p>
 
@@ -456,8 +456,8 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Start snapshot lifecycle management.
-          Snapshot lifecycle management (SLM) starts automatically when a cluster is formed.
+          <p>Start snapshot lifecycle management.</p>
+          <p>Snapshot lifecycle management (SLM) starts automatically when a cluster is formed.
           Manually starting SLM is necessary only if it has been stopped using the stop SLM API.</p>
 
 
@@ -510,8 +510,8 @@ class SlmClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Stop snapshot lifecycle management.
-          Stop all snapshot lifecycle management (SLM) operations and the SLM plugin.
+          <p>Stop snapshot lifecycle management.</p>
+          <p>Stop all snapshot lifecycle management (SLM) operations and the SLM plugin.
           This API is useful when you are performing maintenance on a cluster and need to prevent SLM from performing any actions on your data streams or indices.
           Stopping SLM does not stop any snapshots that are in progress.
           You can manually trigger snapshots with the run snapshot lifecycle policy API even if SLM is stopped.</p>

elasticsearch/_sync/client/snapshot.py

@@ -23,9 +23,9 @@ from ._base import NamespacedClient
 from .utils import (
     SKIP_IN_PATH,
     Stability,
+    _availability_warning,
     _quote,
     _rewrite_parameters,
-    _stability_warning,
 )
 
 
@@ -46,8 +46,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Clean up the snapshot repository.
-          Trigger the review of the contents of a snapshot repository and delete any stale data not referenced by existing snapshots.</p>
+          <p>Clean up the snapshot repository.</p>
+          <p>Trigger the review of the contents of a snapshot repository and delete any stale data not referenced by existing snapshots.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-cleanup-repository>`_
@@ -110,8 +110,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Clone a snapshot.
-          Clone part of all of a snapshot into another snapshot in the same repository.</p>
+          <p>Clone a snapshot.</p>
+          <p>Clone part of all of a snapshot into another snapshot in the same repository.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-clone>`_
@@ -207,8 +207,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Create a snapshot.
-          Take a snapshot of a cluster or of data streams and indices.</p>
+          <p>Create a snapshot.</p>
+          <p>Take a snapshot of a cluster or of data streams and indices.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-create>`_
@@ -330,8 +330,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Create or update a snapshot repository.
-          IMPORTANT: If you are migrating searchable snapshots, the repository name must be identical in the source and destination clusters.
+          <p>Create or update a snapshot repository.</p>
+          <p>IMPORTANT: If you are migrating searchable snapshots, the repository name must be identical in the source and destination clusters.
           To register a snapshot repository, the cluster's global metadata must be writeable.
           Ensure there are no cluster blocks (for example, <code>cluster.blocks.read_only</code> and <code>clsuter.blocks.read_only_allow_delete</code> settings) that prevent write access.</p>
           <p>Several options for this API can be specified using a query parameter or a request body parameter.
@@ -397,7 +397,7 @@ class SnapshotClient(NamespacedClient):
         self,
         *,
         repository: str,
-        snapshot: str,
+        snapshot: t.Union[str, t.Sequence[str]],
         error_trace: t.Optional[bool] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
@@ -470,8 +470,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Delete snapshot repositories.
-          When a repository is unregistered, Elasticsearch removes only the reference to the location where the repository is storing the snapshots.
+          <p>Delete snapshot repositories.</p>
+          <p>When a repository is unregistered, Elasticsearch removes only the reference to the location where the repository is storing the snapshots.
           The snapshots themselves are left untouched and in place.</p>
 
 
@@ -955,7 +955,7 @@ class SnapshotClient(NamespacedClient):
         )
 
     @_rewrite_parameters()
-    @_stability_warning(Stability.EXPERIMENTAL)
+    @_availability_warning(Stability.EXPERIMENTAL)
     def repository_verify_integrity(
         self,
         *,
@@ -976,8 +976,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Verify the repository integrity.
-          Verify the integrity of the contents of a snapshot repository.</p>
+          <p>Verify the repository integrity.</p>
+          <p>Verify the integrity of the contents of a snapshot repository.</p>
           <p>This API enables you to perform a comprehensive check of the contents of a repository, looking for any anomalies in its data or metadata which might prevent you from restoring snapshots from the repository or which might cause future snapshot create or delete operations to fail.</p>
           <p>If you suspect the integrity of the contents of one of your snapshot repositories, cease all write activity to this repository immediately, set its <code>read_only</code> option to <code>true</code>, and use this API to verify its integrity.
           Until you do so:</p>
@@ -1115,8 +1115,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Restore a snapshot.
-          Restore a snapshot of a cluster or data streams and indices.</p>
+          <p>Restore a snapshot.</p>
+          <p>Restore a snapshot of a cluster or data streams and indices.</p>
           <p>You can restore a snapshot only to a running cluster with an elected master node.
           The snapshot repository must be registered and available to the cluster.
           The snapshot and cluster versions must be compatible.</p>
@@ -1264,8 +1264,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get the snapshot status.
-          Get a detailed description of the current state for each shard participating in the snapshot.</p>
+          <p>Get the snapshot status.</p>
+          <p>Get a detailed description of the current state for each shard participating in the snapshot.</p>
           <p>Note that this API should be used only to obtain detailed shard-level information for ongoing snapshots.
           If this detail is not needed or you want to obtain information about one or more existing snapshots, use the get snapshot API.</p>
           <p>If you omit the <code>&lt;snapshot&gt;</code> request path parameter, the request retrieves information only for currently running snapshots.
@@ -1347,8 +1347,8 @@ class SnapshotClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Verify a snapshot repository.
-          Check for common misconfigurations in a snapshot repository.</p>
+          <p>Verify a snapshot repository.</p>
+          <p>Check for common misconfigurations in a snapshot repository.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-verify-repository>`_

elasticsearch/_sync/client/sql.py

@@ -89,8 +89,8 @@ class SqlClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Delete an async SQL search.
-          Delete an async SQL search or a stored synchronous SQL search.
+          <p>Delete an async SQL search.</p>
+          <p>Delete an async SQL search or a stored synchronous SQL search.
           If the search is still running, the API cancels it.</p>
           <p>If the Elasticsearch security features are enabled, only the following users can use this API to delete a search:</p>
           <ul>
@@ -145,8 +145,8 @@ class SqlClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get async SQL search results.
-          Get the current status and available results for an async SQL search or stored synchronous SQL search.</p>
+          <p>Get async SQL search results.</p>
+          <p>Get the current status and available results for an async SQL search or stored synchronous SQL search.</p>
           <p>If the Elasticsearch security features are enabled, only the user who first submitted the SQL search can retrieve the search using this API.</p>
 
 
@@ -208,8 +208,8 @@ class SqlClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get the async SQL search status.
-          Get the current status of an async SQL search or a stored synchronous SQL search.</p>
+          <p>Get the async SQL search status.</p>
+          <p>Get the current status of an async SQL search or a stored synchronous SQL search.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-get-async-status>`_
@@ -253,6 +253,7 @@ class SqlClient(NamespacedClient):
             "keep_on_completion",
             "page_timeout",
             "params",
+            "project_routing",
             "query",
             "request_timeout",
             "runtime_mappings",
@@ -298,8 +299,8 @@ class SqlClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get SQL search results.
-          Run an SQL request.</p>
+          <p>Get SQL search results.</p>
+          <p>Run an SQL request.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-query>`_
@@ -333,10 +334,10 @@ class SqlClient(NamespacedClient):
             is no longer available. Subsequent scroll requests prolong the lifetime of
             the scroll cursor by the duration of `page_timeout` in the scroll request.
         :param params: The values for parameters in the query.
-        :param project_routing: Specifies a subset of projects to target for the search
-            using project metadata tags in a subset of Lucene query syntax. Allowed Lucene
-            queries: the _alias tag and a single value (possibly wildcarded). Examples:
-            _alias:my-project _alias:_origin _alias:*pr* Supported in serverless only.
+        :param project_routing: Specifies a subset of projects to target using project
+            metadata tags in a subset of Lucene query syntax. Allowed Lucene queries:
+            the _alias tag and a single value (possibly wildcarded). Examples: _alias:my-project
+            _alias:_origin _alias:*pr* Supported in serverless only.
         :param query: The SQL query to run.
         :param request_timeout: The timeout before the request fails.
         :param runtime_mappings: One or more runtime fields for the search request. These
@@ -362,8 +363,6 @@ class SqlClient(NamespacedClient):
             __query["human"] = human
         if pretty is not None:
             __query["pretty"] = pretty
-        if project_routing is not None:
-            __query["project_routing"] = project_routing
         if not __body:
             if allow_partial_search_results is not None:
                 __body["allow_partial_search_results"] = allow_partial_search_results
@@ -389,6 +388,8 @@ class SqlClient(NamespacedClient):
                 __body["page_timeout"] = page_timeout
             if params is not None:
                 __body["params"] = params
+            if project_routing is not None:
+                __body["project_routing"] = project_routing
             if query is not None:
                 __body["query"] = query
             if request_timeout is not None:
@@ -429,8 +430,8 @@ class SqlClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Translate SQL into Elasticsearch queries.
-          Translate an SQL search into a search API request containing Query DSL.
+          <p>Translate SQL into Elasticsearch queries.</p>
+          <p>Translate an SQL search into a search API request containing Query DSL.
           It accepts the same request body parameters as the SQL search API, excluding <code>cursor</code>.</p>
 
 

elasticsearch/_sync/client/streams.py

@@ -15,7 +15,6 @@
 #  specific language governing permissions and limitations
 #  under the License.
 
-
 import typing as t
 
 from elastic_transport import ObjectApiResponse, TextApiResponse
@@ -23,15 +22,15 @@ from elastic_transport import ObjectApiResponse, TextApiResponse
 from ._base import NamespacedClient
 from .utils import (
     Stability,
+    _availability_warning,
     _rewrite_parameters,
-    _stability_warning,
 )
 
 
 class StreamsClient(NamespacedClient):
 
     @_rewrite_parameters()
-    @_stability_warning(Stability.EXPERIMENTAL)
+    @_availability_warning(Stability.EXPERIMENTAL)
     def logs_disable(
         self,
         *,
@@ -72,7 +71,7 @@ class StreamsClient(NamespacedClient):
             __query["pretty"] = pretty
         if timeout is not None:
             __query["timeout"] = timeout
-        __headers = {"accept": "application/json,text/plain"}
+        __headers = {"accept": "text/plain,application/json"}
         return self.perform_request(  # type: ignore[return-value]
             "POST",
             __path,
@@ -83,7 +82,7 @@ class StreamsClient(NamespacedClient):
         )
 
     @_rewrite_parameters()
-    @_stability_warning(Stability.EXPERIMENTAL)
+    @_availability_warning(Stability.EXPERIMENTAL)
     def logs_enable(
         self,
         *,
@@ -127,7 +126,7 @@ class StreamsClient(NamespacedClient):
             __query["pretty"] = pretty
         if timeout is not None:
             __query["timeout"] = timeout
-        __headers = {"accept": "application/json,text/plain"}
+        __headers = {"accept": "text/plain,application/json"}
         return self.perform_request(  # type: ignore[return-value]
             "POST",
             __path,
@@ -138,7 +137,7 @@ class StreamsClient(NamespacedClient):
         )
 
     @_rewrite_parameters()
-    @_stability_warning(Stability.EXPERIMENTAL)
+    @_availability_warning(Stability.EXPERIMENTAL)
     def status(
         self,
         *,

elasticsearch/_sync/client/synonyms.py

@@ -95,8 +95,8 @@ class SynonymsClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Delete a synonym rule.
-          Delete a synonym rule from a synonym set.</p>
+          <p>Delete a synonym rule.</p>
+          <p>Delete a synonym rule from a synonym set.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-delete-synonym-rule>`_
@@ -204,8 +204,8 @@ class SynonymsClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get a synonym rule.
-          Get a synonym rule from a synonym set.</p>
+          <p>Get a synonym rule.</p>
+          <p>Get a synonym rule from a synonym set.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-get-synonym-rule>`_
@@ -257,8 +257,8 @@ class SynonymsClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get all synonym sets.
-          Get a summary of all defined synonym sets.</p>
+          <p>Get all synonym sets.</p>
+          <p>Get a summary of all defined synonym sets.</p>
 
 
         `<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-get-synonym>`_
@@ -311,8 +311,8 @@ class SynonymsClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Create or update a synonym set.
-          Synonyms sets are limited to a maximum of 10,000 synonym rules per set.
+          <p>Create or update a synonym set.</p>
+          <p>Synonyms sets are limited to a maximum of 10,000 synonym rules per set.
           If you need to manage more synonym rules, you can create multiple synonym sets.</p>
           <p>When an existing synonyms set is updated, the search analyzers that use the synonyms set are reloaded automatically for all indices.
           This is equivalent to invoking the reload search analyzers API for all indices that use the synonyms set.</p>
@@ -378,8 +378,8 @@ class SynonymsClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Create or update a synonym rule.
-          Create or update a synonym rule in a synonym set.</p>
+          <p>Create or update a synonym rule.</p>
+          <p>Create or update a synonym rule in a synonym set.</p>
           <p>If any of the synonym rules included is invalid, the API returns an error.</p>
           <p>When you update a synonym rule, all analyzers using the synonyms set will be reloaded automatically to reflect the new rule.</p>
 

elasticsearch/_sync/client/tasks.py

@@ -23,16 +23,16 @@ from ._base import NamespacedClient
 from .utils import (
     SKIP_IN_PATH,
     Stability,
+    _availability_warning,
     _quote,
     _rewrite_parameters,
-    _stability_warning,
 )
 
 
 class TasksClient(NamespacedClient):
 
     @_rewrite_parameters()
-    @_stability_warning(Stability.EXPERIMENTAL)
+    @_availability_warning(Stability.EXPERIMENTAL)
     def cancel(
         self,
         *,
@@ -106,7 +106,7 @@ class TasksClient(NamespacedClient):
         )
 
     @_rewrite_parameters()
-    @_stability_warning(Stability.EXPERIMENTAL)
+    @_availability_warning(Stability.EXPERIMENTAL)
     def get(
         self,
         *,
@@ -121,8 +121,8 @@ class TasksClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get task information.
-          Get information about a task currently running in the cluster.</p>
+          <p>Get task information.</p>
+          <p>Get information about a task currently running in the cluster.</p>
           <p>WARNING: The task management API is new and should still be considered a beta feature.
           The API may change in ways that are not backwards compatible.</p>
           <p>If the task identifier is not found, a 404 response code indicates that there are no resources that match the request.</p>
@@ -164,7 +164,7 @@ class TasksClient(NamespacedClient):
         )
 
     @_rewrite_parameters()
-    @_stability_warning(Stability.EXPERIMENTAL)
+    @_availability_warning(Stability.EXPERIMENTAL)
     def list(
         self,
         *,
@@ -185,8 +185,8 @@ class TasksClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Get all tasks.
-          Get information about the tasks currently running on one or more nodes in the cluster.</p>
+          <p>Get all tasks.</p>
+          <p>Get information about the tasks currently running on one or more nodes in the cluster.</p>
           <p>WARNING: The task management API is new and should still be considered a beta feature.
           The API may change in ways that are not backwards compatible.</p>
           <p><strong>Identifying running tasks</strong></p>

elasticsearch/_sync/client/text_structure.py

@@ -31,7 +31,7 @@ class TextStructureClient(NamespacedClient):
         *,
         field: str,
         index: str,
-        column_names: t.Optional[str] = None,
+        column_names: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         delimiter: t.Optional[str] = None,
         documents_to_sample: t.Optional[int] = None,
         ecs_compatibility: t.Optional[t.Union[str, t.Literal["disabled", "v1"]]] = None,
@@ -55,8 +55,8 @@ class TextStructureClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Find the structure of a text field.
-          Find the structure of a text field in an Elasticsearch index.</p>
+          <p>Find the structure of a text field.</p>
+          <p>Find the structure of a text field in an Elasticsearch index.</p>
           <p>This API provides a starting point for extracting further information from log messages already ingested into Elasticsearch.
           For example, if you have ingested data into a very simple index that has just <code>@timestamp</code> and message fields, you can use this API to see what common structure exists in the message field.</p>
           <p>The response from the API contains:</p>
@@ -217,7 +217,7 @@ class TextStructureClient(NamespacedClient):
         self,
         *,
         messages: t.Optional[t.Sequence[str]] = None,
-        column_names: t.Optional[str] = None,
+        column_names: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         delimiter: t.Optional[str] = None,
         ecs_compatibility: t.Optional[t.Union[str, t.Literal["disabled", "v1"]]] = None,
         error_trace: t.Optional[bool] = None,
@@ -241,8 +241,8 @@ class TextStructureClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Find the structure of text messages.
-          Find the structure of a list of text messages.
+          <p>Find the structure of text messages.</p>
+          <p>Find the structure of a list of text messages.
           The messages must contain data that is suitable to be ingested into Elasticsearch.</p>
           <p>This API provides a starting point for ingesting data into Elasticsearch in a format that is suitable for subsequent use with other Elastic Stack functionality.
           Use this API rather than the find text structure API if your input text has already been split up into separate messages by some other process.</p>
@@ -398,11 +398,15 @@ class TextStructureClient(NamespacedClient):
         text_files: t.Optional[t.Sequence[t.Any]] = None,
         body: t.Optional[t.Sequence[t.Any]] = None,
         charset: t.Optional[str] = None,
-        column_names: t.Optional[str] = None,
+        column_names: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         delimiter: t.Optional[str] = None,
         ecs_compatibility: t.Optional[str] = None,
         explain: t.Optional[bool] = None,
-        format: t.Optional[str] = None,
+        format: t.Optional[
+            t.Union[
+                str, t.Literal["delimited", "ndjson", "semi_structured_text", "xml"]
+            ]
+        ] = None,
         grok_pattern: t.Optional[str] = None,
         has_header_row: t.Optional[bool] = None,
         line_merge_size_limit: t.Optional[int] = None,
@@ -416,8 +420,8 @@ class TextStructureClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Find the structure of a text file.
-          The text file must contain data that is suitable to be ingested into Elasticsearch.</p>
+          <p>Find the structure of a text file.</p>
+          <p>The text file must contain data that is suitable to be ingested into Elasticsearch.</p>
           <p>This API provides a starting point for ingesting data into Elasticsearch in a format that is suitable for subsequent use with other Elastic Stack functionality.
           Unlike other Elasticsearch endpoints, the data that is posted to this endpoint does not need to be UTF-8 encoded and in JSON format.
           It must, however, be text; binary text formats are not currently supported.
@@ -615,8 +619,8 @@ class TextStructureClient(NamespacedClient):
         """
         .. raw:: html
 
-          <p>Test a Grok pattern.
-          Test a Grok pattern on one or more lines of text.
+          <p>Test a Grok pattern.</p>
+          <p>Test a Grok pattern on one or more lines of text.
           The API indicates whether the lines match the pattern together with the offsets and lengths of the matched substrings.</p>