From 81268515abf554d1cb26687ed9d1b4c649b6a655 Mon Sep 17 00:00:00 2001
From: Sebastian Herzig-Patel <seherzig@microsoft.com>
Date: Thu, 16 Feb 2023 18:57:04 -0800
Subject: [PATCH] [Hub Generated] Review request for Microsoft.DigitalTwins to
 add version stable/2023-01-31 (#21643)

* Adds base for updating Microsoft.DigitalTwins from version stable/2022-10-31 to version 2023-01-31

* Updates readme

* Updates API version in new specs and examples

* Added lifecycle event tables and deletion option (#21644)

* Added lifecycle event tables and deletion option

* Add examples, add deletion option

* Add default value for recordPropertyAndItemRemovals

* Convert boolean into enum (#22083)
---
 .../stable/2023-01-31/digitaltwins.json       | 2345 +++++++++++++++++
 ...talTwinsCheckNameAvailability_example.json |   20 +
 ...gitalTwinsDelete_WithIdentity_example.json |   70 +
 .../examples/DigitalTwinsDelete_example.json  |   60 +
 ...nsEndpointDelete_WithIdentity_example.json |   63 +
 .../DigitalTwinsEndpointDelete_example.json   |   63 +
 ...TwinsEndpointGet_WithIdentity_example.json |   34 +
 .../DigitalTwinsEndpointGet_example.json      |   34 +
 ...TwinsEndpointPut_WithIdentity_example.json |   70 +
 ...sEndpointPut_WithUserIdentity_example.json |   82 +
 .../DigitalTwinsEndpointPut_example.json      |   70 +
 ...winsEndpointsGet_WithIdentity_example.json |   58 +
 .../DigitalTwinsEndpointsGet_example.json     |   58 +
 .../DigitalTwinsGet_WithIdentity_example.json |   44 +
 ...WithPrivateEndpointConnection_example.json |   51 +
 .../examples/DigitalTwinsGet_example.json     |   33 +
 ...gitalTwinsListByResourceGroup_example.json |   58 +
 .../examples/DigitalTwinsList_example.json    |   57 +
 .../DigitalTwinsOperationsList_example.json   |   54 +
 ...igitalTwinsPatch_WithIdentity_example.json |   72 +
 ...talTwinsPatch_WithPublicNetworkAccess.json |   72 +
 .../examples/DigitalTwinsPatch_example.json   |   72 +
 .../DigitalTwinsPut_WithIdentity_example.json |   90 +
 ...gitalTwinsPut_WithPublicNetworkAccess.json |   67 +
 .../examples/DigitalTwinsPut_example.json     |   67 +
 ...intConnectionByConnectionName_example.json |   29 +
 ...ivateEndpointConnectionDelete_example.json |   20 +
 .../PrivateEndpointConnectionPut_example.json |   64 +
 ...rivateEndpointConnectionsList_example.json |   32 +
 ...PrivateLinkResourcesByGroupId_example.json |   27 +
 .../PrivateLinkResourcesList_example.json     |   30 +
 ...riesDatabaseConnectionsDelete_example.json |   55 +
 ...eSeriesDatabaseConnectionsGet_example.json |   30 +
 ...SeriesDatabaseConnectionsList_example.json |   32 +
 ...nnectionsPut_WithUserIdentity_example.json |   80 +
 ...eSeriesDatabaseConnectionsPut_example.json |   75 +
 .../digitaltwins/resource-manager/readme.md   |   13 +-
 37 files changed, 4249 insertions(+), 2 deletions(-)
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/digitaltwins.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsCheckNameAvailability_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsDelete_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsDelete_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointDelete_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointDelete_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointGet_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointGet_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_WithUserIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointsGet_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointsGet_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsListByResourceGroup_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsList_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsOperationsList_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_WithPublicNetworkAccess.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_WithIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_WithPublicNetworkAccess.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionByConnectionName_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionDelete_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionPut_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionsList_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateLinkResourcesByGroupId_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateLinkResourcesList_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsDelete_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsGet_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsList_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_WithUserIdentity_example.json
 create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_example.json

diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/digitaltwins.json
new file mode 100644
index 000000000000..29a861ac7145
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/digitaltwins.json
@@ -0,0 +1,2345 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2023-01-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"
+          },
+          "Put a DigitalTwinsEndpoint resource with user assigned identity": {
+            "$ref": "./examples/DigitalTwinsEndpointPut_WithUserIdentity_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"
+          },
+          "Create or replace a time series database connection for a DigitalTwins instance with user assigned identity.": {
+            "$ref": "./examples/TimeSeriesDatabaseConnectionsPut_WithUserIdentity_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"
+          },
+          {
+            "$ref": "#/parameters/cleanupConnectionArtifacts"
+          }
+        ],
+        "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",
+            "UserAssigned",
+            "SystemAssigned,UserAssigned"
+          ],
+          "x-ms-enum": {
+            "name": "DigitalTwinsIdentityType",
+            "modelAsString": true
+          },
+          "description": "The type of Managed Identity used by the DigitalTwinsInstance."
+        },
+        "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"
+        },
+        "userAssignedIdentities": {
+          "type": "object",
+          "x-nullable": true,
+          "description": "The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form:\r\n'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.\r\n.",
+          "additionalProperties": {
+            "$ref": "#/definitions/UserAssignedIdentity"
+          }
+        }
+      }
+    },
+    "UserAssignedIdentity": {
+      "description": "The information about the user assigned identity.",
+      "type": "object",
+      "properties": {
+        "clientId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The client id of the User Assigned Identity Resource."
+        },
+        "principalId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The object id of the User Assigned Identity Resource."
+        }
+      }
+    },
+    "ManagedIdentityReference": {
+      "description": "The properties of the Managed Identity.",
+      "type": "object",
+      "properties": {
+        "type": {
+          "description": "The type of managed identity used.",
+          "enum": [
+            "SystemAssigned",
+            "UserAssigned"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "IdentityType",
+            "modelAsString": true
+          }
+        },
+        "userAssignedIdentity": {
+          "description": "The user identity ARM resource id if the managed identity type is 'UserAssigned'.",
+          "type": "string",
+          "x-nullable": true
+        }
+      }
+    },
+    "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
+        },
+        "identity": {
+          "$ref": "#/definitions/ManagedIdentityReference",
+          "description": "Managed identity properties for the endpoint.",
+          "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
+          }
+        },
+        "identity": {
+          "$ref": "#/definitions/ManagedIdentityReference",
+          "description": "Managed identity properties for the time series database connection resource.",
+          "x-nullable": 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 used for storing updates to properties of twins and relationships. Defaults to AdtPropertyEvents.",
+          "type": "string",
+          "default": "AdtPropertyEvents",
+          "x-nullable": true
+        },
+        "adxTwinLifecycleEventsTableName": {
+          "description": "The name of the Azure Data Explorer table used for recording twin lifecycle events. The table will not be created if this property is left unspecified.",
+          "type": "string",
+          "x-nullable": true
+        },
+        "adxRelationshipLifecycleEventsTableName": {
+          "description": "The name of the Azure Data Explorer table used for recording relationship lifecycle events. The table will not be created if this property is left unspecified.",
+          "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",
+          "default": "$Default",
+          "x-nullable": true
+        },
+        "recordPropertyAndItemRemovals": {
+          "description": "Specifies whether or not to record twin / relationship property and item removals, including removals of indexed or keyed values (such as map entries, array elements, etc.). This feature is de-activated unless explicitly set to 'true'. Setting this property to 'true' will generate an additional column in the property events table in ADX.",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "recordPropertyAndItemRemovals",
+            "modelAsString": true
+          },
+          "default": "false",
+          "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
+    },
+    "cleanupConnectionArtifacts": {
+      "name": "cleanupConnectionArtifacts",
+      "in": "query",
+      "description": "Specifies whether or not to attempt to clean up artifacts that were created in order to establish a connection to the time series database. This is a best-effort attempt that will fail if appropriate permissions are not in place. Setting this to 'true' does not delete any recorded data.",
+      "required": false,
+      "enum": [
+        "true",
+        "false"
+      ],
+      "type": "string",
+      "x-nullable": true,
+      "x-ms-enum": {
+        "name": "cleanupConnectionArtifacts",
+        "modelAsString": true
+      },
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsCheckNameAvailability_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsCheckNameAvailability_example.json
new file mode 100644
index 000000000000..62e67e66d211
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsCheckNameAvailability_example.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "location": "WestUS2",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsDelete_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsDelete_WithIdentity_example.json
new file mode 100644
index 000000000000..d45ef1ca0043
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsDelete_WithIdentity_example.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsDelete_example.json
new file mode 100644
index 000000000000..19e49ece16eb
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsDelete_example.json
@@ -0,0 +1,60 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointDelete_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointDelete_WithIdentity_example.json
new file mode 100644
index 000000000000..a04088b0fbdf
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-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": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointDelete_example.json
new file mode 100644
index 000000000000..8dced710eefb
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointDelete_example.json
@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "endpointName": "myendpoint",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointGet_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointGet_WithIdentity_example.json
new file mode 100644
index 000000000000..ebe2b75c8c17
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-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": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointGet_example.json
new file mode 100644
index 000000000000..8e13c013e3bf
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointGet_example.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "endpointName": "myServiceBus",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointPut_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_WithIdentity_example.json
new file mode 100644
index 000000000000..001da942414d
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_WithIdentity_example.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointPut_WithUserIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_WithUserIdentity_example.json
new file mode 100644
index 000000000000..c900f6b7ffda
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_WithUserIdentity_example.json
@@ -0,0 +1,82 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-31",
+    "endpointName": "myServiceBus",
+    "endpointDescription": {
+      "properties": {
+        "endpointType": "ServiceBus",
+        "authenticationType": "IdentityBased",
+        "endpointUri": "sb://mysb.servicebus.windows.net/",
+        "entityPath": "mysbtopic",
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentity": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity"
+        }
+      }
+    }
+  },
+  "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",
+          "identity": {
+            "type": "UserAssigned",
+            "userAssignedIdentity": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity"
+          }
+        }
+      }
+    },
+    "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",
+          "identity": {
+            "type": "UserAssigned",
+            "userAssignedIdentity": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_example.json
new file mode 100644
index 000000000000..43a76f2d26c1
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointPut_example.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointsGet_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointsGet_WithIdentity_example.json
new file mode 100644
index 000000000000..2525e271c520
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointsGet_WithIdentity_example.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsEndpointsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointsGet_example.json
new file mode 100644
index 000000000000..66482fe6108b
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsEndpointsGet_example.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsGet_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_WithIdentity_example.json
new file mode 100644
index 000000000000..2078957e1a22
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_WithIdentity_example.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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,UserAssigned",
+          "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "userAssignedIdentities": {
+            "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity": {
+              "clientId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+              "principalId": "50016170-c839-41ba-a724-51e9df440b9e"
+            }
+          }
+        },
+        "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/2023-01-31/examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json
new file mode 100644
index 000000000000..1b0e5cbb7c7e
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_WithPrivateEndpointConnection_example.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_example.json
new file mode 100644
index 000000000000..ab69dc807daa
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsGet_example.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsListByResourceGroup_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsListByResourceGroup_example.json
new file mode 100644
index 000000000000..bc4e66373f56
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsListByResourceGroup_example.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsList_example.json
new file mode 100644
index 000000000000..56f07fd9d928
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsList_example.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsOperationsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsOperationsList_example.json
new file mode 100644
index 000000000000..2918c77b302b
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsOperationsList_example.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsPatch_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_WithIdentity_example.json
new file mode 100644
index 000000000000..681ade925226
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_WithIdentity_example.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsPatch_WithPublicNetworkAccess.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_WithPublicNetworkAccess.json
new file mode 100644
index 000000000000..e50d7ff7080a
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_WithPublicNetworkAccess.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsPatch_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_example.json
new file mode 100644
index 000000000000..bbd8ffd92d26
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPatch_example.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsPut_WithIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_WithIdentity_example.json
new file mode 100644
index 000000000000..0d8c04447854
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_WithIdentity_example.json
@@ -0,0 +1,90 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-31",
+    "digitalTwinsCreate": {
+      "location": "WestUS2",
+      "identity": {
+        "type": "SystemAssigned,UserAssigned",
+        "userAssignedIdentities": {
+          "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity": {}
+        }
+      }
+    }
+  },
+  "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,UserAssigned",
+          "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+          "userAssignedIdentities": {
+            "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity": {
+              "clientId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
+              "principalId": "50016170-c839-41ba-a724-51e9df440b9e"
+            }
+          }
+        },
+        "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,UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity": {}
+          }
+        },
+        "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/2023-01-31/examples/DigitalTwinsPut_WithPublicNetworkAccess.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_WithPublicNetworkAccess.json
new file mode 100644
index 000000000000..4196167f92f1
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_WithPublicNetworkAccess.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/DigitalTwinsPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_example.json
new file mode 100644
index 000000000000..dbfe50cc24e5
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/DigitalTwinsPut_example.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/PrivateEndpointConnectionByConnectionName_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionByConnectionName_example.json
new file mode 100644
index 000000000000..51420f57510d
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionByConnectionName_example.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/PrivateEndpointConnectionDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionDelete_example.json
new file mode 100644
index 000000000000..721ce65bb3d3
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionDelete_example.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/PrivateEndpointConnectionPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionPut_example.json
new file mode 100644
index 000000000000..2e76aa723dce
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionPut_example.json
@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/PrivateEndpointConnectionsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionsList_example.json
new file mode 100644
index 000000000000..7c55b2bee484
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateEndpointConnectionsList_example.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/PrivateLinkResourcesByGroupId_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateLinkResourcesByGroupId_example.json
new file mode 100644
index 000000000000..72d0dce5bdc9
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateLinkResourcesByGroupId_example.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "resourceId": "subResource",
+    "api-version": "2023-01-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/2023-01-31/examples/PrivateLinkResourcesList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateLinkResourcesList_example.json
new file mode 100644
index 000000000000..d9984a5fb829
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/PrivateLinkResourcesList_example.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/TimeSeriesDatabaseConnectionsDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsDelete_example.json
new file mode 100644
index 000000000000..15f475d72b8c
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsDelete_example.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "timeSeriesDatabaseConnectionName": "myConnection",
+    "deleteConnectionArtifacts": "true",
+    "api-version": "2023-01-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/2023-01-31/examples/TimeSeriesDatabaseConnectionsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsGet_example.json
new file mode 100644
index 000000000000..b84c928ac8bd
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsGet_example.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "timeSeriesDatabaseConnectionName": "myConnection",
+    "api-version": "2023-01-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/2023-01-31/examples/TimeSeriesDatabaseConnectionsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsList_example.json
new file mode 100644
index 000000000000..37abb484e7d1
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsList_example.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "api-version": "2023-01-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/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_WithUserIdentity_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_WithUserIdentity_example.json
new file mode 100644
index 000000000000..8a47c27a937d
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_WithUserIdentity_example.json
@@ -0,0 +1,80 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "timeSeriesDatabaseConnectionName": "myConnection",
+    "api-version": "2023-01-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",
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentity": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity"
+        }
+      }
+    }
+  },
+  "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",
+          "recordPropertyAndItemRemovals": "false",
+          "identity": {
+            "type": "UserAssigned",
+            "userAssignedIdentity": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity"
+          }
+        }
+      }
+    },
+    "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",
+          "recordPropertyAndItemRemovals": "false",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh",
+          "identity": {
+            "type": "UserAssigned",
+            "userAssignedIdentity": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_example.json
new file mode 100644
index 000000000000..6af0252d1fc0
--- /dev/null
+++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2023-01-31/examples/TimeSeriesDatabaseConnectionsPut_example.json
@@ -0,0 +1,75 @@
+{
+  "parameters": {
+    "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e",
+    "resourceGroupName": "resRg",
+    "resourceName": "myDigitalTwinsService",
+    "timeSeriesDatabaseConnectionName": "myConnection",
+    "api-version": "2023-01-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": "myPropertyUpdatesTable",
+        "adxTwinLifecycleEventsTableName": "myTwinLifecycleEventsTable",
+        "adxRelationshipLifecycleEventsTableName": "myRelationshipLifecycleEventsTable",
+        "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+        "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh",
+        "eventHubEntityPath": "myeh",
+        "recordPropertyAndItemRemovals": "true"
+      }
+    }
+  },
+  "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": "myPropertyUpdatesTable",
+          "adxTwinLifecycleEventsTableName": "myTwinLifecycleEventsTable",
+          "adxRelationshipLifecycleEventsTableName": "myRelationshipLifecycleEventsTable",
+          "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh",
+          "eventHubEntityPath": "myeh",
+          "eventHubConsumerGroup": "$Default",
+          "recordPropertyAndItemRemovals": "true"
+        }
+      }
+    },
+    "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": "myPropertyUpdatesTable",
+          "adxTwinLifecycleEventsTableName": "myTwinLifecycleEventsTable",
+          "adxRelationshipLifecycleEventsTableName": "myRelationshipLifecycleEventsTable",
+          "eventHubEndpointUri": "sb://myeh.servicebus.windows.net/",
+          "eventHubNamespaceResourceId": "/subscriptions/c493073e-2460-45ba-a403-f3e0df1e9feg/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/myeh",
+          "eventHubEntityPath": "myeh",
+          "eventHubConsumerGroup": "$Default",
+          "recordPropertyAndItemRemovals": "true"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md
index 8edbc4b7cc5a..8a66078013a9 100644
--- a/specification/digitaltwins/resource-manager/readme.md
+++ b/specification/digitaltwins/resource-manager/readme.md
@@ -26,18 +26,27 @@ These are the global settings for the digitaltwins.
 
 ``` yaml
 openapi-type: arm
-tag: package-2022-10
+tag: package-2023-01
 ```
 
 
+### Tag: package-2023-01
+
+These settings apply only when `--tag=package-2023-01` is specified on the command line.
+
+```yaml $(tag) == 'package-2023-01'
+input-file:
+  - Microsoft.DigitalTwins/stable/2023-01-31/digitaltwins.json
+```
 ### Tag: package-2022-10
 
 These settings apply only when `--tag=package-2022-10` is specified on the command line.
 
-```yaml $(tag) == 'package-2022-10'
+``` yaml $(tag) == 'package-2022-10'
 input-file:
   - Microsoft.DigitalTwins/stable/2022-10-31/digitaltwins.json
 ```
+
 ### Tag: package-2022-05
 
 These settings apply only when `--tag=package-2022-05` is specified on the command line.