Regenerate API from latest spec (#14)

Author: JoshMock

elasticsearch_serverless/_async/client/__init__.py

@@ -40,7 +40,7 @@ async def delete(
         Deletes an async search by ID. If the search is still running, the search request
         will be cancelled. Otherwise, the saved search results are deleted.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/async-search.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_
 
         :param id: A unique identifier for the async search.
         """
@@ -82,7 +82,7 @@ async def get(
         Retrieves the results of a previously submitted async search request given its
         ID.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/async-search.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_
 
         :param id: A unique identifier for the async search.
         :param keep_alive: Specifies how long the async search should be available in
@@ -139,7 +139,7 @@ async def status(
         Retrieves the status of a previously submitted async search request given its
         ID.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/async-search.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_
 
         :param id: A unique identifier for the async search.
         """
@@ -310,7 +310,7 @@ async def submit(
         """
         Executes a search request asynchronously.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/async-search.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_
 
         :param index: A comma-separated list of index names to search; use `_all` or
             empty string to perform the operation on all indices

elasticsearch_serverless/_async/client/async_search.py

@@ -67,7 +67,7 @@ async def aliases(
         Shows information about currently configured aliases to indices including filter
         and routing infos.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-alias.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-alias.html>`_
 
         :param name: A comma-separated list of aliases to retrieve. Supports wildcards
             (`*`). To retrieve all aliases, omit this parameter or use `*` or `_all`.
@@ -146,7 +146,7 @@ async def component_templates(
         """
         Returns information about existing component_templates templates.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-component-templates.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-component-templates.html>`_
 
         :param name: The name of the component template. Accepts wildcard expressions.
             If omitted, all component templates are returned.
@@ -222,7 +222,7 @@ async def count(
         Provides quick access to the document count of the entire cluster, or individual
         indices.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-count.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-count.html>`_
 
         :param index: Comma-separated list of data streams, indices, and aliases used
             to limit the request. Supports wildcards (`*`). To target all data streams
@@ -297,7 +297,7 @@ async def help(
         """
         Returns help for the Cat APIs.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat.html>`_
 
         :param format: Specifies the format to return the columnar data in, can be set
             to `text`, `json`, `cbor`, `yaml`, or `smile`.
@@ -395,7 +395,7 @@ async def indices(
         Returns information about indices: number of primaries and replicas, document
         counts, disk size, ...
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-indices.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-indices.html>`_
 
         :param index: Comma-separated list of data streams, indices, and aliases used
             to limit the request. Supports wildcards (`*`). To target all data streams
@@ -540,7 +540,7 @@ async def ml_data_frame_analytics(
         """
         Gets configuration and usage information about data frame analytics jobs.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-dfanalytics.html>`_
 
         :param id: The ID of the data frame analytics to fetch
         :param allow_no_match: Whether to ignore if a wildcard expression matches no
@@ -671,7 +671,7 @@ async def ml_datafeeds(
         """
         Gets configuration and usage information about datafeeds.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-datafeeds.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-datafeeds.html>`_
 
         :param datafeed_id: A numerical character string that uniquely identifies the
             datafeed.
@@ -808,7 +808,7 @@ async def ml_jobs(
         """
         Gets configuration and usage information about anomaly detection jobs.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-anomaly-detectors.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-anomaly-detectors.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param allow_no_match: Specifies what to do when the request: * Contains wildcard
@@ -948,7 +948,7 @@ async def ml_trained_models(
         """
         Gets configuration and usage information about inference trained models.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-trained-model.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-trained-model.html>`_
 
         :param model_id: A unique identifier for the trained model.
         :param allow_no_match: Specifies what to do when the request: contains wildcard
@@ -1091,7 +1091,7 @@ async def transforms(
         """
         Gets configuration and usage information about transforms.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cat-transforms.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-transforms.html>`_
 
         :param transform_id: A transform identifier or a wildcard expression. If you
             do not specify one of these options, the API returns information for all

elasticsearch_serverless/_async/client/cat.py

@@ -43,7 +43,7 @@ async def delete_component_template(
         """
         Deletes a component template
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/indices-component-template.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-component-template.html>`_
 
         :param name: Comma-separated list or wildcard expression of component template
             names used to limit the request.
@@ -93,7 +93,7 @@ async def exists_component_template(
         """
         Returns information about whether a particular component template exist
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/indices-component-template.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-component-template.html>`_
 
         :param name: Comma-separated list of component template names used to limit the
             request. Wildcard (*) expressions are supported.
@@ -146,7 +146,7 @@ async def get_component_template(
         """
         Returns one or more component templates
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/indices-component-template.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-component-template.html>`_
 
         :param name: Comma-separated list of component template names used to limit the
             request. Wildcard (`*`) expressions are supported.
@@ -185,60 +185,6 @@ async def get_component_template(
             "GET", __path, params=__query, headers=__headers
         )
 
-    @_rewrite_parameters()
-    async def get_settings(
-        self,
-        *,
-        error_trace: t.Optional[bool] = None,
-        filter_path: t.Optional[
-            t.Union[str, t.Union[t.List[str], t.Tuple[str, ...]]]
-        ] = None,
-        flat_settings: t.Optional[bool] = None,
-        human: t.Optional[bool] = None,
-        include_defaults: t.Optional[bool] = None,
-        master_timeout: t.Optional[
-            t.Union["t.Literal[-1]", "t.Literal[0]", str]
-        ] = None,
-        pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
-    ) -> ObjectApiResponse[t.Any]:
-        """
-        Returns cluster settings.
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cluster-get-settings.html>`_
-
-        :param flat_settings: If `true`, returns settings in flat format.
-        :param include_defaults: If `true`, returns default cluster settings from the
-            local node.
-        :param master_timeout: 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.
-        :param timeout: Period to wait for a response. If no response is received before
-            the timeout expires, the request fails and returns an error.
-        """
-        __path = "/_cluster/settings"
-        __query: t.Dict[str, t.Any] = {}
-        if error_trace is not None:
-            __query["error_trace"] = error_trace
-        if filter_path is not None:
-            __query["filter_path"] = filter_path
-        if flat_settings is not None:
-            __query["flat_settings"] = flat_settings
-        if human is not None:
-            __query["human"] = human
-        if include_defaults is not None:
-            __query["include_defaults"] = include_defaults
-        if master_timeout is not None:
-            __query["master_timeout"] = master_timeout
-        if pretty is not None:
-            __query["pretty"] = pretty
-        if timeout is not None:
-            __query["timeout"] = timeout
-        __headers = {"accept": "application/json"}
-        return await self.perform_request(  # type: ignore[return-value]
-            "GET", __path, params=__query, headers=__headers
-        )
-
     @_rewrite_parameters()
     async def info(
         self,
@@ -273,7 +219,7 @@ async def info(
         """
         Returns different information about the cluster.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cluster-info.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-info.html>`_
 
         :param target: Limits the information returned to the specific target. Supports
             a comma-separated list, such as http,ingest.
@@ -295,52 +241,6 @@ async def info(
             "GET", __path, params=__query, headers=__headers
         )
 
-    @_rewrite_parameters()
-    async def pending_tasks(
-        self,
-        *,
-        error_trace: t.Optional[bool] = None,
-        filter_path: t.Optional[
-            t.Union[str, t.Union[t.List[str], t.Tuple[str, ...]]]
-        ] = None,
-        human: t.Optional[bool] = None,
-        local: t.Optional[bool] = None,
-        master_timeout: t.Optional[
-            t.Union["t.Literal[-1]", "t.Literal[0]", str]
-        ] = None,
-        pretty: t.Optional[bool] = None,
-    ) -> ObjectApiResponse[t.Any]:
-        """
-        Returns a list of any cluster-level changes (e.g. create index, update mapping,
-        allocate or fail shard) which have not yet been executed.
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cluster-pending.html>`_
-
-        :param local: If `true`, the request retrieves information from the local node
-            only. If `false`, information is retrieved from the master node.
-        :param master_timeout: 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.
-        """
-        __path = "/_cluster/pending_tasks"
-        __query: t.Dict[str, t.Any] = {}
-        if error_trace is not None:
-            __query["error_trace"] = error_trace
-        if filter_path is not None:
-            __query["filter_path"] = filter_path
-        if human is not None:
-            __query["human"] = human
-        if local is not None:
-            __query["local"] = local
-        if master_timeout is not None:
-            __query["master_timeout"] = master_timeout
-        if pretty is not None:
-            __query["pretty"] = pretty
-        __headers = {"accept": "application/json"}
-        return await self.perform_request(  # type: ignore[return-value]
-            "GET", __path, params=__query, headers=__headers
-        )
-
     @_rewrite_parameters(
         body_fields=True,
         parameter_aliases={"_meta": "meta"},
@@ -367,7 +267,7 @@ async def put_component_template(
         """
         Creates or updates a component template
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/indices-component-template.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-component-template.html>`_
 
         :param name: Name of the component template to create. Elasticsearch includes
             the following built-in component templates: `logs-mappings`; 'logs-settings`;
@@ -429,111 +329,3 @@ async def put_component_template(
         return await self.perform_request(  # type: ignore[return-value]
             "PUT", __path, params=__query, headers=__headers, body=__body
         )
-
-    @_rewrite_parameters(
-        body_fields=True,
-    )
-    async def put_settings(
-        self,
-        *,
-        error_trace: t.Optional[bool] = None,
-        filter_path: t.Optional[
-            t.Union[str, t.Union[t.List[str], t.Tuple[str, ...]]]
-        ] = None,
-        flat_settings: t.Optional[bool] = None,
-        human: t.Optional[bool] = None,
-        master_timeout: t.Optional[
-            t.Union["t.Literal[-1]", "t.Literal[0]", str]
-        ] = None,
-        persistent: t.Optional[t.Mapping[str, t.Any]] = None,
-        pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
-        transient: t.Optional[t.Mapping[str, t.Any]] = None,
-    ) -> ObjectApiResponse[t.Any]:
-        """
-        Updates the cluster settings.
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cluster-update-settings.html>`_
-
-        :param flat_settings: Return settings in flat format (default: false)
-        :param master_timeout: Explicit operation timeout for connection to master node
-        :param persistent:
-        :param timeout: Explicit operation timeout
-        :param transient:
-        """
-        __path = "/_cluster/settings"
-        __query: t.Dict[str, t.Any] = {}
-        __body: t.Dict[str, t.Any] = {}
-        if error_trace is not None:
-            __query["error_trace"] = error_trace
-        if filter_path is not None:
-            __query["filter_path"] = filter_path
-        if flat_settings is not None:
-            __query["flat_settings"] = flat_settings
-        if human is not None:
-            __query["human"] = human
-        if master_timeout is not None:
-            __query["master_timeout"] = master_timeout
-        if persistent is not None:
-            __body["persistent"] = persistent
-        if pretty is not None:
-            __query["pretty"] = pretty
-        if timeout is not None:
-            __query["timeout"] = timeout
-        if transient is not None:
-            __body["transient"] = transient
-        __headers = {"accept": "application/json", "content-type": "application/json"}
-        return await self.perform_request(  # type: ignore[return-value]
-            "PUT", __path, params=__query, headers=__headers, body=__body
-        )
-
-    @_rewrite_parameters()
-    async def stats(
-        self,
-        *,
-        node_id: t.Optional[
-            t.Union[str, t.Union[t.List[str], t.Tuple[str, ...]]]
-        ] = None,
-        error_trace: t.Optional[bool] = None,
-        filter_path: t.Optional[
-            t.Union[str, t.Union[t.List[str], t.Tuple[str, ...]]]
-        ] = None,
-        flat_settings: t.Optional[bool] = None,
-        human: t.Optional[bool] = None,
-        pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
-    ) -> ObjectApiResponse[t.Any]:
-        """
-        Returns high-level overview of cluster statistics.
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/generated/cluster-stats.html>`_
-
-        :param node_id: Comma-separated list of node filters used to limit returned information.
-            Defaults to all nodes in the cluster.
-        :param flat_settings: If `true`, returns settings in flat format.
-        :param 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 response’s `_nodes.failed` property.
-            Defaults to no timeout.
-        """
-        if node_id not in SKIP_IN_PATH:
-            __path = f"/_cluster/stats/nodes/{_quote(node_id)}"
-        else:
-            __path = "/_cluster/stats"
-        __query: t.Dict[str, t.Any] = {}
-        if error_trace is not None:
-            __query["error_trace"] = error_trace
-        if filter_path is not None:
-            __query["filter_path"] = filter_path
-        if flat_settings is not None:
-            __query["flat_settings"] = flat_settings
-        if human is not None:
-            __query["human"] = human
-        if pretty is not None:
-            __query["pretty"] = pretty
-        if timeout is not None:
-            __query["timeout"] = timeout
-        __headers = {"accept": "application/json"}
-        return await self.perform_request(  # type: ignore[return-value]
-            "GET", __path, params=__query, headers=__headers
-        )