From ebd97d032208fa8fbb9840fdab42c386230a9e92 Mon Sep 17 00:00:00 2001
From: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com>
Date: Tue, 1 Nov 2022 09:11:59 -0400
Subject: [PATCH] Adds to mappings API (#1766)

Signed-off-by: Fanit Kolchina <kolchfa@amazon.com>

Signed-off-by: Fanit Kolchina <kolchfa@amazon.com>
---
 _opensearch/mappings.md | 79 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 77 insertions(+), 2 deletions(-)

diff --git a/_opensearch/mappings.md b/_opensearch/mappings.md
index d410fac2..d00d2ec6 100644
--- a/_opensearch/mappings.md
+++ b/_opensearch/mappings.md
@@ -4,7 +4,7 @@ title: Mapping
 nav_order: 13
 ---
 
-# About Mappings
+# Mapping
 
 You can define how documents and their fields are stored and indexed by creating a mapping.
 
@@ -45,6 +45,7 @@ numeric detection string | If disabled, OpenSearch may automatically process num
 If you know exactly what your field data types need to be, you can specify them in your request body when creating your index.
 
 ```json
+PUT sample-index1
 {
   "mappings": {
     "properties": {
@@ -65,6 +66,22 @@ If you know exactly what your field data types need to be, you can specify them
 }
 ```
 
+To add mappings to an existing index or data stream, you can send a request to the `_mapping` endpoint using the `PUT` or `POST` HTTP method:
+
+```json
+POST sample-index1/_mapping
+{
+  "properties": {
+    "year":    { "type" : "text" },
+    "age":     { "type" : "integer" },
+    "director":{ "type" : "text" }
+  }
+}
+```
+
+You cannot change the mapping of an existing field, you can only modify the field's mapping parameters. 
+{: .note}
+
 ---
 ## Mapping example usage
 
@@ -102,4 +119,62 @@ PUT _index_ip/_doc/<id>
 }
 ```
 
-This indexed ip_range does not throw an error because `ignore_malformed` is set to true.
\ No newline at end of file
+This indexed ip_range does not throw an error because `ignore_malformed` is set to true.
+
+## Get a mapping
+
+To get all mappings for one or more indexes, use the following request:
+
+```json
+GET <index>/_mapping
+```
+
+In the above request, `<index>` may be an index name or a comma-separated list of index names. 
+
+To get all mappings for all indexes, use the following request:
+
+```json
+GET _mapping
+```
+
+To get a mapping for a specific field, provide the index name and the field name:
+
+```json
+GET _mapping/field/<fields>
+GET /<index>/_mapping/field/<fields>
+```
+
+Both `<index>` and `<fields>` can be specified as one value or a comma-separated list.
+
+For example, the following request retrieves the mapping for the `year` and `age` fields in `sample-index1`:
+
+```json
+GET sample-index1/_mapping/field/year,age
+```
+
+The response contains the specified fields:
+
+```json
+{
+  "sample-index1" : {
+    "mappings" : {
+      "year" : {
+        "full_name" : "year",
+        "mapping" : {
+          "year" : {
+            "type" : "text"
+          }
+        }
+      },
+      "age" : {
+        "full_name" : "age",
+        "mapping" : {
+          "age" : {
+            "type" : "integer"
+          }
+        }
+      }
+    }
+  }
+}
+```
\ No newline at end of file