Skip to content

Commit 2a9ea5a

Browse files
authored
Merge pull request #228538 from kgremban/feb24-deleterouting
Remove redundant routing section
2 parents 38379ae + 46f5f66 commit 2a9ea5a

File tree

3 files changed

+36
-93
lines changed

3 files changed

+36
-93
lines changed

articles/iot-hub/iot-hub-create-through-portal.md

Lines changed: 3 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ For a complete list of options to update an IoT hub, see the [**az iot hub updat
3636

3737
You can also view or modify the list of shared access policies by choosing **Shared access policies** in the **Security settings** section. These policies define the permissions for devices and services to connect to IoT Hub.
3838

39-
Select **Add shared access policy** to open the **Add shared access policy** blade. You can enter the new policy name and the permissions that you want to associate with this policy, as shown in the following screenshot:
39+
Select **Add shared access policy** to open the **Add shared access policy** page. You can enter the new policy name and the permissions that you want to associate with this policy, as shown in the following screenshot:
4040

4141
:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-shared-access-policy.png" alt-text="Screen capture showing how to add a shared access policy." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-shared-access-policy.png":::
4242

@@ -54,64 +54,7 @@ For more detailed information about the access granted by specific permissions,
5454

5555
[!INCLUDE [iot-hub-include-create-device](../../includes/iot-hub-include-create-device.md)]
5656

57-
## Message routing for an IoT hub
58-
59-
Select **Message routing** under **Hub settings** to see the **Message routing** pane for your IoT hub, where you define routes, custom endpoints, and message enrichments. [Message routing](iot-hub-devguide-messages-d2c.md) enables you to manage how data is sent from your devices to your endpoints. The first step is to add a new route. Then you can add an existing endpoint to the route, or create a new one of the types supported, such as blob storage.
60-
61-
### Routes
62-
63-
**Routes** is the first tab on the **Message routing** pane. To add a new route, select **+ Add**.
64-
65-
:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-message-routing.png" alt-text="Screen capture showing the 'Message Routing' pane with the '+ Add' button." lightbox="./media/iot-hub-create-through-portal/iot-hub-message-routing.png":::
66-
67-
You see the following screen, which allows you to add a route to your IoT hub.
68-
69-
:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-route-storage-endpoint.png" alt-text="Screen capture showing how to add an endpoint to a new route." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-route-storage-endpoint.png":::
70-
71-
Name your route. The route name must be unique within the list of routes for that hub.
72-
73-
For **Endpoint**, select one from the dropdown list or add a new one. In this example, a storage account and container are already available. To add them as an endpoint, choose **+ Add endpoint** next to the **Endpoint** dropdown and select **Storage**.
74-
75-
The following screen shows where the storage account and container are specified.
76-
77-
:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-routing-add-storage-endpoint.png" alt-text="Screen capture showing how to add a storage endpoint for a route." lightbox="./media/iot-hub-create-through-portal/iot-hub-routing-add-storage-endpoint.png":::
78-
79-
Add an endpoint name in **Endpoint name** if needed. Select **Pick a container** to select the storage account and container. Choose a storage account and a container, then select **Select** to return to the **Add a storage endpoint** pane. Use the defaults for the rest of the fields and **Create** to create the endpoint for the storage account and add it to the routing rules.
80-
81-
You return to the **Add a route** page. For **Data source**, select Device Telemetry Messages.
82-
83-
Next, add a routing query. In this example, the messages that have an application property called `level` with a value equal to `critical` are routed to the storage account.
84-
85-
:::image type="content" source="./media/iot-hub-create-through-portal/iot-hub-add-route.png" alt-text="Screen capture showing how to save a new route." lightbox="./media/iot-hub-create-through-portal/iot-hub-add-route.png":::
86-
87-
Select **Save** to save the routing rule. You return to the **Message routing** pane, and your new routing rule is displayed.
88-
89-
### Custom endpoints
90-
91-
If you have a custom endpoint to add, select the **Custom endpoints** tab. You see custom endpoints if they were previously created. From here, you can add new endpoints or delete existing endpoints.
92-
93-
> [!NOTE]
94-
> If you delete a route, it does not delete the endpoints assigned to that route. To delete an endpoint, select the **Custom endpoints** tab, select the endpoint you want to delete, then choose **Delete**.
95-
96-
You can read more about custom endpoints in [IoT hub endpoints](iot-hub-devguide-endpoints.md).
97-
98-
You can define up to 10 custom endpoints for an IoT hub.
99-
100-
To see a full example of how to use custom endpoints with routing, see [Message routing with IoT Hub](tutorial-routing.md).
101-
102-
## Find a specific IoT hub
103-
104-
Here a few ways to find a specific IoT hub in your subscription:
105-
106-
1. From the Azure homepage, select the **IoT Hub** icon. Find and select your IoT hub from the list.
107-
108-
:::image type="content" source="./media/iot-hub-create-through-portal/select-iot-hub.png" alt-text="Screen capture showing how to find your IoT hub.":::
109-
110-
1. If you know the resource group to which the IoT hub belongs, choose **Resource groups**, then select the resource group from the list. The resource group screen shows all of the resources in that group, including IoT hubs. Select your hub.
111-
112-
2. Choose **All resources**. On the **All resources** pane, there's a filter that defaults to `Type equals **all**`. Select the filter, uncheck `Select all`. Find `IoT Hub` in the list of resource types for the filter and check it. Select **Apply** to apply the new filter, and the entries are filtered to show only your IoT hubs.
113-
114-
## Delete the IoT hub
57+
## Delete an IoT hub
11558

11659
To delete an IoT hub, open your IoT hub in the Azure portal, then choose **Delete**.
11760

@@ -121,5 +64,5 @@ To delete an IoT hub, open your IoT hub in the Azure portal, then choose **Delet
12164

12265
Learn more about managing Azure IoT Hub:
12366

124-
* [Message routing with IoT Hub](tutorial-routing.md)
67+
* [Message routing with IoT Hub](how-to-routing-portal.md)
12568
* [Monitor your IoT hub](monitor-iot-hub.md)
Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Create an Azure IoT Hub using Azure IoT Tools for VS Code | Microsoft Docs
2+
title: Create an Azure IoT Hub using Azure IoT Tools for Visual Studio Code | Microsoft Docs
33
description: Learn how to use the Azure IoT tools for Visual Studio Code to create an Azure IoT hub in a resource group.
44
author: formulahendry
55
ms.service: iot-hub
@@ -31,35 +31,35 @@ The following steps show how to create an IoT Hub without an IoT Project in Visu
3131

3232
1. In VS Code, open the **Explorer** view.
3333

34-
2. At the bottom of the Explorer, expand the **Azure IoT Hub** section.
34+
2. At the bottom of the Explorer, expand the **Azure IoT Hub** section.
3535

36-
:::image type="content" source="./media/iot-hub-create-use-iot-toolkit/azure-iot-hub-devices.png" alt-text="A screenshot that shows the location of the Azure IoT Hub section in VS Code." lightbox="./media/iot-hub-create-use-iot-toolkit/azure-iot-hub-devices.png":::
36+
:::image type="content" source="./media/iot-hub-create-use-iot-toolkit/azure-iot-hub-devices.png" alt-text="A screenshot that shows the location of the Azure IoT Hub section in Visual Studio Code." lightbox="./media/iot-hub-create-use-iot-toolkit/azure-iot-hub-devices.png":::
3737

38-
3. Select **Create IoT Hub** from the list in the **Azure IoT Hub** section.
38+
3. Select **Create IoT Hub** from the list in the **Azure IoT Hub** section.
3939

40-
:::image type="content" source="./media/iot-hub-create-use-iot-toolkit/create-iot-hub.png" alt-text="A screenshot that shows the location of the Create IoT Hub list item in VS Code." lightbox="./media/iot-hub-create-use-iot-toolkit/create-iot-hub.png":::
40+
:::image type="content" source="./media/iot-hub-create-use-iot-toolkit/create-iot-hub.png" alt-text="A screenshot that shows the location of the Create IoT Hub list item in Visual Studio Code." lightbox="./media/iot-hub-create-use-iot-toolkit/create-iot-hub.png":::
4141

42-
5. A pop-up will show in the bottom-right corner to let you sign in to Azure for the first time, if you're not signed in already.
42+
4. A pop-up shows in the bottom-right corner to let you sign in to Azure for the first time, if you're not signed in already.
4343

44-
6. From the command palette at the top of VS Code, select your Azure subscription.
44+
5. From the command palette at the top of VS Code, select your Azure subscription.
4545

46-
7. Select your resource group.
46+
6. Select your resource group.
4747

48-
8. Select a location.
48+
7. Select a location.
4949

50-
9. Select a pricing tier.
50+
8. Select a pricing tier.
5151

52-
10. Enter a globally unique name for your IoT hub, then press **Enter**.
52+
9. Enter a globally unique name for your IoT hub, then press **Enter**.
5353

54-
11. Wait a few minutes until the IoT hub is created. You'll see a confirmation in the output console.
54+
10. Wait a few minutes until the IoT hub is created. You'll see a confirmation in the output console.
5555

5656
## Create an IoT hub and device in an existing IoT project
5757

5858
The following steps show how to create an IoT Hub and register a device to the hub within an existing IoT project in Visual Studio (VS) Code.
5959

60-
This method allows you to provision in VS Code without leaving your development environment.
60+
This method allows you to provision in Visual Studio Code without leaving your development environment.
6161

62-
1. In the new opened project window, click `F1` to open the command palette, type and select **Azure IoT Device Workbench: Provision Azure Services...**.
62+
1. In the new opened project window, press `F1` to open the command palette, type and select **Azure IoT Device Workbench: Provision Azure Services...**.
6363

6464
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision.png" alt-text="A screenshot that shows how to open the command palette in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision.png":::
6565

@@ -68,43 +68,43 @@ This method allows you to provision in VS Code without leaving your development
6868
6969
1. Select the subscription you want to use.
7070

71-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-subscription.png" alt-text="A screenshot that shows how to choose your Azure subscription in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-subscription.png":::
71+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-subscription.png" alt-text="A screenshot that shows how to choose your Azure subscription in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-subscription.png":::
7272

7373
1. Select an existing resource group or create a new [resource group](../azure-resource-manager/management/overview.md#terminology).
7474

75-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-resource-group.png" alt-text="A screenshot that shows how to choose a resource group or create a new one in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-resource-group.png":::
75+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-resource-group.png" alt-text="A screenshot that shows how to choose a resource group or create a new one in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-resource-group.png":::
7676

7777
1. In the resource group you specified, follow the prompts to select an existing IoT Hub or create a new Azure IoT Hub.
7878

79-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png" alt-text="A screenshot that shows the first prompt in choosing an existing IoT Hub in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png":::
79+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png" alt-text="A screenshot that shows the first prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png":::
8080

81-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png" alt-text="A screenshot that shows the second prompt in choosing an existing IoT Hub in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png":::
81+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png" alt-text="A screenshot that shows the second prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png":::
8282

83-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png" alt-text="A screenshot that shows the third prompt in choosing an existing IoT Hub in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png":::
83+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png" alt-text="A screenshot that shows the third prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png":::
8484

85-
1. In the output window, you'll see the Azure IoT Hub provisioned.
85+
1. In the output window, you see the Azure IoT Hub provisioned.
8686

87-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png" alt-text="A screenshot that shows the output window in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png":::
87+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png" alt-text="A screenshot that shows the output window in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png":::
8888

8989
1. Select or create a new IoT Hub Device in the Azure IoT Hub you provisioned.
9090

91-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png" alt-text="A screenshot that shows the fourth prompt in choosing an existing IoT Hub in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png":::
91+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png" alt-text="A screenshot that shows the fourth prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png":::
9292

93-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-device.png" alt-text="A screenshot that shows an example of an existing IoT Hub in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-device.png":::
93+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-device.png" alt-text="A screenshot that shows an example of an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-device.png":::
9494

95-
1. Now you have an Azure IoT Hub provisioned and a device created in it. The device connection string will be saved in VS Code.
95+
1. Now you have an Azure IoT Hub provisioned and a device created in it. The device connection string is saved in VS Code.
9696

97-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision-done.png" alt-text="A screenshot that shows IoT Hub details in the output window in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision-done.png":::
97+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision-done.png" alt-text="A screenshot that shows IoT Hub details in the output window in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision-done.png":::
9898

9999
> [!TIP]
100-
> To delete a device from your IoT hub, use the `Azure IoT Hub: Delete Device` option from the Command Palette. There is no option to delete your IoT hub in Visual Studio Code, however you can [delete your hub in the Azure portal](iot-hub-create-through-portal.md#delete-the-iot-hub).
100+
> To delete a device from your IoT hub, use the `Azure IoT Hub: Delete Device` option from the Command Palette. There is no option to delete your IoT hub in Visual Studio Code, however you can [delete your hub in the Azure portal](iot-hub-create-through-portal.md#delete-an-iot-hub).
101101
102102
## Next steps
103103

104104
Now that you've deployed an IoT hub using the Azure IoT Tools for Visual Studio Code, explore these articles:
105105

106-
* [Use the Azure IoT Tools for Visual Studio Code to send and receive messages between your device and an IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
106+
- [Use the Azure IoT Tools for Visual Studio Code to send and receive messages between your device and an IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
107107

108-
* [Use the Azure IoT Tools for Visual Studio Code for Azure IoT Hub device management](iot-hub-device-management-iot-toolkit.md)
108+
- [Use the Azure IoT Tools for Visual Studio Code for Azure IoT Hub device management](iot-hub-device-management-iot-toolkit.md)
109109

110-
* [See the Azure IoT Hub for VS Code wiki page](https://github.com/microsoft/vscode-azure-iot-toolkit/wiki).
110+
- [See the Azure IoT Hub for Visual Studio Code wiki page](https://github.com/microsoft/vscode-azure-iot-toolkit/wiki).

0 commit comments

Comments
 (0)