Skip to content

Commit fa690ab

Browse files
committed
Add note into articles
1 parent 7939f2c commit fa690ab

16 files changed

+49
-2
lines changed

articles/digital-twins/concepts-3d-scenes-studio.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ To share your scenes with someone else, the recipient will need at least *Reader
4949
## Set up
5050

5151
To work with 3D Scenes Studio, you'll need the following required resources:
52-
* An [Azure Digital Twins instance](how-to-set-up-instance-cli.md)
52+
* An [Azure Digital Twins instance](how-to-set-up-instance-portal.md)
5353
* You'll need *Azure Digital Twins Data Owner* or *Azure Digital Twins Data Reader* access to the instance
5454
* The instance should be populated with [models](concepts-models.md) and [twins](concepts-twins-graph.md)
5555

articles/digital-twins/concepts-cli.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,8 @@ Some of the actions you can do using the command set include:
3030

3131
The command set is called `az dt`, and is part of the [Azure IoT extension for Azure CLI](https://github.com/Azure/azure-iot-cli-extension). You can view the full list of commands and their usage as part of the reference documentation for the `az iot` command set: [az dt command reference](/cli/azure/dt).
3232

33+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
34+
3335
## Uses (deploy and validate)
3436

3537
Apart from generally managing your instance, the CLI is also a useful tool for deployment and validation.

articles/digital-twins/how-to-create-app-registration.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,8 @@ ms.service: azure-digital-twins
1919

2020
This article describes how to create an [Microsoft Entra ID](../active-directory/fundamentals/active-directory-whatis.md) *app registration* that can access Azure Digital Twins. This article includes steps for the [Azure portal](https://portal.azure.com) and the [Azure CLI](/cli/azure/what-is-azure-cli).
2121

22+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
23+
2224
When working with Azure Digital Twins, it's common to interact with your instance through client applications. Those applications need to authenticate with Azure Digital Twins, and some of the [authentication mechanisms](how-to-authenticate-client.md) that apps can use involve an app registration.
2325

2426
The app registration isn't required for all authentication scenarios. However, if you're using an authentication strategy or code sample that does require an app registration, this article shows you how to set one up and grant it permissions to the Azure Digital Twins APIs. It also covers how to collect important values that you need to use the app registration when authenticating.
@@ -240,6 +242,8 @@ The app registration should show up in the list along with the role you assigned
240242

241243
# [CLI](#tab/cli)
242244

245+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
246+
243247
Use the [az dt role-assignment create](/cli/azure/dt/role-assignment#az-dt-role-assignment-create) command to assign the role (you must have [sufficient permissions](how-to-set-up-instance-cli.md#prerequisites-permission-requirements) in the Azure subscription). The command requires you to pass in the name of the role you want to assign, the name of your Azure Digital Twins instance, and either the name or the object ID of the app registration.
244248

245249
```azurecli-interactive

articles/digital-twins/how-to-create-data-history-connection.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,8 @@ This command also creates three tables in your Azure Data Explorer database to s
171171

172172
# [CLI](#tab/cli)
173173

174+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
175+
174176
Use the command in this section to create a data history connection and the tables in Azure Data Explorer. The command always creates a table for historized twin property updates, and it includes parameters to create the tables for relationship lifecycle and twin lifecycle events.
175177

176178
>[!NOTE]

articles/digital-twins/how-to-create-endpoints.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@ This article explains how to create an *endpoint* for Azure Digital Twin events
2020

2121
Routing [event notifications](concepts-event-notifications.md) from Azure Digital Twins to downstream services or connected compute resources is a two-step process: create endpoints, then create event routes that send data to those endpoints. This article covers the first step, setting up endpoints that can receive the events. Later, you can create [event routes](how-to-create-routes.md) that specify which events generated by Azure Digital Twins are delivered to which endpoints.
2222

23+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
24+
2325
## Prerequisites
2426

2527
* An Azure account, which you can [set up for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
@@ -86,6 +88,8 @@ Now the Event Grid topic, event hub, or Service Bus topic is available as an end
8688

8789
# [CLI](#tab/cli)
8890

91+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
92+
8993
The following examples show how to create endpoints using the [az dt endpoint create](/cli/azure/dt/endpoint/create) command for the [Azure Digital Twins CLI](/cli/azure/dt). Replace the placeholders in the commands with the details of your own resources.
9094

9195
To create an Event Grid endpoint:

articles/digital-twins/how-to-create-routes.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,8 @@ Next, follow the instructions below if you intend to use the Azure CLI while fol
3737

3838
[!INCLUDE [azure-cli-prepare-your-environment-h3.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-h3.md)]
3939

40+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
41+
4042
## Create an event route
4143

4244
After [creating an endpoint](how-to-create-endpoints.md), you'll need to define an *event route* to actually send data to the endpoint. These routes let developers wire up event flow, throughout the system and to downstream services. A single route can allow multiple notifications and event types to be selected. Read more about event routes in [Endpoints and event routes](concepts-route-events.md).
@@ -80,6 +82,8 @@ When finished, select the **Save** button to create your event route.
8082

8183
# [CLI](#tab/cli2)
8284

85+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
86+
8387
Routes can be managed using the [az dt route](/cli/azure/dt/route) commands for the Azure Digital Twins CLI.
8488

8589
For more information about using the CLI and what commands are available, see [Azure Digital Twins CLI command set](concepts-cli.md).

articles/digital-twins/how-to-enable-private-link.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,8 @@ Once a private endpoint has been created for your Azure Digital Twins instance,
168168

169169
For more information and examples, see the [az dt network private-endpoint reference documentation](/cli/azure/dt/network/private-endpoint).
170170

171+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
172+
171173
### Get more Private Link information
172174

173175
You can get more information about the Private Link status of your instance with the [az dt network private-link](/cli/azure/dt/network/private-link) commands. Operations include:
@@ -200,6 +202,8 @@ To disable or enable public network access in the [Azure portal](https://portal.
200202

201203
# [CLI](#tab/cli-2)
202204

205+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
206+
203207
In the Azure CLI, you can disable or enable public network access by adding a `--public-network-access` parameter to the `az dt create` command. While this command can also be used to create a new instance, you can use it to edit the properties of an existing instance by providing it the name of an instance that already exists. (For more information about this command, see its [reference documentation](/cli/azure/dt#az-dt-create) or the [general instructions for setting up an Azure Digital Twins instance](how-to-set-up-instance-cli.md#create-the-azure-digital-twins-instance)).
204208

205209
To disable public network access for an Azure Digital Twins instance, use the `--public-network-access` parameter like this:

articles/digital-twins/how-to-ingest-iot-hub-data.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,8 @@ You then need to create one twin using this model. Use the following command to
5757
az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties '{"Temperature": 0.0}'
5858
```
5959

60+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
61+
6062
When the twin is created successfully, the CLI output from the command should look something like this:
6163
```json
6264
{

articles/digital-twins/how-to-set-up-instance-cli.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ Use these values in the following [az dt command](/cli/azure/dt) to create the i
4444
az dt create --dt-name <name-for-your-Azure-Digital-Twins-instance> --resource-group <your-resource-group> --location <region>
4545
```
4646

47+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
48+
4749
There are several optional parameters that can be added to the command to specify additional things about your resource during creation, including creating a managed identity for the instance or enabling/disabling public network access. For a full list of supported parameters, see the [az dt create](/cli/azure/dt#az-dt-create) reference documentation.
4850

4951
### Create the instance with a managed identity

articles/digital-twins/troubleshoot-error-403-digital-twins.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,8 @@ If you're an Owner on the subscription, you can run this command yourself. If yo
5454
az dt role-assignment create --dt-name <your-Azure-Digital-Twins-instance> --assignee "<your-Azure-AD-email>" --role "Azure Digital Twins Data Owner"
5555
```
5656

57+
[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
58+
5759
For more information about this role requirement and the assignment process, see [Set up your user's access permissions](how-to-set-up-instance-CLI.md#set-up-user-access-permissions).
5860

5961
If you have this role assignment already and you're using a Microsoft Entra app registration to authenticate a client app, you can continue to the next solution if this solution didn't resolve the 403 issue.

0 commit comments

Comments
 (0)