From fe5d8b36e4f450ad4bced12790f487926d76d747 Mon Sep 17 00:00:00 2001
From: Quentin Pradet <quentin.pradet@elastic.co>
Date: Mon, 17 Mar 2025 12:44:59 +0400
Subject: [PATCH] Deprecate local param in indices.get_mapping (#3975)

(cherry picked from commit ea991724f4dd4f90c496eff547d3cc2e6529f509)
---
 output/openapi/elasticsearch-openapi.json                   | 2 +-
 output/openapi/elasticsearch-serverless-openapi.json        | 2 +-
 output/schema/schema-serverless.json                        | 6 +++++-
 output/schema/schema.json                                   | 6 +++++-
 .../indices/get_mapping/IndicesGetMappingRequest.ts         | 1 +
 5 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index 999def4f88..69fc491326 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -106149,7 +106149,7 @@
         "in": "query",
         "name": "local",
         "description": "If `true`, the request retrieves information from the local node only.",
-        "deprecated": false,
+        "deprecated": true,
         "schema": {
           "type": "boolean"
         },
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
index f127ddc860..1b055dd70a 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -62302,7 +62302,7 @@
         "in": "query",
         "name": "local",
         "description": "If `true`, the request retrieves information from the local node only.",
-        "deprecated": false,
+        "deprecated": true,
         "schema": {
           "type": "boolean"
         },
diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json
index 41abf58c36..2c5c85c6fc 100644
--- a/output/schema/schema-serverless.json
+++ b/output/schema/schema-serverless.json
@@ -23914,6 +23914,10 @@
           }
         },
         {
+          "deprecation": {
+            "description": "This parameter is a no-op and field mappings are always retrieved locally.",
+            "version": "7.8.0"
+          },
           "description": "If `true`, the request retrieves information from the local node only.",
           "name": "local",
           "required": false,
@@ -23940,7 +23944,7 @@
           }
         }
       ],
-      "specLocation": "indices/get_mapping/IndicesGetMappingRequest.ts#L24-L84"
+      "specLocation": "indices/get_mapping/IndicesGetMappingRequest.ts#L24-L85"
     },
     {
       "body": {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index b006511077..5b91ec3200 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -139620,6 +139620,10 @@
           }
         },
         {
+          "deprecation": {
+            "description": "This parameter is a no-op and field mappings are always retrieved locally.",
+            "version": "7.8.0"
+          },
           "description": "If `true`, the request retrieves information from the local node only.",
           "name": "local",
           "required": false,
@@ -139646,7 +139650,7 @@
           }
         }
       ],
-      "specLocation": "indices/get_mapping/IndicesGetMappingRequest.ts#L24-L84"
+      "specLocation": "indices/get_mapping/IndicesGetMappingRequest.ts#L24-L85"
     },
     {
       "kind": "response",
diff --git a/specification/indices/get_mapping/IndicesGetMappingRequest.ts b/specification/indices/get_mapping/IndicesGetMappingRequest.ts
index 95f8f89315..c5bc1467ee 100644
--- a/specification/indices/get_mapping/IndicesGetMappingRequest.ts
+++ b/specification/indices/get_mapping/IndicesGetMappingRequest.ts
@@ -71,6 +71,7 @@ export interface Request extends RequestBase {
     ignore_unavailable?: boolean
     /**
      * If `true`, the request retrieves information from the local node only.
+     * @deprecated 7.8.0 This parameter is a no-op and field mappings are always retrieved locally.
      * @server_default false
      */
     local?: boolean