Merge pull request #219383 from xujing-ms/master

Update how-to-routing-azure-cli.md

Author: prmerger-automator[bot]

articles/iot-hub/how-to-routing-azure-cli.md

@@ -18,7 +18,6 @@ To learn more about how routing works in IoT Hub, see [Use IoT Hub message routi
 ## Prerequisites
 
 The procedures that are described in the article use the following resources:
-
 * The Azure CLI
 * An IoT hub
 * An endpoint service in Azure
@@ -43,6 +42,7 @@ To create an IoT hub route, you need at least one other Azure service to use as
 
 Decide which route type you want to create: an event hub, a Service queue or topic, or a storage account. For the service you choose to use, complete the steps to create an endpoint service.
 
+
 # [Event Hubs](#tab/eventhubs)
 
 You can choose an Event Hubs resource (namespace and entity).
@@ -185,6 +185,24 @@ You can choose an Azure Storage resource (account and container).
 
 For more information, see [Create a storage account](../storage/common/storage-account-create.md?tabs=azure-cli).
 
+# [Cosmos DB](#tab/cosmosdb)
+
+You can choose a Cosmos DB endpoint.
+
+### Create an Azure Storage resource with container
+
+1. Create a new Cosmos DB account for SQL API
+   ```azurecli
+   az group create --name my-resource-group --location "eastus" 
+   az cosmosdb create --name my-cosmosdb-account --resource-group my-resource-group 
+   ```
+2. Create a Cosmos DB container
+   ```azurecli
+   az cosmosdb sql database create --account-name my-cosmosdb-account --resource-group my-resource-group --name my-cosmosdb-database
+   az cosmosdb sql container create --account-name my-cosmosdb-account --resource-group my-resource-group --database-name my-cosmosdb-database --name my-cosmosdb-database-container --partition-key-path "/my/path"
+   ```
+For more information, see [Create an Azure Cosmos DB for NoSQL](/cosmos-db/scripts/cli/nosql/create).
+
 ---
 
 ## Create an endpoint
@@ -283,6 +301,32 @@ The commands in the following procedures use these references:
 
    For more parameter options, see [az iot hub routing-endpoint](/cli/azure/iot/hub/routing-endpoint).
 
+# [Cosmos DB](#tab/cosmosdb)
+
+References used in the following commands:
+* [az cosmosdb](/cli/azure/cosmosdb)
+* [az iot hub](/cli/azure/iot/hub)
+
+### Create a Cosmos DB endpoint
+
+1. Find the Cosmos DB connection string and copy for later use.
+
+   ```azurecli
+   az cosmosdb keys list --name my-cosmosdb-account --resource-group my-resource-group --type connection-strings
+   ```
+
+1. Create your custom endpoint. Use the connection string in this command that you copied in the last step. The `endpoint-type` must be `eventhub`, otherwise all other values should be your own.
+
+   ```azurecli
+   az iot hub message-endpoint cosmosdb-collection create --resource-group my-resource-group --hub-name my-iot-hub --endpoint-name my-cosmosdb-endpoint --endpoint-account my-cosmosdb-account --database-name my-cosmosdb-database --container my-cosmosdb-database-container --connection-string "copied-connection-string"
+   ```
+> [!NOTE]
+> If you are using managed identities instead of connection string, you have to use the following command to authenticate your identity to the CosmosDB account.
+   To see all routing endpoint options, see [az iot hub routing-endpoint](/cli/azure/iot/hub/routing-endpoint).
+   
+   ```azurecli
+   az cosmosdb sql role assignment create -a my-cosmosdb-account -g my-resource-group --scope '/' -n 'Cosmos DB Built-in Data Contributor' -p "IoT Hub System Assigned or User Assigned Identity"
+   ```
 ---
 
 ## Create an IoT Hub route
@@ -410,7 +454,37 @@ In IoT Hub, you can create a route to send messages or capture events. Each rout
         "source": "DeviceConnectionStateEvents"
       }
    ```
+# [Cosmos DB](#tab/cosmosdb)
+
+1. With your existing Cosmos DB endpoint, create a new IoT Hub route, using that endpoint. Use the endpoint name for `endpoint`. Use a unique name for `route-name`.
+
+   The default fallback route in IoT Hub collects messages from `DeviceMessages`, so let's choose another option for our custom route, such as `DeviceConnectionStateEvents`. For more source options, see [az iot hub route](/cli/azure/iot/hub/route#az-iot-hub-route-create-required-parameters).
+
+   ```azurecli
+   az iot hub route create --endpoint my-cosmosdb-endpoint --hub-name my-iot-hub --route-name my-cosmosdb-route --source deviceconnectionstateevents
+   ```
 
+1. A new route should show in your IoT hub. Run this command to confirm the route is there.
+
+   ```azurecli
+   az iot hub route list -g my-resource-group --hub-name my-iot-hub
+   ```
+   
+   You should see a similar response in your console.
+
+   ```json
+   [
+      {
+        "condition": "true",
+        "endpointNames": [
+          "my-cosmosdb-endpoint"
+        ],
+        "isEnabled": true,
+        "name": "my-cosmosdb-route",
+        "source": "DeviceConnectionStateEvents"
+      }
+   ]
+   ```
 ---
 
 ### Update an IoT Hub route
@@ -452,4 +526,5 @@ az iot hub route delete --resource-group my-resource-group --hub-name my-iot-hub
 
 In this how-to article, you learned how to create a route and endpoint for Event Hubs, Service Bus queues and topics, and Azure Storage.
 
-To learn more about message routing, see [Tutorial: Send device data to Azure Storage by using IoT Hub message routing](./tutorial-routing.md?tabs=cli). In the tutorial, you create a storage route and test it with a device in your IoT hub.
+To learn more about message routing, see [Tutorial: Send device data to Azure Storage by using IoT Hub message routing](./tutorial-routing.md?tabs=cli). In the tutorial, you create a storage route and test it with a device in your IoT hub.
+

articles/iot-hub/iot-hub-device-management-iot-toolkit.md

@@ -13,7 +13,7 @@ ms.author: junhan
 
 ![End-to-end diagram](media/iot-hub-get-started-e2e-diagram/2.png)
 
-In this article, you learn how to use Azure IoT Tools for Visual Studio Code with various management options on your development machine. [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) is a useful Visual Studio Code extension that makes IoT Hub management and IoT application development easier. It comes with management options that you can use to perform various tasks.
+In this article, you learn how to use Azure IoT Tools for Visual Studio Code with various management options on your development machine. [Azure IoT Hub for VS Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) is a useful Visual Studio Code extension that makes IoT Hub management and IoT application development easier. It comes with management options that you can use to perform various tasks.
 
 [!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-whole.md)]
 
@@ -35,7 +35,7 @@ Device twins are JSON documents that store device state information (metadata, c
 * An active Azure subscription.
 * An Azure IoT hub under your subscription.
 * [Visual Studio Code](https://code.visualstudio.com/)
-* [Azure IoT Tools for VS Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) or copy this URL and paste it into a browser window:`vscode:extension/vsciot-vscode.azure-iot-tools`.
+* [Azure IoT Hub for VS Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) or copy this URL and paste it into a browser window:`vscode:extension/vsciot-vscode.azure-iot-toolkit`.
 
 ## Sign in to access your IoT hub
 
@@ -86,6 +86,6 @@ To send a message from your IoT hub to your device, follow these steps:
 
 ## Next steps
 
-You've learned how to use Azure IoT Tools extension for Visual Studio Code with various management options.
+You've learned how to use Azure IoT Hub for Visual Studio Code with various management options.
 
 [!INCLUDE [iot-hub-get-started-next-steps](../../includes/iot-hub-get-started-next-steps.md)]