You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-hub/iot-hub-create-through-portal.md
+3-60Lines changed: 3 additions & 60 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,7 +36,7 @@ For a complete list of options to update an IoT hub, see the [**az iot hub updat
36
36
37
37
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.
38
38
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:
40
40
41
41
:::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":::
42
42
@@ -54,64 +54,7 @@ For more detailed information about the access granted by specific permissions,
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
115
58
116
59
To delete an IoT hub, open your IoT hub in the Azure portal, then choose **Delete**.
117
60
@@ -121,5 +64,5 @@ To delete an IoT hub, open your IoT hub in the Azure portal, then choose **Delet
121
64
122
65
Learn more about managing Azure IoT Hub:
123
66
124
-
*[Message routing with IoT Hub](tutorial-routing.md)
67
+
*[Message routing with IoT Hub](how-to-routing-portal.md)
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
3
3
description: Learn how to use the Azure IoT tools for Visual Studio Code to create an Azure IoT hub in a resource group.
4
4
author: formulahendry
5
5
ms.service: iot-hub
@@ -31,35 +31,35 @@ The following steps show how to create an IoT Hub without an IoT Project in Visu
31
31
32
32
1. In VS Code, open the **Explorer** view.
33
33
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.
35
35
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":::
37
37
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.
39
39
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":::
41
41
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.
43
43
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.
45
45
46
-
7. Select your resource group.
46
+
6. Select your resource group.
47
47
48
-
8. Select a location.
48
+
7. Select a location.
49
49
50
-
9. Select a pricing tier.
50
+
8. Select a pricing tier.
51
51
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**.
53
53
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.
55
55
56
56
## Create an IoT hub and device in an existing IoT project
57
57
58
58
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.
59
59
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.
61
61
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...**.
63
63
64
64
:::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":::
65
65
@@ -68,43 +68,43 @@ This method allows you to provision in VS Code without leaving your development
68
68
69
69
1. Select the subscription you want to use.
70
70
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":::
72
72
73
73
1. Select an existing resource group or create a new [resource group](../azure-resource-manager/management/overview.md#terminology).
74
74
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":::
76
76
77
77
1. In the resource group you specified, follow the prompts to select an existing IoT Hub or create a new Azure IoT Hub.
78
78
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":::
80
80
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":::
82
82
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":::
84
84
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.
86
86
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":::
88
88
89
89
1. Select or create a new IoT Hub Device in the Azure IoT Hub you provisioned.
90
90
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":::
92
92
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":::
94
94
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.
96
96
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":::
98
98
99
99
> [!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).
101
101
102
102
## Next steps
103
103
104
104
Now that you've deployed an IoT hub using the Azure IoT Tools for Visual Studio Code, explore these articles:
105
105
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).
107
107
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)
109
109
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