diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/digitaltwins.json
new file mode 100644
index 000000000000..25fe1871d4d6
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/digitaltwins.json
@@ -0,0 +1,2234 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2022-05-31",
+    "title": "AzureDigitalTwinsManagementClient",
+    "description": "Azure Digital Twins Client for managing DigitalTwinsInstance"
+  },
+  "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}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}": {
+      "get": {
+        "tags": [
+          "DigitalTwinsInstance"
+        ],
+        "description": "Get DigitalTwinsInstances resource.",
+        "operationId": "DigitalTwins_Get",
+        "x-ms-examples": {
+          "Get a DigitalTwinsInstance resource": {
+            "$ref": "./examples/DigitalTwinsGet_example.json"
+          },
+          "Get a DigitalTwinsInstance resource with identity": {
+            "$ref": "./examples/DigitalTwinsGet_WithIdentity_example.json"
+          },
+          "Get a DigitalTwinsInstance resource with a private endpoint connection": {
+            "$ref": "./examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "DigitalTwinsInstance"
+        ],
+        "description": "Create or update the metadata of a DigitalTwinsInstance. The usual pattern to modify a property is to retrieve the DigitalTwinsInstance and security metadata, and then combine them with the modified values in a new body to update the DigitalTwinsInstance.",
+        "operationId": "DigitalTwins_CreateOrUpdate",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Put a DigitalTwinsInstance resource": {
+            "$ref": "./examples/DigitalTwinsPut_example.json"
+          },
+          "Put a DigitalTwinsInstance resource with identity": {
+            "$ref": "./examples/DigitalTwinsPut_WithIdentity_example.json"
+          },
+          "Put a DigitalTwinsInstance resource with publicNetworkAccess property": {
+            "$ref": "./examples/DigitalTwinsPut_WithPublicNetworkAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "name": "digitalTwinsCreate",
+            "in": "body",
+            "description": "The DigitalTwinsInstance and security metadata.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is returned as a response when the resource already exists and was updated successfully.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          },
+          "201": {
+            "description": "Created - Put request accepted; the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "DigitalTwinsInstance"
+        ],
+        "description": "Update metadata of DigitalTwinsInstance.",
+        "operationId": "DigitalTwins_Update",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Patch a DigitalTwinsInstance resource": {
+            "$ref": "./examples/DigitalTwinsPatch_example.json"
+          },
+          "Patch a DigitalTwinsInstance resource with identity": {
+            "$ref": "./examples/DigitalTwinsPatch_WithIdentity_example.json"
+          },
+          "Patch a DigitalTwinsInstance resource with publicNetworkAccess property": {
+            "$ref": "./examples/DigitalTwinsPatch_WithPublicNetworkAccess.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "name": "digitalTwinsPatchDescription",
+            "in": "body",
+            "description": "The DigitalTwinsInstance and security metadata.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsPatchDescription"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted - Patch request accepted; the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "DigitalTwinsInstance"
+        ],
+        "description": "Delete a DigitalTwinsInstance.",
+        "operationId": "DigitalTwins_Delete",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Delete a DigitalTwinsInstance resource": {
+            "$ref": "./examples/DigitalTwinsDelete_example.json"
+          },
+          "Delete a DigitalTwinsInstance resource with identity": {
+            "$ref": "./examples/DigitalTwinsDelete_WithIdentity_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returned if the operation was canceled or failed.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted - Delete request accepted; the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescription"
+            }
+          },
+          "204": {
+            "description": "Returned when the long running delete operation has finished, or the Digital Twins instance does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints": {
+      "get": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Get DigitalTwinsInstance Endpoints.",
+        "operationId": "DigitalTwinsEndpoint_List",
+        "x-ms-examples": {
+          "Get a DigitalTwinsInstance endpoints": {
+            "$ref": "./examples/DigitalTwinsEndpointsGet_example.json"
+          },
+          "Get a DigitalTwinsInstance endpoints with identity": {
+            "$ref": "./examples/DigitalTwinsEndpointsGet_WithIdentity_example.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsEndpointResourceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}": {
+      "get": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Get DigitalTwinsInstances Endpoint.",
+        "operationId": "DigitalTwinsEndpoint_Get",
+        "x-ms-examples": {
+          "Get a DigitalTwinsInstance endpoint": {
+            "$ref": "./examples/DigitalTwinsEndpointGet_example.json"
+          },
+          "Get a DigitalTwinsInstance endpoint with identity": {
+            "$ref": "./examples/DigitalTwinsEndpointGet_WithIdentity_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/endpointName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsEndpointResource"
+            }
+          },
+          "default": {
+            "description": "Default error response",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Create or update DigitalTwinsInstance endpoint.",
+        "operationId": "DigitalTwinsEndpoint_CreateOrUpdate",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Put a DigitalTwinsEndpoint resource": {
+            "$ref": "./examples/DigitalTwinsEndpointPut_example.json"
+          },
+          "Put a DigitalTwinsEndpoint resource with identity": {
+            "$ref": "./examples/DigitalTwinsEndpointPut_WithIdentity_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/endpointName"
+          },
+          {
+            "name": "endpointDescription",
+            "in": "body",
+            "description": "The DigitalTwinsInstance endpoint metadata and security metadata.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsEndpointResource"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsEndpointResource"
+            }
+          },
+          "201": {
+            "description": "Created - Put request accepted; the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsEndpointResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Endpoints"
+        ],
+        "description": "Delete a DigitalTwinsInstance endpoint.",
+        "operationId": "DigitalTwinsEndpoint_Delete",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Delete a DigitalTwinsInstance endpoint": {
+            "$ref": "./examples/DigitalTwinsEndpointDelete_example.json"
+          },
+          "Delete a DigitalTwinsInstance endpoint with identity": {
+            "$ref": "./examples/DigitalTwinsEndpointDelete_WithIdentity_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/endpointName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returned if the operation was canceled or failed.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsEndpointResource"
+            }
+          },
+          "202": {
+            "description": "Accepted - Delete request accepted; the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsEndpointResource"
+            }
+          },
+          "204": {
+            "description": "Returned when the long running delete operation has finished, or the egress endpoint does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances": {
+      "get": {
+        "tags": [
+          "DigitalTwinsInstance"
+        ],
+        "description": "Get all the DigitalTwinsInstances in a subscription.",
+        "operationId": "DigitalTwins_List",
+        "x-ms-examples": {
+          "Get DigitalTwinsInstance resources by subscription": {
+            "$ref": "./examples/DigitalTwinsList_example.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the DigitalTwinsInstances in the subscription.",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescriptionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances": {
+      "get": {
+        "tags": [
+          "DigitalTwinsInstance"
+        ],
+        "description": "Get all the DigitalTwinsInstances in a resource group.",
+        "operationId": "DigitalTwins_ListByResourceGroup",
+        "x-ms-examples": {
+          "Get DigitalTwinsInstance resources by resource group": {
+            "$ref": "./examples/DigitalTwinsListByResourceGroup_example.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the DigitalTwinsInstances in the resource group. If more data is available, the body will contain a link to the next page of items (nextLink).",
+            "schema": {
+              "$ref": "#/definitions/DigitalTwinsDescriptionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.DigitalTwins/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "description": "Lists all of the available DigitalTwins service REST API operations.",
+        "operationId": "Operations_List",
+        "x-ms-examples": {
+          "Get available operations": {
+            "$ref": "./examples/DigitalTwinsOperationsList_example.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The request has succeeded.",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/locations/{location}/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "CheckNameAvailability"
+        ],
+        "description": "Check if a DigitalTwinsInstance name is available.",
+        "operationId": "DigitalTwins_CheckNameAvailability",
+        "x-ms-examples": {
+          "Check name Availability": {
+            "$ref": "./examples/DigitalTwinsCheckNameAvailability_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/location"
+          },
+          {
+            "name": "digitalTwinsInstanceCheckName",
+            "in": "body",
+            "description": "Set the name parameter in the DigitalTwinsInstanceCheckName structure to the name of the DigitalTwinsInstance to check.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CheckNameRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is a synchronous operation. The body contains a JSON-serialized response that specifies whether the DigitalTwins service name is available. If the name is not available, the body contains the reason.",
+            "schema": {
+              "$ref": "#/definitions/CheckNameResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/privateLinkResources": {
+      "get": {
+        "tags": [
+          "PrivateEndpoints"
+        ],
+        "description": "List private link resources for given Digital Twin.",
+        "operationId": "PrivateLinkResources_List",
+        "x-ms-examples": {
+          "List private link resources for given Digital Twin": {
+            "$ref": "./examples/PrivateLinkResourcesList_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains the list of private link resources.",
+            "schema": {
+              "$ref": "#/definitions/GroupIdInformationResponse"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/privateLinkResources/{resourceId}": {
+      "get": {
+        "tags": [
+          "PrivateEndpoints"
+        ],
+        "description": "Get the specified private link resource for the given Digital Twin.",
+        "operationId": "PrivateLinkResources_Get",
+        "x-ms-examples": {
+          "Get the specified private link resource for the given Digital Twin": {
+            "$ref": "./examples/PrivateLinkResourcesByGroupId_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/resourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains the specified of private link resource.",
+            "schema": {
+              "$ref": "#/definitions/GroupIdInformation"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/privateEndpointConnections": {
+      "get": {
+        "tags": [
+          "PrivateEndpoints"
+        ],
+        "description": "List private endpoint connection properties.",
+        "operationId": "PrivateEndpointConnections_List",
+        "x-ms-examples": {
+          "List private endpoint connection properties": {
+            "$ref": "./examples/PrivateEndpointConnectionsList_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains the list of private endpoint connection properties.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnectionsResponse"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}": {
+      "get": {
+        "tags": [
+          "PrivateEndpoints"
+        ],
+        "description": "Get private endpoint connection properties for the given private endpoint.",
+        "operationId": "PrivateEndpointConnections_Get",
+        "x-ms-examples": {
+          "Get private endpoint connection properties for the given private endpoint": {
+            "$ref": "./examples/PrivateEndpointConnectionByConnectionName_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/privateEndpointConnectionName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The body contains the private endpoint connection properties.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "PrivateEndpoints"
+        ],
+        "description": "Delete private endpoint connection with the specified name.",
+        "operationId": "PrivateEndpointConnections_Delete",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Delete private endpoint connection with the specified name": {
+            "$ref": "./examples/PrivateEndpointConnectionDelete_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/privateEndpointConnectionName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returned when the long running delete operation has failed, and has reached a terminal state."
+          },
+          "202": {
+            "description": "This is a long running operation. The operation returns a 202 if the validation is complete. The response includes an Azure-AsyncOperation header that contains a status URL. Clients are expected to poll the status URL for the status of the operation. The status URL returns 204 No Content when the deletion is complete."
+          },
+          "204": {
+            "description": "Returned when the long running delete operation has finished, or the private endpoint does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "PrivateEndpoints"
+        ],
+        "description": "Update the status of a private endpoint connection with the given name.",
+        "operationId": "PrivateEndpointConnections_CreateOrUpdate",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Update the status of a private endpoint connection with the given name": {
+            "$ref": "./examples/PrivateEndpointConnectionPut_example.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/privateEndpointConnectionName"
+          },
+          {
+            "name": "privateEndpointConnection",
+            "in": "body",
+            "description": "The private endpoint connection with updated properties.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "This is a long running operation. The operation returns a 202 if the validation is complete. The response includes an Azure-AsyncOperation header that contains a status URL. Clients are expected to poll the status URL for the status of the operation. If successful, the operation returns HTTP status code of 200 (OK).",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "200": {
+            "description": "This is returned as a response when the resource already exists and was updated successfully.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/timeSeriesDatabaseConnections": {
+      "get": {
+        "tags": [
+          "TimeSeriesDatabaseConnections"
+        ],
+        "description": "Get all existing time series database connections for this DigitalTwins instance.",
+        "operationId": "TimeSeriesDatabaseConnections_List",
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of time series database connections for this DigitalTwins instance.",
+            "schema": {
+              "$ref": "#/definitions/TimeSeriesDatabaseConnectionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List time series database connections for a DigitalTwins instance.": {
+            "$ref": "./examples/TimeSeriesDatabaseConnectionsList_example.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/timeSeriesDatabaseConnections/{timeSeriesDatabaseConnectionName}": {
+      "get": {
+        "tags": [
+          "TimeSeriesDatabaseConnections"
+        ],
+        "description": "Get the description of an existing time series database connection.",
+        "operationId": "TimeSeriesDatabaseConnections_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/timeSeriesDatabaseConnectionName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Description of the time series connection.",
+            "schema": {
+              "$ref": "#/definitions/TimeSeriesDatabaseConnection"
+            }
+          },
+          "default": {
+            "description": "Default error response",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get time series database connection for a DigitalTwins instance.": {
+            "$ref": "./examples/TimeSeriesDatabaseConnectionsGet_example.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "TimeSeriesDatabaseConnections"
+        ],
+        "description": "Create or update a time series database connection.",
+        "operationId": "TimeSeriesDatabaseConnections_CreateOrUpdate",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/timeSeriesDatabaseConnectionName"
+          },
+          {
+            "name": "timeSeriesDatabaseConnectionDescription",
+            "in": "body",
+            "description": "The time series database connection description.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/TimeSeriesDatabaseConnection"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.",
+            "schema": {
+              "$ref": "#/definitions/TimeSeriesDatabaseConnection"
+            }
+          },
+          "201": {
+            "description": "Created - Put request accepted; the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/TimeSeriesDatabaseConnection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Create or replace a time series database connection for a DigitalTwins instance.": {
+            "$ref": "./examples/TimeSeriesDatabaseConnectionsPut_example.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "TimeSeriesDatabaseConnections"
+        ],
+        "description": "Delete a time series database connection.",
+        "operationId": "TimeSeriesDatabaseConnections_Delete",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "#/parameters/api-version"
+          },
+          {
+            "$ref": "#/parameters/subscriptionId"
+          },
+          {
+            "$ref": "#/parameters/resourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/resourceName"
+          },
+          {
+            "$ref": "#/parameters/timeSeriesDatabaseConnectionName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returned if the operation was canceled or failed.",
+            "schema": {
+              "$ref": "#/definitions/TimeSeriesDatabaseConnection"
+            }
+          },
+          "202": {
+            "description": "Accepted - Delete request accepted; the operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/TimeSeriesDatabaseConnection"
+            }
+          },
+          "204": {
+            "description": "Returned when the long running delete operation has finished, or the time series database connection does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Delete a time series database connection for a DigitalTwins instance.": {
+            "$ref": "./examples/TimeSeriesDatabaseConnectionsDelete_example.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "DigitalTwinsPatchProperties": {
+      "description": "The properties of a DigitalTwinsInstance.",
+      "type": "object",
+      "properties": {
+        "publicNetworkAccess": {
+          "description": "Public network access for the DigitalTwinsInstance.",
+          "enum": [
+            "Enabled",
+            "Disabled"
+          ],
+          "type": "string",
+          "x-nullable": true,
+          "x-ms-enum": {
+            "name": "publicNetworkAccess",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "DigitalTwinsProperties": {
+      "description": "The properties of a DigitalTwinsInstance.",
+      "type": "object",
+      "properties": {
+        "createdTime": {
+          "description": "Time when DigitalTwinsInstance was created.",
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time"
+        },
+        "lastUpdatedTime": {
+          "description": "Time when DigitalTwinsInstance was updated.",
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time"
+        },
+        "provisioningState": {
+          "description": "The provisioning state.",
+          "enum": [
+            "Provisioning",
+            "Deleting",
+            "Updating",
+            "Succeeded",
+            "Failed",
+            "Canceled",
+            "Deleted",
+            "Warning",
+            "Suspending",
+            "Restoring",
+            "Moving"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-ms-enum": {
+            "name": "provisioningState",
+            "modelAsString": true
+          }
+        },
+        "hostName": {
+          "description": "Api endpoint to work with DigitalTwinsInstance.",
+          "type": "string",
+          "x-nullable": true,
+          "readOnly": true
+        },
+        "privateEndpointConnections": {
+          "description": "The private endpoint connections.",
+          "type": "array",
+          "x-nullable": true,
+          "items": {
+            "$ref": "#/definitions/PrivateEndpointConnection"
+          }
+        },
+        "publicNetworkAccess": {
+          "description": "Public network access for the DigitalTwinsInstance.",
+          "enum": [
+            "Enabled",
+            "Disabled"
+          ],
+          "type": "string",
+          "x-nullable": true,
+          "x-ms-enum": {
+            "name": "publicNetworkAccess",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "DigitalTwinsDescription": {
+      "description": "The description of the DigitalTwins service.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "DigitalTwins instance properties.",
+          "$ref": "#/definitions/DigitalTwinsProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/DigitalTwinsResource"
+        }
+      ]
+    },
+    "DigitalTwinsPatchDescription": {
+      "description": "The description of the DigitalTwins service.",
+      "type": "object",
+      "properties": {
+        "tags": {
+          "description": "Instance patch properties",
+          "type": "object",
+          "x-nullable": true,
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "identity": {
+          "description": "The managed identity for the DigitalTwinsInstance.",
+          "x-nullable": true,
+          "$ref": "#/definitions/DigitalTwinsIdentity"
+        },
+        "properties": {
+          "description": "Properties for the DigitalTwinsInstance.",
+          "x-nullable": true,
+          "$ref": "#/definitions/DigitalTwinsPatchProperties"
+        }
+      }
+    },
+    "DigitalTwinsResource": {
+      "description": "The common properties of a DigitalTwinsInstance.",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource identifier."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource name.",
+          "pattern": "^(?!-)[A-Za-z0-9-]{3,63}(?<!-)$"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource type."
+        },
+        "location": {
+          "type": "string",
+          "description": "The resource location.",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "tags": {
+          "type": "object",
+          "x-nullable": true,
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The resource tags."
+        },
+        "identity": {
+          "description": "The managed identity for the DigitalTwinsInstance.",
+          "x-nullable": true,
+          "$ref": "#/definitions/DigitalTwinsIdentity"
+        },
+        "systemData": {
+          "description": "Metadata pertaining to creation and last modification of the DigitalTwinsInstance.",
+          "readOnly": true,
+          "$ref": "#/definitions/SystemData"
+        }
+      },
+      "x-ms-azure-resource": true,
+      "required": [
+        "location"
+      ]
+    },
+    "DigitalTwinsIdentity": {
+      "description": "The managed identity for the DigitalTwinsInstance.",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "None",
+            "SystemAssigned"
+          ],
+          "x-ms-enum": {
+            "name": "DigitalTwinsIdentityType",
+            "modelAsString": true
+          },
+          "description": "The type of Managed Identity used by the DigitalTwinsInstance. Only SystemAssigned is supported."
+        },
+        "principalId": {
+          "readOnly": true,
+          "type": "string",
+          "x-nullable": true,
+          "description": "The object id of the Managed Identity Resource. This will be sent to the RP from ARM via the x-ms-identity-principal-id header in the PUT request if the resource has a systemAssigned(implicit) identity"
+        },
+        "tenantId": {
+          "readOnly": true,
+          "type": "string",
+          "x-nullable": true,
+          "description": "The tenant id of the Managed Identity Resource. This will be sent to the RP from ARM via the x-ms-client-tenant-id header in the PUT request if the resource has a systemAssigned(implicit) identity"
+        }
+      }
+    },
+    "ErrorResponse": {
+      "description": "Error response.",
+      "properties": {
+        "error": {
+          "description": "Error description",
+          "$ref": "#/definitions/ErrorDefinition"
+        }
+      }
+    },
+    "ErrorDefinition": {
+      "description": "Error definition.",
+      "properties": {
+        "code": {
+          "description": "Service specific error code which serves as the substatus for the HTTP error code.",
+          "type": "string",
+          "readOnly": true
+        },
+        "message": {
+          "description": "Description of the error.",
+          "type": "string",
+          "readOnly": true
+        },
+        "details": {
+          "description": "Internal error details.",
+          "type": "array",
+          "x-nullable": true,
+          "items": {
+            "$ref": "#/definitions/ErrorDefinition"
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "DigitalTwinsDescriptionListResult": {
+      "description": "A list of DigitalTwins description objects with a next link.",
+      "type": "object",
+      "properties": {
+        "nextLink": {
+          "description": "The link used to get the next page of DigitalTwins description objects.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "value": {
+          "description": "A list of DigitalTwins description objects.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DigitalTwinsDescription"
+          }
+        }
+      }
+    },
+    "OperationListResult": {
+      "description": "A list of DigitalTwins service operations. It contains a list of operations and a URL link to get the next set of results.",
+      "type": "object",
+      "properties": {
+        "nextLink": {
+          "description": "The link used to get the next page of DigitalTwins description objects.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "value": {
+          "description": "A list of DigitalTwins operations supported by the Microsoft.DigitalTwins resource provider.",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Operation"
+          }
+        }
+      }
+    },
+    "Operation": {
+      "description": "DigitalTwins service REST API operation",
+      "type": "object",
+      "properties": {
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Operation name: {provider}/{resource}/{read | write | action | delete}"
+        },
+        "display": {
+          "description": "Operation properties display",
+          "$ref": "#/definitions/OperationDisplay"
+        },
+        "origin": {
+          "readOnly": true,
+          "type": "string",
+          "x-nullable": true,
+          "description": "The intended executor of the operation."
+        },
+        "isDataAction": {
+          "readOnly": true,
+          "type": "boolean",
+          "description": "If the operation is a data action (for data plane rbac)."
+        },
+        "properties": {
+          "readOnly": true,
+          "type": "object",
+          "x-ms-client-flatten": true,
+          "additionalProperties": {
+            "type": "object"
+          },
+          "x-nullable": true,
+          "description": "Operation properties."
+        }
+      }
+    },
+    "OperationDisplay": {
+      "description": "The object that represents the operation.",
+      "type": "object",
+      "properties": {
+        "provider": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Service provider: Microsoft DigitalTwins."
+        },
+        "resource": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource Type: DigitalTwinsInstances."
+        },
+        "operation": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Name of the operation."
+        },
+        "description": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Friendly description for the operation."
+        }
+      }
+    },
+    "CheckNameRequest": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Resource name."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "Microsoft.DigitalTwins/digitalTwinsInstances"
+          ],
+          "x-ms-enum": {
+            "name": "Type",
+            "modelAsString": false
+          },
+          "description": "The type of resource, for instance Microsoft.DigitalTwins/digitalTwinsInstances."
+        }
+      },
+      "required": [
+        "name",
+        "type"
+      ],
+      "description": "The result returned from a database check name availability request."
+    },
+    "CheckNameResult": {
+      "type": "object",
+      "properties": {
+        "nameAvailable": {
+          "type": "boolean",
+          "description": "Specifies a Boolean value that indicates if the name is available."
+        },
+        "message": {
+          "type": "string",
+          "x-nullable": true,
+          "description": "Message indicating an unavailable name due to a conflict, or a description of the naming rules that are violated."
+        },
+        "reason": {
+          "type": "string",
+          "x-nullable": true,
+          "enum": [
+            "Invalid",
+            "AlreadyExists"
+          ],
+          "x-ms-enum": {
+            "name": "reason",
+            "modelAsString": true
+          },
+          "description": "Message providing the reason why the given name is invalid."
+        }
+      },
+      "description": "The result returned from a check name availability request."
+    },
+    "SystemData": {
+      "description": "Metadata pertaining to creation and last modification of the resource.",
+      "type": "object",
+      "readOnly": true,
+      "properties": {
+        "createdBy": {
+          "type": "string",
+          "description": "The identity that created the resource.",
+          "x-nullable": true
+        },
+        "createdByType": {
+          "type": "string",
+          "description": "The type of identity that created the resource.",
+          "enum": [
+            "User",
+            "Application",
+            "ManagedIdentity",
+            "Key"
+          ],
+          "x-ms-enum": {
+            "name": "createdByType",
+            "modelAsString": true
+          },
+          "x-nullable": true
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The timestamp of resource creation (UTC).",
+          "x-nullable": true
+        },
+        "lastModifiedBy": {
+          "type": "string",
+          "description": "The identity that last modified the resource.",
+          "x-nullable": true
+        },
+        "lastModifiedByType": {
+          "type": "string",
+          "description": "The type of identity that last modified the resource.",
+          "enum": [
+            "User",
+            "Application",
+            "ManagedIdentity",
+            "Key"
+          ],
+          "x-ms-enum": {
+            "name": "createdByType",
+            "modelAsString": true
+          },
+          "x-nullable": true
+        },
+        "lastModifiedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The timestamp of resource last modification (UTC)",
+          "x-nullable": true
+        }
+      }
+    },
+    "ExternalResource": {
+      "description": "Definition of a resource.",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource identifier."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Extension resource name.",
+          "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource type."
+        },
+        "systemData": {
+          "description": "Metadata pertaining to creation and last modification of the resource.",
+          "readOnly": true,
+          "$ref": "#/definitions/SystemData"
+        }
+      }
+    },
+    "DigitalTwinsEndpointResource": {
+      "description": "DigitalTwinsInstance endpoint resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ExternalResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "description": "DigitalTwinsInstance endpoint resource properties.",
+          "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties"
+        }
+      },
+      "required": [
+        "properties"
+      ]
+    },
+    "DigitalTwinsEndpointResourceProperties": {
+      "description": "Properties related to Digital Twins Endpoint",
+      "discriminator": "endpointType",
+      "required": [
+        "endpointType"
+      ],
+      "properties": {
+        "endpointType": {
+          "description": "The type of Digital Twins endpoint",
+          "enum": [
+            "EventHub",
+            "EventGrid",
+            "ServiceBus"
+          ],
+          "x-ms-enum": {
+            "name": "endpointType",
+            "modelAsString": true
+          },
+          "type": "string"
+        },
+        "provisioningState": {
+          "description": "The provisioning state.",
+          "enum": [
+            "Provisioning",
+            "Deleting",
+            "Updating",
+            "Succeeded",
+            "Failed",
+            "Canceled",
+            "Deleted",
+            "Warning",
+            "Suspending",
+            "Restoring",
+            "Moving",
+            "Disabled"
+          ],
+          "type": "string",
+          "x-nullable": true,
+          "readOnly": true,
+          "x-ms-enum": {
+            "name": "EndpointProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "createdTime": {
+          "description": "Time when the Endpoint was added to DigitalTwinsInstance.",
+          "type": "string",
+          "x-nullable": true,
+          "format": "date-time",
+          "readOnly": true
+        },
+        "authenticationType": {
+          "description": "Specifies the authentication type being used for connecting to the endpoint. Defaults to 'KeyBased'. If 'KeyBased' is selected, a connection string must be specified (at least the primary connection string). If 'IdentityBased' is select, the endpointUri and entityPath properties must be specified.",
+          "enum": [
+            "KeyBased",
+            "IdentityBased"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "AuthenticationType",
+            "modelAsString": true
+          }
+        },
+        "deadLetterSecret": {
+          "x-ms-secret": true,
+          "description": "Dead letter storage secret for key-based authentication. Will be obfuscated during read.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "deadLetterUri": {
+          "description": "Dead letter storage URL for identity-based authentication.",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "ServiceBus": {
+      "description": "Properties related to ServiceBus.",
+      "x-ms-discriminator-value": "ServiceBus",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties"
+        }
+      ],
+      "properties": {
+        "primaryConnectionString": {
+          "x-ms-secret": true,
+          "description": "PrimaryConnectionString of the endpoint for key-based authentication. Will be obfuscated during read.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "secondaryConnectionString": {
+          "x-ms-secret": true,
+          "description": "SecondaryConnectionString of the endpoint for key-based authentication. Will be obfuscated during read.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "endpointUri": {
+          "description": "The URL of the ServiceBus namespace for identity-based authentication. It must include the protocol 'sb://'.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "entityPath": {
+          "description": "The ServiceBus Topic name for identity-based authentication.",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "EventHub": {
+      "description": "Properties related to EventHub.",
+      "x-ms-discriminator-value": "EventHub",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties"
+        }
+      ],
+      "properties": {
+        "connectionStringPrimaryKey": {
+          "x-ms-secret": true,
+          "description": "PrimaryConnectionString of the endpoint for key-based authentication. Will be obfuscated during read.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "connectionStringSecondaryKey": {
+          "x-ms-secret": true,
+          "description": "SecondaryConnectionString of the endpoint for key-based authentication. Will be obfuscated during read.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "endpointUri": {
+          "description": "The URL of the EventHub namespace for identity-based authentication. It must include the protocol 'sb://'.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "entityPath": {
+          "description": "The EventHub name in the EventHub namespace for identity-based authentication.",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "EventGrid": {
+      "description": "Properties related to EventGrid.",
+      "required": [
+        "TopicEndpoint",
+        "accessKey1"
+      ],
+      "x-ms-discriminator-value": "EventGrid",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties"
+        }
+      ],
+      "properties": {
+        "TopicEndpoint": {
+          "description": "EventGrid Topic Endpoint.",
+          "type": "string"
+        },
+        "accessKey1": {
+          "x-ms-secret": true,
+          "description": "EventGrid secondary accesskey. Will be obfuscated during read.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "accessKey2": {
+          "x-ms-secret": true,
+          "description": "EventGrid secondary accesskey. Will be obfuscated during read.",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "DigitalTwinsEndpointResourceListResult": {
+      "description": "A list of DigitalTwinsInstance Endpoints with a next link.",
+      "type": "object",
+      "properties": {
+        "nextLink": {
+          "description": "The link used to get the next page of DigitalTwinsInstance Endpoints.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "value": {
+          "description": "A list of DigitalTwinsInstance Endpoints.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DigitalTwinsEndpointResource"
+          }
+        }
+      }
+    },
+    "GroupIdInformationProperties": {
+      "description": "The properties for a group information object.",
+      "type": "object",
+      "properties": {
+        "groupId": {
+          "type": "string",
+          "description": "The group id."
+        },
+        "requiredMembers": {
+          "description": "The required members for a specific group id.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "requiredZoneNames": {
+          "description": "The required DNS zones for a specific group id.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "GroupIdInformation": {
+      "description": "The group information for creating a private endpoint on Digital Twin.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "description": "The group information properties.",
+          "$ref": "#/definitions/GroupIdInformationProperties"
+        },
+        "id": {
+          "description": "The resource identifier.",
+          "type": "string"
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource name.",
+          "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource type."
+        }
+      },
+      "required": [
+        "properties"
+      ]
+    },
+    "PrivateEndpointConnectionsResponse": {
+      "description": "The available private link connections for a Digital Twin.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "The list of available private link connections for a Digital Twin.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PrivateEndpointConnection"
+          }
+        }
+      }
+    },
+    "GroupIdInformationResponse": {
+      "description": "The available private link resources for a Digital Twin.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "The list of available private link resources for a Digital Twin.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GroupIdInformation"
+          }
+        }
+      }
+    },
+    "ConnectionState": {
+      "description": "The current state of a private endpoint connection.",
+      "type": "object",
+      "properties": {
+        "status": {
+          "description": "The status of a private endpoint connection.",
+          "enum": [
+            "Pending",
+            "Approved",
+            "Rejected",
+            "Disconnected"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "PrivateLinkServiceConnectionStatus",
+            "modelAsString": true
+          }
+        },
+        "description": {
+          "type": "string",
+          "description": "The description for the current state of a private endpoint connection."
+        },
+        "actionsRequired": {
+          "type": "string",
+          "description": "Actions required for a private endpoint connection."
+        }
+      },
+      "required": [
+        "status",
+        "description"
+      ]
+    },
+    "PrivateEndpoint": {
+      "description": "The private endpoint property of a private endpoint connection.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource identifier."
+        }
+      }
+    },
+    "GroupId": {
+      "readOnly": true,
+      "description": "The private endpoint group id of a private endpoint connection.",
+      "type": "string"
+    },
+    "ConnectionProperties": {
+      "description": "The properties of a private endpoint connection.",
+      "type": "object",
+      "properties": {
+        "provisioningState": {
+          "description": "The provisioning state.",
+          "enum": [
+            "Pending",
+            "Approved",
+            "Rejected",
+            "Disconnected"
+          ],
+          "type": "string",
+          "x-nullable": true,
+          "readOnly": true,
+          "x-ms-enum": {
+            "name": "ConnectionPropertiesProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "privateEndpoint": {
+          "description": "The private endpoint.",
+          "$ref": "#/definitions/PrivateEndpoint"
+        },
+        "groupIds": {
+          "description": "The list of group ids for the private endpoint connection.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GroupId"
+          }
+        },
+        "privateLinkServiceConnectionState": {
+          "description": "The connection state.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/ConnectionState"
+            }
+          ]
+        }
+      }
+    },
+    "PrivateEndpointConnection": {
+      "description": "The private endpoint connection of a Digital Twin.",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource identifier."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource name.",
+          "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$"
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource type."
+        },
+        "properties": {
+          "description": "The connection properties.",
+          "$ref": "#/definitions/ConnectionProperties"
+        },
+        "systemData": {
+          "description": "Metadata pertaining to creation and last modification of the private endpoint connection.",
+          "readOnly": true,
+          "x-nullable": true,
+          "$ref": "#/definitions/SystemData"
+        }
+      },
+      "required": [
+        "properties"
+      ]
+    },
+    "TimeSeriesDatabaseConnectionProperties": {
+      "description": "Properties of a time series database connection resource.",
+      "discriminator": "connectionType",
+      "required": [
+        "connectionType"
+      ],
+      "type": "object",
+      "properties": {
+        "connectionType": {
+          "description": "The type of time series connection resource.",
+          "enum": [
+            "AzureDataExplorer"
+          ],
+          "x-ms-enum": {
+            "name": "connectionType",
+            "modelAsString": true
+          },
+          "type": "string"
+        },
+        "provisioningState": {
+          "description": "The provisioning state.",
+          "enum": [
+            "Provisioning",
+            "Deleting",
+            "Updating",
+            "Succeeded",
+            "Failed",
+            "Canceled",
+            "Deleted",
+            "Warning",
+            "Suspending",
+            "Restoring",
+            "Moving",
+            "Disabled"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-ms-enum": {
+            "name": "TimeSeriesDatabaseConnectionState",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "TimeSeriesDatabaseConnection": {
+      "description": "Describes a time series database connection resource.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ExternalResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "description": "Properties of a specific time series database connection.",
+          "$ref": "#/definitions/TimeSeriesDatabaseConnectionProperties"
+        }
+      }
+    },
+    "AzureDataExplorerConnectionProperties": {
+      "description": "Properties of a time series database connection to Azure Data Explorer with data being sent via an EventHub.",
+      "x-ms-discriminator-value": "AzureDataExplorer",
+      "required": [
+        "adxEndpointUri",
+        "adxResourceId",
+        "adxDatabaseName",
+        "eventHubEndpointUri",
+        "eventHubEntityPath",
+        "eventHubNamespaceResourceId"
+      ],
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TimeSeriesDatabaseConnectionProperties"
+        }
+      ],
+      "properties": {
+        "adxResourceId": {
+          "description": "The resource ID of the Azure Data Explorer cluster.",
+          "type": "string"
+        },
+        "adxEndpointUri": {
+          "description": "The URI of the Azure Data Explorer endpoint.",
+          "type": "string"
+        },
+        "adxDatabaseName": {
+          "description": "The name of the Azure Data Explorer database.",
+          "type": "string"
+        },
+        "adxTableName": {
+          "description": "The name of the Azure Data Explorer table.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "eventHubEndpointUri": {
+          "description": "The URL of the EventHub namespace for identity-based authentication. It must include the protocol sb://",
+          "type": "string"
+        },
+        "eventHubEntityPath": {
+          "description": "The EventHub name in the EventHub namespace for identity-based authentication.",
+          "type": "string"
+        },
+        "eventHubNamespaceResourceId": {
+          "description": "The resource ID of the EventHub namespace.",
+          "type": "string"
+        },
+        "eventHubConsumerGroup": {
+          "description": "The EventHub consumer group to use when ADX reads from EventHub. Defaults to $Default.",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "TimeSeriesDatabaseConnectionListResult": {
+      "description": "A pageable list of time series database connection resources.",
+      "type": "object",
+      "properties": {
+        "nextLink": {
+          "description": "The link used to get the next page of results.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "value": {
+          "description": "A list of time series database connection resources.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TimeSeriesDatabaseConnection"
+          }
+        }
+      }
+    }
+  },
+  "parameters": {
+    "subscriptionId": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "The subscription identifier.",
+      "required": true,
+      "type": "string"
+    },
+    "api-version": {
+      "name": "api-version",
+      "in": "query",
+      "description": "Version of the DigitalTwinsInstance Management API.",
+      "required": true,
+      "type": "string",
+      "minLength": 10
+    },
+    "resourceGroupName": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "description": "The name of the resource group that contains the DigitalTwinsInstance.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "minLength": 1,
+      "maxLength": 90
+    },
+    "resourceName": {
+      "name": "resourceName",
+      "in": "path",
+      "description": "The name of the DigitalTwinsInstance.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "pattern": "^(?!-)[A-Za-z0-9-]{3,63}(?<!-)$",
+      "minLength": 3,
+      "maxLength": 63
+    },
+    "location": {
+      "name": "location",
+      "in": "path",
+      "description": "Location of DigitalTwinsInstance.",
+      "x-ms-parameter-location": "method",
+      "required": true,
+      "type": "string",
+      "minLength": 3
+    },
+    "endpointName": {
+      "name": "endpointName",
+      "in": "path",
+      "description": "Name of Endpoint Resource.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$",
+      "minLength": 2,
+      "maxLength": 49
+    },
+    "privateEndpointConnectionName": {
+      "name": "privateEndpointConnectionName",
+      "in": "path",
+      "description": "The name of the private endpoint connection.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "resourceId": {
+      "name": "resourceId",
+      "in": "path",
+      "description": "The name of the private link resource.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "timeSeriesDatabaseConnectionName": {
+      "name": "timeSeriesDatabaseConnectionName",
+      "in": "path",
+      "description": "Name of time series database connection.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$",
+      "minLength": 2,
+      "maxLength": 49
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsCheckNameAvailability_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsCheckNameAvailability_example.json
new file mode 100644
index 000000000000..d93922f24bea
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsCheckNameAvailability_example.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "location": "WestUS2",
+    "api-version": "2022-05-31",
+    "digitalTwinsInstanceCheckName": {
+      "name": "myadtinstance",
+      "type": "Microsoft.DigitalTwins/digitalTwinsInstances"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": false,
+        "message": "Name 'myadtinstance' is already taken. Please specify a different name",
+        "reason": "AlreadyExists"
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsDelete_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsDelete_WithIdentity_example.json
new file mode 100644
index 000000000000..9284f6b566a8
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsDelete_WithIdentity_example.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "identity": {
+          "type": "SystemAssigned",
+          "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Failed",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "identity": {
+          "type": "SystemAssigned",
+          "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Deleting",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsDelete_example.json
new file mode 100644
index 000000000000..62e2262cfded
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsDelete_example.json
@@ -0,0 +1,60 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Failed",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Deleting",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointDelete_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointDelete_WithIdentity_example.json
new file mode 100644
index 000000000000..d07fe8ad4167
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointDelete_WithIdentity_example.json
@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "endpointName": "myendpoint",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myendpoint",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "authenticationType": "KeyBased",
+          "provisioningState": "Failed",
+          "endpointUri": "sb://mysb.servicebus.windows.net/",
+          "entityPath": "mysbtopic",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myendpoint",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "authenticationType": "IdentityBased",
+          "provisioningState": "Deleting",
+          "endpointUri": "sb://mysb.servicebus.windows.net/",
+          "entityPath": "mysbtopic",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointDelete_example.json
new file mode 100644
index 000000000000..430fe2d333a2
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointDelete_example.json
@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "endpointName": "myendpoint",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myendpoint",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "authenticationType": "KeyBased",
+          "endpointType": "ServiceBus",
+          "provisioningState": "Failed",
+          "primaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "secondaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myendpoint",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "authenticationType": "KeyBased",
+          "endpointType": "ServiceBus",
+          "provisioningState": "Deleting",
+          "primaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "secondaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointGet_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointGet_WithIdentity_example.json
new file mode 100644
index 000000000000..7e55843c10a3
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointGet_WithIdentity_example.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "endpointName": "myServiceBus",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myServiceBus",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "authenticationType": "IdentityBased",
+          "provisioningState": "Succeeded",
+          "endpointUri": "sb://mysb.servicebus.windows.net/",
+          "entityPath": "mysbtopic",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointGet_example.json
new file mode 100644
index 000000000000..c96d9d5eb139
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointGet_example.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "endpointName": "myServiceBus",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myServiceBus",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "authenticationType": "KeyBased",
+          "provisioningState": "Succeeded",
+          "primaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "secondaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointPut_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointPut_WithIdentity_example.json
new file mode 100644
index 000000000000..ad4238d1ee44
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointPut_WithIdentity_example.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "endpointName": "myServiceBus",
+    "endpointDescription": {
+      "properties": {
+        "endpointType": "ServiceBus",
+        "authenticationType": "IdentityBased",
+        "endpointUri": "sb://mysb.servicebus.windows.net/",
+        "entityPath": "mysbtopic"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myServiceBus",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "provisioningState": "Provisioning",
+          "authenticationType": "IdentityBased",
+          "endpointUri": "sb://mysb.servicebus.windows.net/",
+          "entityPath": "mysbtopic",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myServiceBus",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "provisioningState": "Provisioning",
+          "authenticationType": "IdentityBased",
+          "endpointUri": "sb://mysb.servicebus.windows.net/",
+          "entityPath": "mysbtopic",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointPut_example.json
new file mode 100644
index 000000000000..b26ea2e9092b
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointPut_example.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "endpointName": "myServiceBus",
+    "endpointDescription": {
+      "properties": {
+        "endpointType": "ServiceBus",
+        "authenticationType": "KeyBased",
+        "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=xyzxyzoX4=;EntityPath=abcabc",
+        "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=xyzxyzoX4=;EntityPath=abcabc"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myServiceBus",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "authenticationType": "KeyBased",
+          "provisioningState": "Succeeded",
+          "primaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "secondaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+        "name": "myServiceBus",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "endpointType": "ServiceBus",
+          "authenticationType": "KeyBased",
+          "provisioningState": "Provisioning",
+          "primaryConnectionString": "",
+          "secondaryConnectionString": "",
+          "createdTime": "2019-11-19T01:10:34.350Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointsGet_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointsGet_WithIdentity_example.json
new file mode 100644
index 000000000000..a8164f71d3bb
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointsGet_WithIdentity_example.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+            "name": "myServiceBus",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:13:59.4037715Z",
+              "lastModifiedBy": "user@example.com",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+            },
+            "properties": {
+              "endpointType": "ServiceBus",
+              "authenticationType": "IdentityBased",
+              "provisioningState": "Succeeded",
+              "endpointUri": "sb://mysb.servicebus.windows.net/",
+              "entityPath": "mysbtopic",
+              "createdTime": "2019-11-19T01:10:34.350Z"
+            }
+          },
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+            "name": "myServiceBus",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:13:59.4037715Z",
+              "lastModifiedBy": "user@example.com",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+            },
+            "properties": {
+              "endpointType": "EventHub",
+              "authenticationType": "KeyBased",
+              "connectionStringPrimaryKey": "************",
+              "connectionStringSecondaryKey": "************",
+              "provisioningState": "Succeeded",
+              "createdTime": "2019-11-19T01:10:34.350Z"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointsGet_example.json
new file mode 100644
index 000000000000..e8eff91cba97
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsEndpointsGet_example.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+            "name": "myendpoint1",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:13:59.4037715Z",
+              "lastModifiedBy": "user@example.com",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+            },
+            "properties": {
+              "endpointType": "ServiceBus",
+              "authenticationType": "KeyBased",
+              "primaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+              "secondaryConnectionString": "Endpoint=sb://***/;SharedAccessKeyName=***;SharedAccessKey=***;EntityPath=***",
+              "provisioningState": "Succeeded",
+              "createdTime": "2019-11-19T01:10:34.350Z"
+            }
+          },
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/endpoints/myServiceBus",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints",
+            "name": "myendpoint2",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:13:59.4037715Z",
+              "lastModifiedBy": "user@example.com",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+            },
+            "properties": {
+              "endpointType": "EventHub",
+              "authenticationType": "KeyBased",
+              "connectionStringPrimaryKey": "************",
+              "connectionStringSecondaryKey": "************",
+              "provisioningState": "Succeeded",
+              "createdTime": "2019-11-19T01:10:34.350Z"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_WithIdentity_example.json
new file mode 100644
index 000000000000..3f53f491032c
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_WithIdentity_example.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "identity": {
+          "type": "SystemAssigned",
+          "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "d2baee3d-44c0-41b6-9961-92563de66a97",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json
new file mode 100644
index 000000000000..bbcbc9535079
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "d2baee3d-44c0-41b6-9961-92563de66a97",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "privateEndpointConnections": [
+            {
+              "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
+              "properties": {
+                "privateEndpoint": {
+                  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
+                },
+                "groupIds": [
+                  "digitalTwinsInstance"
+                ],
+                "privateLinkServiceConnectionState": {
+                  "status": "Pending",
+                  "description": "Please approve my request, thanks.",
+                  "actionsRequired": "None"
+                }
+              }
+            }
+          ],
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_example.json
new file mode 100644
index 000000000000..9a89aa86d880
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsGet_example.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:13:59.4037715Z",
+          "lastModifiedBy": "d2baee3d-44c0-41b6-9961-92563de66a97",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsListByResourceGroup_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsListByResourceGroup_example.json
new file mode 100644
index 000000000000..fdd21744af30
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsListByResourceGroup_example.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "api-version": "2022-05-31",
+    "resourceGroupName": "resRg"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+            "location": "westus2",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+            "name": "myDigitalTwinsService",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:13:59.4037715Z",
+              "lastModifiedBy": "d2baee3d-44c0-41b6-9961-92563de66a97",
+              "lastModifiedByType": "Application",
+              "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+            },
+            "properties": {
+              "createdTime": "2019-11-19T12:55:05.229Z",
+              "lastUpdatedTime": "2019-11-19T12:51:05.229Z",
+              "provisioningState": "Succeeded",
+              "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+              "publicNetworkAccess": "Enabled"
+            }
+          },
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService2",
+            "location": "westus2",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+            "name": "myDigitalTwinsService2",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:14:59.4037715Z",
+              "lastModifiedBy": "429f7e65-6d99-455e-a469-7a885be68642",
+              "lastModifiedByType": "Application",
+              "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+            },
+            "properties": {
+              "createdTime": "2019-11-19T12:55:07.229Z",
+              "lastUpdatedTime": "2019-11-19T12:55:07.229Z",
+              "provisioningState": "Provisioning",
+              "hostName": null,
+              "publicNetworkAccess": "Enabled"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsList_example.json
new file mode 100644
index 000000000000..99a363dee0b1
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsList_example.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+            "location": "westus2",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+            "name": "myDigitalTwinsService",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:13:59.4037715Z",
+              "lastModifiedBy": "d2baee3d-44c0-41b6-9961-92563de66a97",
+              "lastModifiedByType": "Application",
+              "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
+            },
+            "properties": {
+              "createdTime": "2019-11-19T12:55:05.229Z",
+              "lastUpdatedTime": "2019-11-19T12:55:07.229Z",
+              "provisioningState": "Succeeded",
+              "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+              "publicNetworkAccess": "Enabled"
+            }
+          },
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg2/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService2",
+            "location": "westus2",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+            "name": "myDigitalTwinsService2",
+            "systemData": {
+              "createdBy": "user@example.com",
+              "createdByType": "User",
+              "createdAt": "2021-03-11T17:14:59.4037715Z",
+              "lastModifiedBy": "429f7e65-6d99-455e-a469-7a885be68642",
+              "lastModifiedByType": "Application",
+              "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+            },
+            "properties": {
+              "createdTime": "2019-11-19T12:55:05.229Z",
+              "lastUpdatedTime": "2019-11-19T12:55:07.229Z",
+              "provisioningState": "Provisioning",
+              "hostName": null,
+              "publicNetworkAccess": "Enabled"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsOperationsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsOperationsList_example.json
new file mode 100644
index 000000000000..077f38020b38
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsOperationsList_example.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.DigitalTwins/models/read",
+            "display": {
+              "provider": "Azure Digital Twins",
+              "resource": "Model",
+              "operation": "Read Model",
+              "description": "Read any Model"
+            },
+            "isDataAction": true
+          },
+          {
+            "name": "Microsoft.DigitalTwins/digitalTwinsInstances/write",
+            "display": {
+              "provider": "Microsoft.DigitalTwins",
+              "resource": "digitalTwinsInstances",
+              "operation": "Create or update a Digital Twins Service instance.",
+              "description": "Create or update a Digital Twins Service instance."
+            },
+            "isDataAction": false
+          },
+          {
+            "name": "Microsoft.DigitalTwins/digitalTwinsInstances/read",
+            "display": {
+              "provider": "Microsoft.DigitalTwins",
+              "resource": "digitalTwinsInstances",
+              "operation": "Get a Digital Twins Service instance.",
+              "description": "Get a Digital Twins Service instance."
+            },
+            "isDataAction": false
+          },
+          {
+            "name": "Microsoft.DigitalTwins/digitalTwinsInstances/delete",
+            "display": {
+              "provider": "Microsoft.DigitalTwins",
+              "resource": "digitalTwinsInstances",
+              "operation": "Delete a Digital Twins Service instance.",
+              "description": "Delete a Digital Twins Service instance."
+            },
+            "isDataAction": false
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_WithIdentity_example.json
new file mode 100644
index 000000000000..93b9369500ba
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_WithIdentity_example.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "digitalTwinsPatchDescription": {
+      "identity": {
+        "type": "None"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Updating",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_WithPublicNetworkAccess.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_WithPublicNetworkAccess.json
new file mode 100644
index 000000000000..3a4d96480121
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_WithPublicNetworkAccess.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "digitalTwinsPatchDescription": {
+      "properties": {
+        "publicNetworkAccess": "Disabled"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Disabled"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Updating",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Disabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_example.json
new file mode 100644
index 000000000000..f908ce78cfe6
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPatch_example.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "digitalTwinsPatchDescription": {
+      "tags": {
+        "purpose": "dev"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Disabled"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Updating",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Disabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_WithIdentity_example.json
new file mode 100644
index 000000000000..c75c54e73f42
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_WithIdentity_example.json
@@ -0,0 +1,78 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "digitalTwinsCreate": {
+      "location": "WestUS2",
+      "identity": {
+        "type": "SystemAssigned"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "identity": {
+          "type": "SystemAssigned",
+          "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "identity": {
+          "type": "SystemAssigned"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:59.4037715Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-11-19T12:55:05.229Z",
+          "provisioningState": "Provisioning",
+          "hostName": null,
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_WithPublicNetworkAccess.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_WithPublicNetworkAccess.json
new file mode 100644
index 000000000000..a85cd293c301
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_WithPublicNetworkAccess.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "digitalTwinsCreate": {
+      "location": "WestUS2",
+      "properties": {
+        "publicNetworkAccess": "Enabled"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:59.4037715Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-11-19T12:55:05.229Z",
+          "provisioningState": "Provisioning",
+          "hostName": null,
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_example.json
new file mode 100644
index 000000000000..bcb7a821b26a
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/DigitalTwinsPut_example.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "digitalTwinsCreate": {
+      "location": "WestUS2"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "tags": {
+          "purpose": "dev"
+        },
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:15:02.5281409Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
+          "provisioningState": "Succeeded",
+          "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net",
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
+        "location": "westus2",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
+        "name": "myDigitalTwinsService",
+        "systemData": {
+          "createdBy": "user@example.com",
+          "createdByType": "User",
+          "createdAt": "2021-03-11T17:14:59.4037715Z",
+          "lastModifiedBy": "user@example.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-03-11T17:14:59.4037715Z"
+        },
+        "properties": {
+          "createdTime": "2019-11-19T12:55:05.229Z",
+          "lastUpdatedTime": "2019-11-19T12:55:05.229Z",
+          "provisioningState": "Provisioning",
+          "hostName": null,
+          "publicNetworkAccess": "Enabled"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionByConnectionName_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionByConnectionName_example.json
new file mode 100644
index 000000000000..a4b6c9941f9b
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionByConnectionName_example.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "privateEndpointConnectionName": "myPrivateConnection"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
+        "properties": {
+          "privateEndpoint": {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
+          },
+          "groupIds": [
+            "digitalTwinsInstance"
+          ],
+          "privateLinkServiceConnectionState": {
+            "status": "Pending",
+            "description": "Please approve my request, thanks.",
+            "actionsRequired": "None"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionDelete_example.json
new file mode 100644
index 000000000000..5a0dc2014fdd
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionDelete_example.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "privateEndpointConnectionName": "myPrivateConnection"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionPut_example.json
new file mode 100644
index 000000000000..7ba856a57d9c
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionPut_example.json
@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31",
+    "privateEndpointConnectionName": "myPrivateConnection",
+    "privateEndpointConnection": {
+      "properties": {
+        "privateLinkServiceConnectionState": {
+          "status": "Approved",
+          "description": "Approved by johndoe@company.com."
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
+        "name": "myPrivateConnection",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
+          },
+          "groupIds": [
+            "digitalTwinsInstance"
+          ],
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Approved by johndoe@company.com."
+          }
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
+        "name": "myPrivateConnection",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
+          },
+          "groupIds": [
+            "digitalTwinsInstance"
+          ],
+          "privateLinkServiceConnectionState": {
+            "status": "Pending",
+            "description": "Awaiting approval."
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionsList_example.json
new file mode 100644
index 000000000000..1696853b3535
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateEndpointConnectionsList_example.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
+            "properties": {
+              "privateEndpoint": {
+                "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
+              },
+              "groupIds": [
+                "digitalTwinsInstance"
+              ],
+              "privateLinkServiceConnectionState": {
+                "status": "Pending",
+                "description": "Please approve my request, thanks.",
+                "actionsRequired": "None"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateLinkResourcesByGroupId_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateLinkResourcesByGroupId_example.json
new file mode 100644
index 000000000000..9593f1c66855
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateLinkResourcesByGroupId_example.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "resourceId": "subResource",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateLinkResources/myDigitalTwinsService",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/privateLinkResources",
+        "name": "myDigitalTwinsService",
+        "properties": {
+          "groupId": "digitalTwinsInstance",
+          "requiredMembers": [
+            "myDigitalTwinsService"
+          ],
+          "requiredZoneNames": [
+            "privatelink.api.wus2.digitaltwins.azure.net"
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateLinkResourcesList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateLinkResourcesList_example.json
new file mode 100644
index 000000000000..fdf703c4483c
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/PrivateLinkResourcesList_example.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateLinkResources/myDigitalTwinsService",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances/privateLinkResources",
+            "name": "myDigitalTwinsService",
+            "properties": {
+              "groupId": "digitalTwinsInstance",
+              "requiredMembers": [
+                "myDigitalTwinsService"
+              ],
+              "requiredZoneNames": [
+                "privatelink.api.wus2.digitaltwins.azure.net"
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsDelete_example.json
new file mode 100644
index 000000000000..88de1340b815
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsDelete_example.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "timeSeriesDatabaseConnectionName": "myConnection",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/timeSeriesDatabaseConnections/myConnection",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/timeSeriesDatabaseConnections",
+        "name": "myConnection",
+        "properties": {
+          "connectionType": "AzureDataExplorer",
+          "provisioningState": "Failed",
+          "adxEndpointUri": "https://mycluster.kusto.windows.net",
+          "adxResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.Kusto/clusters/mycluster",
+          "adxDatabaseName": "myDatabase",
+          "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+          "eventHubEntityPath": "myeh",
+          "eventHubConsumerGroup": "$Default",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/timeSeriesDatabaseConnections/myConnection",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/timeSeriesDatabaseConnections",
+        "name": "myConnection",
+        "properties": {
+          "connectionType": "AzureDataExplorer",
+          "provisioningState": "Deleting",
+          "adxEndpointUri": "https://mycluster.kusto.windows.net",
+          "adxResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.Kusto/clusters/mycluster",
+          "adxDatabaseName": "myDatabase",
+          "adxTableName": "myTable",
+          "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+          "eventHubEntityPath": "myeh",
+          "eventHubConsumerGroup": "$Default",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh"
+        }
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsGet_example.json
new file mode 100644
index 000000000000..b7f097370bf5
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsGet_example.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "timeSeriesDatabaseConnectionName": "myConnection",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/timeSeriesDatabaseConnections/myConnection",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/timeSeriesDatabaseConnections",
+        "name": "myConnection",
+        "properties": {
+          "connectionType": "AzureDataExplorer",
+          "provisioningState": "Succeeded",
+          "adxEndpointUri": "https://mycluster.kusto.windows.net",
+          "adxResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.Kusto/clusters/mycluster",
+          "adxDatabaseName": "myDatabase",
+          "adxTableName": "myTable",
+          "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+          "eventHubEntityPath": "myeh",
+          "eventHubConsumerGroup": "$Default",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsList_example.json
new file mode 100644
index 000000000000..f5d26bbc99d4
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsList_example.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2022-05-31"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/timeSeriesDatabaseConnections/myConnection",
+            "type": "Microsoft.DigitalTwins/digitalTwinsInstances/timeSeriesDatabaseConnections",
+            "name": "myConnection",
+            "properties": {
+              "connectionType": "AzureDataExplorer",
+              "provisioningState": "Succeeded",
+              "adxEndpointUri": "https://mycluster.kusto.windows.net",
+              "adxResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.Kusto/clusters/mycluster",
+              "adxDatabaseName": "myDatabase",
+              "adxTableName": "myTable",
+              "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+              "eventHubEntityPath": "myeh",
+              "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsPut_example.json
new file mode 100644
index 000000000000..3d95d33c3832
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2022-05-31/examples/TimeSeriesDatabaseConnectionsPut_example.json
@@ -0,0 +1,66 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "timeSeriesDatabaseConnectionName": "myConnection",
+    "api-version": "2022-05-31",
+    "timeSeriesDatabaseConnectionDescription": {
+      "properties": {
+        "connectionType": "AzureDataExplorer",
+        "adxEndpointUri": "https://mycluster.kusto.windows.net",
+        "adxResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.Kusto/clusters/mycluster",
+        "adxDatabaseName": "myDatabase",
+        "adxTableName": "myTable",
+        "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+        "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh",
+        "eventHubEntityPath": "myeh"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "azure-asyncoperation": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012",
+        "location": "https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012",
+        "retry-after": "10"
+      },
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/timeSeriesDatabaseConnections/myConnection",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/timeSeriesDatabaseConnections",
+        "name": "myConnection",
+        "properties": {
+          "connectionType": "AzureDataExplorer",
+          "provisioningState": "Provisioning",
+          "adxEndpointUri": "https://mycluster.kusto.windows.net",
+          "adxResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.Kusto/clusters/mycluster",
+          "adxDatabaseName": "myDatabase",
+          "adxTableName": "myTable",
+          "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh",
+          "eventHubEntityPath": "myeh",
+          "eventHubConsumerGroup": "$Default"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/timeSeriesDatabaseConnections/myConnection",
+        "type": "Microsoft.DigitalTwins/digitalTwinsInstances/timeSeriesDatabaseConnections",
+        "name": "myConnection",
+        "properties": {
+          "connectionType": "AzureDataExplorer",
+          "provisioningState": "Succeeded",
+          "adxEndpointUri": "https://mycluster.kusto.windows.net",
+          "adxResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.Kusto/clusters/mycluster",
+          "adxDatabaseName": "myDatabase",
+          "adxTableName": "myTable",
+          "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+          "eventHubEntityPath": "myeh",
+          "eventHubConsumerGroup": "$Default",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/readme.go.md b/specification/digitaltwins/resource-manager/readme.go.md
index b9f6ee6c703b..b5ae1a10739f 100644
--- a/specification/digitaltwins/resource-manager/readme.go.md
+++ b/specification/digitaltwins/resource-manager/readme.go.md
@@ -21,12 +21,23 @@ azure-arm: true
 
 ``` yaml $(go) && $(multiapi)
 batch:
+  - tag: package-2022-05
   - tag: package-2021-06-30-preview
   - tag: package-2020-12
   - tag: package-2020-10
   - tag: package-2020-03-01-preview
 ```
 
+### Tag: package-2022-05 and go
+
+These settings apply only when `--tag=package-2022-05 --go` is specified on the command line.
+Please also specify `--go-sdks-folder=digitaltwins`.
+
+```yaml $(tag) == 'package-2022-05' && $(go)
+namespace: digitaltwins
+output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2022-05-31/$(namespace)
+```
+
 ### Tag: package-2021-06-30-preview and go
 
 These settings apply only when `--tag=package-2021-06-30-preview --go` is specified on the command line.
diff --git a/specification/digitaltwins/resource-manager/readme.java.md b/specification/digitaltwins/resource-manager/readme.java.md
index c51051baf0de..cbd0a07bc8ce 100644
--- a/specification/digitaltwins/resource-manager/readme.java.md
+++ b/specification/digitaltwins/resource-manager/readme.java.md
@@ -22,12 +22,26 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-digitaltwins
 
 ```yaml $(java) && $(multiapi)
 batch:
+  - tag: package-2022-05
   - tag: package-2021-06-30-preview
   - tag: package-2020-12
   - tag: package-2020-10
   - tag: package-2020-03-01-preview
 ```
 
+### Tag: package-2022-05 and java
+
+These settings apply only when `--tag=package-2022-05 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java=<path to the root directory of your azure-sdk-for-java clone>`.
+
+```yaml $(tag) == 'package-2022-05' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.digitaltwins.v2022_05_31
+  output-folder: $(azure-libraries-for-java-folder)/sdk/digitaltwins/mgmt-v2022_05_31
+  regenerate-manager: true
+  generate-interface: true
+```
+
 ### Tag: package-2021-06-30-preview and java
 
 These settings apply only when `--tag=package-2021-06-30-preview --java` is specified on the command line.
diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md
index 9b500853240d..d22a316764f4 100644
--- a/specification/digitaltwins/resource-manager/readme.md
+++ b/specification/digitaltwins/resource-manager/readme.md
@@ -26,14 +26,24 @@ These are the global settings for the digitaltwins.
 
 ``` yaml
 openapi-type: arm
-tag: package-2021-06-30-preview
+tag: package-2022-05
+```
+
+
+### Tag: package-2022-05
+
+These settings apply only when `--tag=package-2022-05` is specified on the command line.
+
+```yaml $(tag) == 'package-2022-05'
+input-file:
+  - Microsoft.DigitalTwins/stable/2022-05-31/digitaltwins.json
 ```
 
 ### Tag: package-2021-06-30-preview
 
 These settings apply only when `--tag=package-2021-06-30-preview` is specified on the command line.
 
-```yaml $(tag) == 'package-2021-06-30-preview'
+``` yaml $(tag) == 'package-2021-06-30-preview'
 input-file:
   - Microsoft.DigitalTwins/preview/2021-06-30-preview/digitaltwins.json
 ```
@@ -112,7 +122,7 @@ See configuration in [readme.csharp.md](./readme.csharp.md)
 
 See configuration in [readme.java.md](./readme.java.md)
 
-#
+# 
 
 ### Suppression
 
diff --git a/specification/digitaltwins/resource-manager/readme.python.md b/specification/digitaltwins/resource-manager/readme.python.md
index 1681e4089647..b7018b741256 100644
--- a/specification/digitaltwins/resource-manager/readme.python.md
+++ b/specification/digitaltwins/resource-manager/readme.python.md
@@ -18,6 +18,7 @@ Generate all API versions currently shipped for this package
 ```yaml $(python) && $(multiapi)
 clear-output-folder: true
 batch:
+  - tag: package-2022-05
   - tag: package-2021-06-30-preview
   - tag: package-2020-12
   - tag: package-2020-10
@@ -30,6 +31,16 @@ output-folder: $(python-sdks-folder)/digitaltwins/azure-mgmt-digitaltwins/azure/
 perform-load: false
 ```
 
+### Tag: package-2022-05 and python
+
+These settings apply only when `--tag=package-2022-05 --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2022-05' && $(python)
+namespace: azure.mgmt.digitaltwins.v2022_05_31
+output-folder: $(python-sdks-folder)/digitaltwins/azure-mgmt-digitaltwins/azure/mgmt/digitaltwins/v2022_05_31
+```
+
 ### Tag: package-2021-06-30-preview and python
 
 These settings apply only when `--tag=package-2021-06-30-preview --python` is specified on the command line.