Spec fixed to reflect new examples property (#15377)

* Spec fixed to reflect new examples property

* Prettier

* suppressing incorrect warning

Author: VitaliyKurokhtin

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2021-01-01-preview/definitions.json

@@ -3715,6 +3715,10 @@
         "typeName": {
           "type": "string",
           "description": "Type name defined by the schema."
+        },
+        "examples": {
+          "$ref": "#/definitions/ParameterExamplesContract",
+          "description": "Exampled defined for the parameter."
         }
       },
       "required": [
@@ -3723,6 +3727,33 @@
       ],
       "description": "Operation parameters details."
     },
+    "ParameterExamplesContract": {
+      "additionalProperties": {
+        "$ref": "#/definitions/ParameterExampleContract",
+        "description": "Parameter example."
+      },
+      "description": "Parameter examples."
+    },
+    "ParameterExampleContract": {
+      "description": "Parameter example.",
+      "properties": {
+        "summary": {
+          "type": "string",
+          "description": "Short description for the example"
+        },
+        "description": {
+          "type": "string",
+          "description": "Long description for the example"
+        },
+        "value": {
+          "description": "Example value. May be a primitive value, or an object."
+        },
+        "externalValue": {
+          "type": "string",
+          "description": "A URL that points to the literal example"
+        }
+      }
+    },
     "PipelineDiagnosticSettings": {
       "properties": {
         "request": {
@@ -4687,10 +4718,6 @@
           "type": "string",
           "description": "Specifies a registered or custom content type for this representation, e.g. application/xml."
         },
-        "sample": {
-          "type": "string",
-          "description": "An example of the representation."
-        },
         "schemaId": {
           "type": "string",
           "description": "Schema identifier. Applicable only if 'contentType' value is neither 'application/x-www-form-urlencoded' nor 'multipart/form-data'."

specification/apimanagement/resource-manager/readme.md

@@ -523,7 +523,7 @@ See configuration in [readme.az.md](./readme.az.md)
 ## Suppression
 
 ``` yaml
-directive:  
+directive:
   - suppress: R4009
     from: apimapis.json
     reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
@@ -559,53 +559,56 @@ directive:
     reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimnamedvalues.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimgateways.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimgroups.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.  
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimcontenttypes.json
     reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimdeletedservices.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimdiagnostics.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimemailtemplates.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.  
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimidentityprovider.json
     reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimissues.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimloggers.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimopenidconnectproviders.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.  
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimpolicies.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.  
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimportalrevisions.json
     reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimsettings.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimtags.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.   
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimtenant.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.  
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
   - suppress: R4009
     from: apimnotifications.json
-    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.  
-```
+    reason: Warning raised to error while PR was being reviewed. SystemData will implement in next preview version.
+  - suppress: R4037
+    from: definitions.json
+    reason: We want customers to be able to supply any valid JSON token, object or otherwise
+```