Add example for update license

Author: lcawl

docs/overlays/elasticsearch-openapi-overlays.yaml

@@ -432,4 +432,20 @@ actions:
             application/json:
               examples:
                 startTrialLicenseResponseExample1:
-                  $ref: "../../specification/license/post_start_trial/StartTrialLicenseResponseExample1.yaml"
+                  $ref: "../../specification/license/post_start_trial/StartTrialLicenseResponseExample1.yaml"
+  - target: "$.components['requestBodies']['license.post']"
+    description: "Add examples for update license request"
+    update: 
+      content: 
+        application/json: 
+          examples: 
+            updateLicenseRequestExample1: 
+              $ref: "../../specification/license/post/PostLicenseRequestExample1.yaml"
+  - target: "$.components['responses']['license.post#200']"
+    description: "Add examples for update license response"
+    update: 
+      content:
+        application/json:
+          examples:
+            clusterHealthResponseExample1:
+              $ref: "../../specification/license/post/PostLicenseResponseExample1.yaml"

specification/license/post/PostLicenseRequestExample1.yaml

@@ -1,7 +1,8 @@
-summary: licensing/update-license.asciidoc:63
-method_request: PUT _license
-description: ''
-type: request
+# summary: licensing/update-license.asciidoc:63
+# method_request: PUT _license
+description: >
+  Run `PUT _license` to update to a basic license. NOTE: These values are invalid; you must substitute the appropriate contents from your license file.
+# type: request
 value:
   "{\n  \"licenses\": [\n    {\n      \"uid\":\"893361dc-9749-4997-93cb-802e3d7fa4xx\"\
   ,\n      \"type\":\"basic\",\n      \"issue_date_in_millis\":1411948800000,\n  \

specification/license/post/PostLicenseRequestExample2.yaml

@@ -0,0 +1,15 @@
+# summary: licensing/get-trial-status.asciidoc:47
+description: If you update to a basic license and you previously had a license with more features, you receive this type of response. You must re-submit the API request and set the `acknowledge` parameter to `true`.
+# type: response
+# response_code: ''
+value:
+  acknowledged: false
+  license_status: valid
+  acknowledge:
+    message: '"""This license update requires acknowledgement. To acknowledge the license, please read the following messages and update the license again, this time with the "acknowledge=true" parameter:"""'
+    watcher:
+      - Watcher will be disabled
+    logstash:
+      - Logstash will no longer poll for centrally-managed pipelines
+    security:
+      - The following X-Pack security functionality will be disabled ...