Add YAML tests and REST API specs

Author: carlosdelest

rest-api-spec/src/main/resources/rest-api-spec/api/synonyms.put_synonym.json

@@ -30,6 +30,12 @@
         }
       ]
     },
+    "params": {
+      "timeout": {
+        "type": "time",
+        "description": "Explicit timeout for the operation to complete"
+      }
+    },
     "body": {
       "description": "Synonyms set rules",
       "required": true

rest-api-spec/src/main/resources/rest-api-spec/api/synonyms.put_synonym_rule.json

@@ -34,6 +34,12 @@
         }
       ]
     },
+    "params": {
+      "timeout": {
+        "type": "time",
+        "description": "Explicit timeout for the operation to complete"
+      }
+    },
     "body": {
       "description": "Synonym rule",
       "required": true

rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/synonyms/10_synonyms_put.yml

@@ -65,6 +65,22 @@ setup:
   - match: { count: 0 }
   - match: { synonyms_set: [] }
 
+---
+"Timeout can be specified":
+  - do:
+      synonyms.put_synonym:
+        id: test-update-synonyms
+        timeout: 10s
+        body:
+          synonyms_set:
+            - synonyms: "hello, hi"
+            - synonyms: "bye => goodbye"
+              id: "test-id"
+
+  - match: { result: "created" }
+  - match: { reload_analyzers_details._shards.total: 0 }
+  - length: { reload_analyzers_details.reload_details: 0 }
+
 ---
 "Validation fails tests":
   - do:
@@ -106,3 +122,13 @@ setup:
         body:
           synonyms_set:
             - synonyms: "bye, goodbye,  "
+
+  - do:
+      catch: /as a time value:\ negative durations are not supported/
+      synonyms.put_synonym:
+        id: test-update-synonyms
+        timeout: -100s
+        body:
+          synonyms_set:
+            - synonyms: "bye, goodbye"
+