Merge pull request #272741 from baanders/4-19-adtex

ADT: Clarify public access requirement

Author: v-dirichards

articles/digital-twins/concepts-azure-digital-twins-explorer.md

@@ -37,6 +37,8 @@ Developers may find this tool especially useful in the following scenarios:
 
 The explorer's main purpose is to help you visualize and understand your graph, and update your graph as needed. For large-scale solutions and for work that should be repeated or automated, consider using the [APIs and SDKs](./concepts-apis-sdks.md) to interact with your instance through code instead.
 
+[!INCLUDE [digital-twins-explorer-private-note.md](../../includes/digital-twins-explorer-private-note.md)]
+
 ## How to access
 
 The main way to access Azure Digital Twins Explorer is through the [Azure portal](https://portal.azure.com).

articles/digital-twins/how-to-use-azure-digital-twins-explorer.md

@@ -302,7 +302,7 @@ To view the property values of a twin or a relationship, select the element in t
 
 :::image type="content" source="media/how-to-use-azure-digital-twins-explorer/twin-graph-panel-highlight-graph-properties.png" alt-text="Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and the Twin Properties panel is expanded, showing the properties of the twin." lightbox="media/how-to-use-azure-digital-twins-explorer/twin-graph-panel-highlight-graph-properties.png":::
 
-You can use this panel to directly edit writable properties. Update their values inline, and select the **Save changes** button at the top of the panel to save. When the update is saved, the screen displays a modal window showing the JSON Patch operation that was applied by the [update API](/rest/api/azure-digitaltwins/).
+You can use this panel to directly edit writable properties. Update their values inline, and select the **Save changes** button at the top of the panel to save. When the update is saved, the screen displays a modal window showing the JSON Patch operation that was applied by the [update API](/rest/api/digital-twins/dataplane/twins/digital-twins-update).
 
 :::image type="content" source="media/how-to-use-azure-digital-twins-explorer/twin-graph-panel-highlight-graph-properties-save.png" alt-text="Screenshot of Azure Digital Twins Explorer Twin Graph panel. The center of the screen displays a Path Information modal showing JSON Patch code." lightbox="media/how-to-use-azure-digital-twins-explorer/twin-graph-panel-highlight-graph-properties-save.png":::
 

articles/digital-twins/troubleshoot-known-issues.md

@@ -6,13 +6,21 @@ author: baanders
 ms.author: baanders
 ms.topic: troubleshooting
 ms.service: digital-twins
-ms.date: 02/28/2022
+ms.date: 04/19/2024
 ---
 
 # Azure Digital Twins known issues
 
 This article provides information about known issues associated with Azure Digital Twins.
 
+## Azure Digital Twins Explorer doesn't support private endpoints
+
+**Issue description:** Azure Digital Twins Explorer shows errors when attempting to use it with an Azure Digital Twins instance that uses [Private Link](concepts-security.md#private-network-access-with-azure-private-link) to disable public access. You may see a popup that says *Error fetching models.*
+
+| Does this affect me? | Cause | Resolution |
+| --- | --- | --- |
+| If you're using Azure Digital Twins with a private endpoint/Private Link, this issue will affect you when trying to view your instance in Azure Digital Twins Explorer. | Azure Digital Twins Explorer does not offer support for private endpoints. | You can deploy your own version of the Azure Digital Twins Explorer codebase privately in the cloud. For instructions on how to do this, see [Azure Digital Twins Explorer: Running in the cloud](https://github.com/Azure-Samples/digital-twins-explorer#running-in-the-cloud). Alternatively, you can manage your Azure Digital Twins instance using the [APIs and SDKs](./concepts-apis-sdks.md) instead. |
+
 ## "400 Client Error: Bad Request" in Cloud Shell
 
 **Issue description:** Commands in Cloud Shell running at *https://shell.azure.com* may intermittently fail with the error "400 Client Error: Bad Request for url: `http://localhost:50342/oauth2/token`", followed by full stack trace.

includes/digital-twins-access-explorer.md

@@ -19,5 +19,4 @@ Azure Digital Twins Explorer might automatically connect to your instance. If no
 
 If you see this box, enter *https://* into the field, followed by the host name of your instance (this can be found back on the instance's **Overview** page in the portal). These values together make up the instance URL. Select **Save** to connect to your instance.
 
->[!NOTE]
-> The hosted Azure Digital Twins Explorer can only access Azure Digital Twins instances with public access enabled. If you're using [Private Link](../articles/digital-twins/concepts-security.md#private-network-access-with-azure-private-link) to restrict access to your instance through a private endpoint, you can use Azure functions to deploy the Azure Digital Twins Explorer codebase privately in the cloud. For instructions on how to do this, see [Azure Digital Twins Explorer: Running in the cloud](https://github.com/Azure-Samples/digital-twins-explorer#running-in-the-cloud).
+[!INCLUDE [digital-twins-explorer-private-note.md](digital-twins-explorer-private-note.md)]

includes/digital-twins-explorer-private-note.md

@@ -0,0 +1,11 @@
+---
+author: baanders
+description: include file stating private endpoint limitation of Azure Digital Twins Explorer
+ms.service: digital-twins
+ms.topic: include
+ms.date: 04/19/2024
+ms.author: baanders
+---
+
+>[!IMPORTANT]
+> Azure Digital Twins Explorer **does not support** private endpoints. If you want to use Azure Digital Twins Explorer with an Azure Digital Twins instance that uses [Private Link](../articles/digital-twins/concepts-security.md#private-network-access-with-azure-private-link) to disable public access, you can deploy the Azure Digital Twins Explorer codebase privately in the cloud. For instructions on how to do this, see [Azure Digital Twins Explorer: Running in the cloud](https://github.com/Azure-Samples/digital-twins-explorer#running-in-the-cloud).