From 76abdfdf8b2fe66d9ca6650b9b6e5763b230e9c9 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 b0fcd330eb..29dcc77d25 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -106206,7 +106206,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 5ad889b983..395959dc99 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -62391,7 +62391,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 c30f355fda..5ea57c58ee 100644
--- a/output/schema/schema-serverless.json
+++ b/output/schema/schema-serverless.json
@@ -23635,6 +23635,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,
@@ -23661,7 +23665,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 b214304e1e..67eb1f4b3e 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -139717,6 +139717,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,
@@ -139743,7 +139747,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