Dev IoT Central Microsoft.IotCentral 2021-11-01-preview (#17439)

* Adds base for updating Microsoft.IoTCentral from version stable/2021-06-01 to version 2021-11-01-preview

* Updates readme

* Updates API version in new specs and examples

* Initial update of IoT Central r resource definition

* Initial work on private endpoint connection apis

* more work on the private endpoint apis

* removing some comments

* updating put api

* Adding examples

* Fixing example file

* Fixing api spec formatting

* Formatting examples

* Updating use of  in App model definition

* ...

* Getting rid of  definition

* Referencing the common types Resource Def instead

* ...

* more updates

* more updates

* more updates 2:30PM

* more updates 4:20

* Adding private link api

* fixing the schema used by private link list

* Fix private link list example

* addressing some comments

* marking default responses as error responses

* Updating examples

* removing body from some example responses

* Adding x-ms-identifier

* deleting invisible characters

* Adding a common privatelinks.json v4

* updating network ruleset properties

* forgot to update examples

* trying to remove default responses from example files

* Rogelio's comments

* moving to the more common 'groupId' private link resource name

* fixes and a revert of a change for breaking changes

* rule fixes

* adding list identifier for operations

* fixed one rule and broke another

* fixing broken validation rules

* finishing up changes for ro's comments

* updates

* adding type to resource def

* updating casing of iotApps to IoTApps

* changing back to camelCased 'iotApps'

* Delete old privatepreview version from repo

* patch back to 202

* example fix and suppression

* trying another supression config

* improving async header documentation

* trying to deduplicate schema definitions

* updating the status response schemas for long running apis

* updating examples

* removing status responses from async apis

* suppressing another error for networking

* Update delete response codes

* forgot to update delete operations

* Updating response codes for put and delete apis

* move from azure-asyncoperation to location header

* Captilizing headers in examples

* standardizing capitalization of 'IoT'

* Adding provisioning state property

* Adding 201 response to Application PUT

* commit to start validation checks after tooling update

* removing location header from put requests

* adding azure-asyncoperation header back

* adding a better description to the azure-asyncoperation header

specification/common-types/resource-management/v4/privatelinks.json

@@ -0,0 +1,190 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "4.0",
+    "title": "Common types"
+  },
+  "paths": {},
+  "definitions": {
+    "PrivateEndpoint": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The ARM identifier for private endpoint."
+        }
+      },
+      "description": "The private endpoint resource."
+    },
+    "PrivateEndpointConnection": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/PrivateEndpointConnectionProperties",
+          "x-ms-client-flatten": true,
+          "description": "Resource properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../v3/types.json#/definitions/Resource"
+        }
+      ],
+      "description": "The private endpoint connection resource."
+    },
+    "PrivateEndpointConnectionProperties": {
+      "type": "object",
+      "properties": {
+        "groupIds": {
+          "description": "The group ids for the private endpoint resource.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true
+        },
+        "privateEndpoint": {
+          "$ref": "#/definitions/PrivateEndpoint",
+          "description": "The private endpoint resource."
+        },
+        "privateLinkServiceConnectionState": {
+          "$ref": "#/definitions/PrivateLinkServiceConnectionState",
+          "description": "A collection of information about the state of the connection between service consumer and provider."
+        },
+        "provisioningState": {
+          "$ref": "#/definitions/PrivateEndpointConnectionProvisioningState",
+          "description": "The provisioning state of the private endpoint connection resource."
+        }
+      },
+      "required": [
+        "privateLinkServiceConnectionState"
+      ],
+      "description": "Properties of the private endpoint connection."
+    },
+    "PrivateLinkServiceConnectionState": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "$ref": "#/definitions/PrivateEndpointServiceConnectionStatus",
+          "description": "Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service."
+        },
+        "description": {
+          "type": "string",
+          "description": "The reason for approval/rejection of the connection."
+        },
+        "actionsRequired": {
+          "type": "string",
+          "description": "A message indicating if changes on the service provider require any updates on the consumer."
+        }
+      },
+      "description": "A collection of information about the state of the connection between service consumer and provider."
+    },
+    "PrivateEndpointServiceConnectionStatus": {
+      "type": "string",
+      "description": "The private endpoint connection status.",
+      "enum": [
+        "Pending",
+        "Approved",
+        "Rejected"
+      ],
+      "x-ms-enum": {
+        "name": "PrivateEndpointServiceConnectionStatus",
+        "modelAsString": true
+      }
+    },
+    "PrivateEndpointConnectionProvisioningState": {
+      "type": "string",
+      "readOnly": true,
+      "description": "The current provisioning state.",
+      "enum": [
+        "Succeeded",
+        "Creating",
+        "Deleting",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "PrivateEndpointConnectionProvisioningState",
+        "modelAsString": true
+      }
+    },
+    "PrivateLinkResource": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/PrivateLinkResourceProperties",
+          "description": "Resource properties.",
+          "x-ms-client-flatten": true
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../v3/types.json#/definitions/Resource"
+        }
+      ],
+      "description": "A private link resource."
+    },
+    "PrivateLinkResourceProperties": {
+      "type": "object",
+      "properties": {
+        "groupId": {
+          "description": "The private link resource group id.",
+          "type": "string",
+          "readOnly": true
+        },
+        "requiredMembers": {
+          "description": "The private link resource required member names.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true
+        },
+        "requiredZoneNames": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The private link resource private link DNS zone name."
+        }
+      },
+      "description": "Properties of a private link resource."
+    },
+    "PrivateEndpointConnectionListResult": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "Array of private endpoint connections.",
+          "items": {
+            "$ref": "#/definitions/PrivateEndpointConnection"
+          }
+        }
+      },
+      "description": "List of private endpoint connections associated with the specified resource."
+    },
+    "PrivateLinkResourceListResult": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "Array of private link resources",
+          "items": {
+            "$ref": "#/definitions/PrivateLinkResource"
+          }
+        }
+      },
+      "description": "A list of private link resources."
+    }
+  },
+  "parameters": {
+    "PrivateEndpointConnectionName": {
+      "name": "privateEndpointConnectionName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the private endpoint connection associated with the Azure resource.",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}