[IoT Central] Rest API GA (2022-05-31) (#18982)

* New 1.2-preview release for IoT Central API, Add support for Device Group CRUD, New Job Types

* update package version in readme.md

* fix lint errors

* add missing contract

* Fix API Review Comments, Add Default Error Response, Revise the filter description in device group, define any value for capability job

* fix description of organization parent field

* fix code review comments

* remove version enum, fix code review comments

* Update specification/iotcentral/data-plane/Microsoft.IoTCentral/preview/1.2-preview/iotcentral.json

Co-authored-by: Mike Kistler <mikekistler@microsoft.com>

* add missing comma

* fix the code review comments to add application/json-merge-patch only support for device group

* fix comments

* add description for non-collection definitions

* add paging for /jobs/:id/devices

* fix typo

* Azure IoT Central 2022-05-31 GA version, includes changes with orgs, file upload, device groups, jobs

* remove the edge related from 2022-05-31 examples as it will be retired soon

* remove jobs from 2022-05-31 ga

* remove the non-used job examples

* fix the lint failures

* fix wrong content-type for previous version, production does not support json-patch+json

* Add missing descriptions, update the wrong consumes from application/json-merge-patch+json to application/merge-patch+json, error contract frame

* remove max items from organizations, add description

* add maxLength and pattern for path parameter of userId, organizationId and deviceGroupId

* add date-time-rfc1123 format to error response time field

* update description for request/response in command definition for support any types

* add x-ms-error-code header to default error response

* Move UserId, OrganizationId Parameter to global so can share the definition

* fix typo on pattern

* add missing security schema to meet security requirement

Co-authored-by: Mike Kistler <mikekistler@microsoft.com>

Author: yang-hai-feng

specification/iotcentral/data-plane/Microsoft.IoTCentral/preview/1.1-preview/iotcentral.json

@@ -2049,7 +2049,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -2229,7 +2229,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -2600,7 +2600,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -2734,7 +2734,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -3036,7 +3036,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -3428,7 +3428,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -3579,7 +3579,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -3718,7 +3718,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -3854,7 +3854,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -4004,7 +4004,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -4290,6 +4290,8 @@
             "name": "organizationId",
             "description": "Unique ID of the organization.",
             "type": "string",
+            "maxLength": 48,
+            "pattern": "^(?!-)[a-z0-9-]{1,48}[a-z0-9]$",
             "required": true
           }
         ],
@@ -4350,7 +4352,7 @@
         },
         "consumes": [
           "application/json",
-          "application/json-patch+json"
+          "application/merge-patch+json"
         ],
         "parameters": [
           {
@@ -4545,6 +4547,8 @@
             "name": "userId",
             "description": "Unique ID of the user.",
             "type": "string",
+            "maxLength": 48,
+            "pattern": "^[a-zA-Z0-9-_]*",
             "required": true
           }
         ],
@@ -4802,6 +4806,13 @@
       "required": false
     }
   },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
   "securityDefinitions": {
     "azure_auth": {
       "type": "oauth2",