Skip to content

Commit 652fdc7

Browse files
committed
touchups
1 parent 9358a49 commit 652fdc7

File tree

2 files changed

+7
-8
lines changed

2 files changed

+7
-8
lines changed

articles/iot-hub-device-update/create-device-update-account.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -20,20 +20,20 @@ A Device Update account is a resource in your Azure subscription. A Device Updat
2020
# [Azure portal](#tab/portal)
2121

2222
- **Owner** or **User Access Administrator** role permissions in an Azure subscription
23-
- A Standard (S1) or above instance of Azure IoT Hub
23+
- A Standard (S1) or higher instance of Azure IoT Hub
2424
- An Azure Storage account to store diagnostics logs for your Device Update instance
2525

2626
# [Azure CLI](#tab/cli)
2727

2828
- **Owner** or **User Access Administrator** role permissions in an Azure subscription
29-
- A Standard (S1) or above instance of Azure IoT Hub
29+
- A Standard (S1) or higher instance of Azure IoT Hub
3030
- The Bash environment in [Azure Cloud Shell](../cloud-shell/quickstart.md). Select **Launch Cloud Shell** to open Cloud Shell.
3131

3232
:::image type="icon" source="~/reusable-content/ce-skilling/azure/media/cloud-shell/launch-cloud-shell-button.png" alt-text="Button to launch the Azure Cloud Shell." border="false" link="https://shell.azure.com":::
3333

3434
Or, if you prefer to run Azure CLI commands locally:
3535

36-
1. [Install Azure CLI](/cli/azure/install-azure-cli). Run [az version](/cli/azure/reference-index#az-version) to find the installed version and dependent libraries, and [az upgrade](/cli/azure/reference-index#az-upgrade) to install the latest version.
36+
1. [Install Azure CLI](/cli/azure/install-azure-cli). Run [az version](/cli/azure/reference-index#az-version) to see the installed Azure CLI version and dependent libraries, and [az upgrade](/cli/azure/reference-index#az-upgrade) to install the latest version.
3737
1. Sign in to Azure by running [az login](/cli/azure/reference-index#az-login).
3838
1. Install the `azure-iot` extension when prompted on first use. To make sure you're using the latest version of the extension, run `az extension update --name azure-iot`.
3939

@@ -44,7 +44,7 @@ A Device Update account is a resource in your Azure subscription. A Device Updat
4444
# [Azure portal](#tab/portal)
4545

4646
1. In the [Azure portal](https://portal.azure.com), search for and select **Device Update for IoT Hubs**.
47-
1. Select **Create**, or **Create Device Update for IoT Hub** if this is your first Device Update account.
47+
1. On the **Device Update for IoT Hubs** screen, select **Create** or **Create Device Update for IoT Hub**.
4848

4949
:::image type="content" source="media/create-device-update-account/device-update-marketplace.png" alt-text="Screenshot of Device Update for IoT Hub resource.":::
5050

@@ -98,15 +98,14 @@ A Device Update account is a resource in your Azure subscription. A Device Updat
9898
- `<region>`: The Azure region for your account. For more information, see [Products available by region](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/). If you don't provide a region, setup uses the resource group location.
9999

100100
> [!NOTE]
101-
> Your Device Update account doesn't need to be in the same region as your IoT hub, but for better performance they should be geographically close.
101+
> Your Device Update account doesn't need to be in the same region as your IoT hub, but for better performance it should be geographically close.
102102
103-
1. Run [az iot du instance create](/cli/azure/iot/du/instance#az-iot-du-instance-create) to create a Device Update instance.
103+
1. A Device Update instance is associated with a single IoT hub. Run [az iot du instance create](/cli/azure/iot/du/instance#az-iot-du-instance-create) to create a Device Update instance and specify the IoT hub to use with the instance.
104104

105105
```azurecli
106106
az iot du instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>
107107
```
108108

109-
An *instance* of Device Update is associated with a single IoT hub. Select the IoT hub that will be used with Device Update. When you link an IoT hub to a Device Update instance, a new shared access policy is automatically created give Device Update permissions to work with IoT Hub (registry write and service connect). This policy ensures that access is only limited to Device Update.
110109

111110
In the command, replace the following placeholders with your own information:
112111

@@ -121,7 +120,7 @@ An *instance* of Device Update is associated with a single IoT hub. Select the I
121120

122121
## Configure access
123122

124-
If you have the required **Owner** or **User Access Administrator** permissions for your Azure subscription, Device Update setup automatically assigns **IoT Hub Data Contributor** role access to your Device Update service principal. This access allows Device Update to run deployment, device management, and diagnostic operations.
123+
If you have the required **Owner** or **User Access Administrator** permissions in your Azure subscription, Device Update setup automatically assigns **IoT Hub Data Contributor** role to the Device Update service principal. This role allows the Device Update instance to connect and write to the linked IoT hub to run deployment, device management, and diagnostic operations, and ensures that access is limited to the Device Update instance.
125124

126125
After you create your Device Update resources, you can configure access control to provide a combination of roles to users and applications for the right level of access. For more information, see [Configure access control roles for Device Update resources](configure-access-control-device-update.md).
127126

45 Bytes
Loading

0 commit comments

Comments
 (0)