Adding PrivateEndpoint (formerly called InterfaceEndpoint) and Privat…

…eLinkService with operations. (#5860)

* rename interfaceEndpoint to privateEndpoint.

* Change the PrivateEndpoint properties by following private ip design document.

* modify some of array part of private endpoint and other minor fix.

* Add availablePrivateEndpointTypes and its examples.

* Changes for privateEndpoint example.

* 1. Add default response for privateEndpoint
2. Add availablePrivateEndpointTypes to readme.md file.

* Fix some error detect by autorest.

* Minor fix from Azure Pipeline model validation steps.

* 1. Add PrivateLinkService and its example.
2. Modify PrivateEndpoint and its example to match the PrivateLinkService.

* add privateLinkService to readme.md file.

* Modify/Add examples to demonstrate PrivateEndpoint with manualPrivateLinkServiceConnections.

* Fix some issue found by AzurePipelines model validator.

* fix for model validator error.

* Typo fix.

* Minor fix for PR comment and others.

* delete interfaceendpoint example.

* edit some of descriptions.

* Add some new features for private link service.

* fix the issue found by ModelValidation.

* Mdofiy update privateEndpointConnection method according to spec changes. Other minor fix.

* fix issue found by model validation.

* no comment.

* Add x-ms-client-flatten property to the nested structure.

specification/network/resource-manager/Microsoft.Network/stable/2019-04-01/availablePrivateEndpointTypes.json

@@ -0,0 +1,155 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "NetworkManagementClient",
+    "description": "The Microsoft Azure Network management API provides a RESTful set of web services that interact with Microsoft Azure Networks service to manage your network resources. The API has entities that capture the relationship between an end user and the Microsoft Azure Networks service.",
+    "version": "2019-04-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/availablePrivateEndpointTypes": {
+      "get": {
+        "operationId": "AvailablePrivateEndpointTypes_List",
+        "description": "Returns all of the resource types that can be linked to a Private Endpoint in this subscription in this region.",
+        "parameters": [
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "the location of the domain name."
+          },
+          {
+            "$ref": "./network.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./network.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request successful. Returns all of the resource types that can be linked to a Private Endpoint in this subscription in this region.",
+            "schema": {
+              "$ref": "#/definitions/AvailablePrivateEndpointTypesResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get available PrivateEndpoint types": {
+            "$ref": "./examples/AvailablePrivateEndpointTypesGet.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/locations/{location}/availablePrivateEndpointTypes": {
+      "get": {
+        "operationId": "AvailableResourceGroupPrivateEndpointTypes_List",
+        "description": "Returns all of the resource types that can be linked to a Private Endpoint in this subscription in this region.",
+        "parameters": [
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The location of the domain name."
+          },
+          {
+            "name": "resourceGroupName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the resource group."
+          },
+          {
+            "$ref": "./network.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "./network.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request successful. Returns all of the resource types that can be linked to a Private Endpoint in this subscription in this region.",
+            "schema": {
+              "$ref": "#/definitions/AvailablePrivateEndpointTypesResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get available PrivateEndpoint types in the resource group": {
+            "$ref": "./examples/AvailablePrivateEndpointTypesResourceGroupGet.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "AvailablePrivateEndpointTypesResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AvailablePrivateEndpointType"
+          },
+          "description": "An array of available privateEndpoint type."
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The URL to get the next set of results."
+        }
+      },
+      "description": "An array of available PrivateEndpoint types."
+    },
+    "AvailablePrivateEndpointType": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "A unique identifier of the AvailablePrivateEndpoint Type resource."
+        },
+        "type": {
+          "type": "string",
+          "description": "Resource type."
+        },
+        "serviceName": {
+          "type": "string",
+          "description": "The name of the service and resource "
+        }
+      },
+      "description": "The information of an AvailablePrivateEndpointType."
+    }
+  }
+}

specification/network/resource-manager/Microsoft.Network/stable/2019-04-01/examples/AvailablePrivateEndpointTypesGet.json

@@ -0,0 +1,20 @@
+{
+  "parameters" : {
+    "api-version": "2019-04-01",
+    "location": "regionName",
+    "subscriptionId" : "subId"
+  },
+  "responses" : {
+    "200" : {
+      "body" : {
+        "value": [
+          {
+            "id": "/subscriptions/subId/providers/Microsoft.Network/availablePrivateEndpointTypes/Microsoft.Provider.resourceType",
+            "type": "Microsoft.Network/availablePrivateEndpointTypes",
+            "serviceName": "Microsoft.Provider/resourceType"
+          }
+        ]
+      }
+    }
+  }
+}

specification/network/resource-manager/Microsoft.Network/stable/2019-04-01/examples/AvailablePrivateEndpointTypesResourceGroupGet.json

@@ -0,0 +1,21 @@
+{
+  "parameters" : {
+    "api-version": "2019-04-01",
+    "location": "regionName",
+    "subscriptionId" : "subId",
+    "resourceGroupName" : "rg1"
+  },
+  "responses" : {
+    "200" : {
+      "body" : {
+        "value": [
+          {
+            "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/availablePrivateEndpointTypes/Microsoft.Provider.resourceType",
+            "type": "Microsoft.Network/availablePrivateEndpointTypes",
+            "serviceName": "Microsoft.Provider/resourceType"
+          }
+        ]
+      }
+    }
+  }
+}