Skip to content

Commit 0b1c355

Browse files
Merge pull request #216974 from JimacoMS4/fix-dev-guide-references-and-links-hub
Convert developer guide article to concepts overview article and remove references t…
2 parents 72647f8 + 3d956d4 commit 0b1c355

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+78
-115
lines changed

articles/iot-hub/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,8 @@
7474
href: tutorial-x509-test-certificate.md
7575
- name: Concepts
7676
items:
77+
- name: IoT Hub concepts overview
78+
href: iot-hub-devguide.md
7779
- name: Develop
7880
items:
7981
- name: Device-to-cloud feature guide

articles/iot-hub/iot-hub-amqp-support.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Understand Azure IoT Hub AMQP support | Microsoft Docs
3-
description: Developer guide - support for devices connecting to IoT Hub device-facing and service-facing endpoints using the AMQP Protocol. Includes information about built-in AMQP support in the Azure IoT device SDKs.
3+
description: This article describes support for devices connecting to IoT Hub device-facing and service-facing endpoints using the AMQP Protocol. Includes information about built-in AMQP support in the Azure IoT device SDKs.
44
author: kgremban
55
ms.service: iot-hub
66
services: iot-hub

articles/iot-hub/iot-hub-automatic-device-management-cli.md

Lines changed: 2 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -221,16 +221,6 @@ az iot hub configuration delete --config-id [configuration id] \
221221

222222
## Next steps
223223

224-
In this article, you learned how to configure and monitor IoT devices at scale. Follow these links to learn more about managing Azure IoT Hub:
224+
In this article, you learned how to configure and monitor IoT devices at scale.
225225

226-
* [Manage your IoT Hub device identities in bulk](iot-hub-bulk-identity-mgmt.md)
227-
* [Monitor your IoT hub](monitor-iot-hub.md)
228-
229-
To further explore the capabilities of IoT Hub, see:
230-
231-
* [IoT Hub developer guide](iot-hub-devguide.md)
232-
* [Deploying AI to edge devices with Azure IoT Edge](../iot-edge/quickstart-linux.md)
233-
234-
To explore using the IoT Hub Device Provisioning Service to enable zero-touch, just-in-time provisioning, see:
235-
236-
* [Azure IoT Hub Device Provisioning Service](../iot-dps/index.yml)
226+
To learn how to manage IoT Hub device identities in bulk, see [Import and export IoT Hub device identities in bulk](iot-hub-bulk-identity-mgmt.md)

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

Lines changed: 2 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -225,16 +225,6 @@ When you delete a configuration, any device twins take on their next highest pri
225225

226226
## Next steps
227227

228-
In this article, you learned how to configure and monitor IoT devices at scale. Follow these links to learn more about managing Azure IoT Hub:
228+
In this article, you learned how to configure and monitor IoT devices at scale.
229229

230-
* [Manage your IoT Hub device identities in bulk](iot-hub-bulk-identity-mgmt.md)
231-
* [Monitor your IoT hub](monitor-iot-hub.md)
232-
233-
To further explore the capabilities of IoT Hub, see:
234-
235-
* [IoT Hub developer guide](iot-hub-devguide.md)
236-
* [Deploying AI to edge devices with Azure IoT Edge](../iot-edge/quickstart-linux.md)
237-
238-
To explore using the IoT Hub Device Provisioning Service to enable zero-touch, just-in-time provisioning, see:
239-
240-
* [Azure IoT Hub Device Provisioning Service](../iot-dps/index.yml)
230+
To learn how to manage IoT Hub device identities in bulk, see [Import and export IoT Hub device identities in bulk](iot-hub-bulk-identity-mgmt.md)

articles/iot-hub/iot-hub-bulk-identity-mgmt.md

Lines changed: 1 addition & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ while(true)
8787

8888
## Device import/export job limits
8989

90-
Only 1 active device import or export job is allowed at a time for all IoT Hub tiers. IoT Hub also has limits for rate of jobs operations. To learn more, see [Reference - IoT Hub quotas and throttling](iot-hub-devguide-quotas-throttling.md).
90+
Only 1 active device import or export job is allowed at a time for all IoT Hub tiers. IoT Hub also has limits for rate of jobs operations. To learn more, see [IoT Hub quotas and throttling](iot-hub-devguide-quotas-throttling.md).
9191

9292
## Export devices
9393

@@ -440,16 +440,3 @@ static string GetContainerSasUri(CloudBlobContainer container)
440440
In this article, you learned how to perform bulk operations against the identity registry in an IoT hub. Many of these operations, including how to move devices from one hub to another, are used in the [Managing devices registered to the IoT hub section of How to Clone an IoT Hub](iot-hub-how-to-clone.md#managing-the-devices-registered-to-the-iot-hub).
441441

442442
The cloning article has a working sample associated with it, which is located in the IoT C# samples on this page: [Azure IoT hub service samples for C#](https://github.com/Azure/azure-iot-sdk-csharp/tree/main/iothub/service/samples/how%20to%20guides), with the project being ImportExportDevicesSample. You can download the sample and try it out; there are instructions in the [How to Clone an IoT Hub](iot-hub-how-to-clone.md) article.
443-
444-
To learn more about managing Azure IoT Hub, check out the following articles:
445-
446-
* [Monitor IoT Hub](monitor-iot-hub.md)
447-
448-
To further explore the capabilities of IoT Hub, see:
449-
450-
* [IoT Hub developer guide](iot-hub-devguide.md)
451-
* [Deploying AI to edge devices with Azure IoT Edge](../iot-edge/quickstart-linux.md)
452-
453-
To explore using the IoT Hub Device Provisioning Service to enable zero-touch, just-in-time provisioning, see:
454-
455-
* [Azure IoT Hub Device Provisioning Service](../iot-dps/index.yml)

articles/iot-hub/iot-hub-compare-event-hubs.md

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,9 +38,4 @@ The following table provides details about how the two tiers of IoT Hub compare
3838

3939
Even if the only use case is device-to-cloud data ingestion, we highly recommend using IoT Hub as it provides a service that is designed for IoT device connectivity.
4040

41-
### Next steps
42-
43-
To further explore the capabilities of IoT Hub, see the [IoT Hub developer guide](iot-hub-devguide.md).
44-
45-
<!-- This one reference link is used over and over. --robinsh -->
4641
[checkmark]: ./media/iot-hub-compare-event-hubs/ic195031.png

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ If you have a custom endpoint to add, select the **Custom endpoints** tab. You s
9393
> [!NOTE]
9494
> 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**.
9595
96-
You can read more about custom endpoints in [Reference - IoT hub endpoints](iot-hub-devguide-endpoints.md).
96+
You can read more about custom endpoints in [IoT hub endpoints](iot-hub-devguide-endpoints.md).
9797

9898
You can define up to 10 custom endpoints for an IoT hub.
9999

articles/iot-hub/iot-hub-create-using-cli.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ This article shows you how to create an IoT hub using Azure CLI.
1818
[!INCLUDE [azure-cli-prepare-your-environment.md](../../includes/azure-cli-prepare-your-environment.md)]
1919

2020
When you create an IoT hub, you must create it in a resource group. Either use an existing resource group, or run the following [command to create a resource group](/cli/azure/resource):
21-
21+
2222
```azurecli-interactive
2323
az group create --name {your resource group name} --location westus
2424
```
@@ -35,15 +35,14 @@ When you create an IoT hub, you must create it in a resource group. Either use a
3535
Use the Azure CLI to create a resource group and then add an IoT hub.
3636
3737
Run the following [command to create an IoT hub](/cli/azure/iot/hub#az-iot-hub-create) in your resource group, using a globally unique name for your IoT hub:
38-
38+
3939
```azurecli-interactive
4040
az iot hub create --name {your iot hub name} \
4141
--resource-group {your resource group name} --sku S1
4242
```
4343
4444
[!INCLUDE [iot-hub-pii-note-naming-hub](../../includes/iot-hub-pii-note-naming-hub.md)]
4545

46-
4746
The previous command creates an IoT hub in the S1 pricing tier for which you're billed. For more information, see [Azure IoT Hub pricing](https://azure.microsoft.com/pricing/details/iot-hub/).
4847

4948
For more information on Azure IoT Hub commands, see the [`az iot hub`](/cli/azure/iot/hub) reference article.
@@ -87,7 +86,7 @@ az iot hub delete --name {your iot hub name} -\
8786

8887
## Next steps
8988

90-
Learn more about using an IoT hub:
89+
Learn more about the commands available in the Microsoft Azure IoT extension for Azure CLI:
9190

92-
* [IoT Hub developer guide](iot-hub-devguide.md)
93-
* [Using the Azure portal to manage IoT Hub](iot-hub-create-through-portal.md)
91+
* [IoT Hub-specific commands (az iot hub)](/cli/azure/iot/hub)
92+
* [All commands (az iot)](/cli/azure/iot)

articles/iot-hub/iot-hub-csharp-csharp-c2d.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -218,4 +218,7 @@ In this section, you modify the **SendCloudToDevice** app to request feedback, a
218218

219219
In this article, you learned how to send and receive cloud-to-device messages.
220220

221-
To learn more about developing solutions with IoT Hub, see the [IoT Hub developer guide](iot-hub-devguide.md).
221+
* To learn more about cloud-to-device messages, see [Send cloud-to-device messages from an IoT hub](iot-hub-devguide-messages-c2d.md).
222+
223+
* To learn more about IoT Hub message formats, see [Create and read IoT Hub messages](iot-hub-devguide-messages-construct.md).
224+
).

articles/iot-hub/iot-hub-customer-data-requests.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Many of the devices managed in Azure IoT Hub are not personal devices, for examp
2121

2222
Tenant administrators can use either the Azure portal or the service's REST APIs to fulfill information requests by exporting or deleting data associated with a device ID.
2323

24-
If you use the routing feature of the Azure IoT Hub service to forward device messages to other services, then data requests must be performed by the tenant admin for each routing endpoint in order to complete a full request for a given device. For more details, see the reference documentation for each endpoint. For more information about supported endpoints, see [Reference - IoT Hub endpoints](iot-hub-devguide-endpoints.md).
24+
If you use the routing feature of the Azure IoT Hub service to forward device messages to other services, then data requests must be performed by the tenant admin for each routing endpoint in order to complete a full request for a given device. For more details, see the reference documentation for each endpoint. For more information about supported endpoints, see [IoT Hub endpoints](iot-hub-devguide-endpoints.md).
2525

2626
If you use the Azure Event Grid integration feature of the Azure IoT Hub service, then data requests must be performed by the tenant admin for each subscriber of these events. For more information, see [React to IoT Hub events by using Event Grid](iot-hub-event-grid.md).
2727

0 commit comments

Comments
 (0)