Skip to content

Commit d801eb2

Browse files
committed
Move IoT fundamentals articles to target service docsets
Move 5 articles from articles/iot/ to their target service directories: - iot-mqtt-connect-to-iot-hub.md -> articles/iot-hub/ - iot-sdks.md -> articles/iot-hub/ - tutorial-use-mqtt.md -> articles/iot-hub/ - concepts-manage-device-reconnections.md -> articles/iot-hub/ - iot-mqtt-connect-to-iot-dps.md -> articles/iot-dps/ Changes include: - Updated ms.service metadata in moved files - Added redirects in .openpublishing.redirection.iot.json - Updated iot/TOC.yml (removed entries) - Updated iot-hub/TOC.yml (added local entries) - Updated iot-dps/toc.yml (converted to local entry) - Updated ~50 cross-references across iot-hub, iot, iot-central, iot-edge, iot-dps, and includes
1 parent 59a05ec commit d801eb2

53 files changed

Lines changed: 113 additions & 114 deletions

File tree

Some content is hidden

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

articles/iot-central/core/concepts-architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ IoT Central can also control devices by calling commands on the device. For exam
6262

6363
The telemetry, properties, and commands that a device implements are collectively known as the device capabilities. You define these capabilities in a model that the device and the IoT Central application share. In IoT Central, this model is part of the device template that defines a specific type of device. To learn more, see [Assign a device to a device template](concepts-device-templates.md#assign-a-device-to-a-device-template).
6464

65-
The device implementation should follow the [IoT Plug and Play conventions](/previous-versions/azure/iot/concepts-convention) to ensure that it can communicate with IoT Central. For more information, see the various language [SDKs and samples](../../iot/iot-sdks.md).
65+
The device implementation should follow the [IoT Plug and Play conventions](/previous-versions/azure/iot/concepts-convention) to ensure that it can communicate with IoT Central. For more information, see the various language [SDKs and samples](../../iot-hub/iot-sdks.md).
6666

6767
Devices connect to IoT Central using one the supported protocols: [MQTT, AMQP, or HTTP](../../iot-hub/iot-hub-devguide-protocols.md).
6868

articles/iot-central/core/concepts-device-implementation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ If the device gets any of the following errors when it connects, it should use a
138138

139139
To learn more about device error codes, see [Troubleshooting device connections](troubleshooting.md).
140140

141-
To learn more about implementing automatic reconnections, see [Manage device reconnections to create resilient applications](../../iot/concepts-manage-device-reconnections.md).
141+
To learn more about implementing automatic reconnections, see [Manage device reconnections to create resilient applications](../../iot-hub/concepts-manage-device-reconnections.md).
142142

143143
Currently, IoT Edge devices can't move between IoT hubs.
144144

articles/iot-central/core/howto-use-commands.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ To learn more about the command data that a device exchanges with IoT Central, s
3131

3232
To learn how to manage commands by using the IoT Central REST API, see [How to use the IoT Central REST API to control devices](../core/howto-control-devices-with-rest-api.md).
3333

34-
To learn how to implement commands in a device without using the device SDKs, see [Communicate with an IoT hub using the MQTT protocol](../../iot/iot-mqtt-connect-to-iot-hub.md).
34+
To learn how to implement commands in a device without using the device SDKs, see [Communicate with an IoT hub using the MQTT protocol](../../iot-hub/iot-mqtt-connect-to-iot-hub.md).
3535

3636
## Define your commands
3737

articles/iot-central/core/howto-use-properties.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ To learn more about the property data that a device exchanges with IoT Central,
2525

2626
To learn how to manage properties by using the IoT Central REST API, see [How to use the IoT Central REST API to control devices](../core/howto-control-devices-with-rest-api.md).
2727

28-
To learn how to implement properties in a device without using the device SDKs, see [Communicate with an IoT hub using the MQTT protocol](../../iot/iot-mqtt-connect-to-iot-hub.md).
28+
To learn how to implement properties in a device without using the device SDKs, see [Communicate with an IoT hub using the MQTT protocol](../../iot-hub/iot-mqtt-connect-to-iot-hub.md).
2929

3030
## Define your properties
3131

articles/iot/iot-mqtt-connect-to-iot-dps.md renamed to articles/iot-dps/iot-mqtt-connect-to-iot-dps.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,10 @@
22
title: Use MQTT to communicate with Azure IoT DPS
33
titleSuffix: Azure IoT Device Provisioning Service
44
description: Guidance on using the MQTT protocol to connect a device to the Azure IoT Device Provisioning Service device-facing endpoint.
5-
author: dominicbetts
6-
ms.author: dobett
7-
ms.service: azure-iot
5+
author: cwatson-cat
6+
ms.author: cwatson
7+
ms.service: azure-iot-hub
8+
ms.subservice: azure-iot-hub-dps
89
ms.topic: how-to
910
ms.date: 03/12/2025
1011
ms.custom: [amqp, mqtt]
@@ -28,7 +29,7 @@ All device communication with DPS must be secured using TLS. Therefore, DPS does
2829

2930
A device can use the MQTT protocol to connect to a DPS instance using any of the following options:
3031

31-
* The [Azure IoT device provisioning SDKs](iot-sdks.md#dps-device-sdks).
32+
* The [Azure IoT device provisioning SDKs](../iot-hub/iot-sdks.md#dps-device-sdks).
3233
* The MQTT protocol directly.
3334

3435
## Use the MQTT protocol directly from a device

articles/iot-dps/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ items:
8787
- name: Protocols
8888
items:
8989
- name: MQTT support
90-
href: ../iot/iot-mqtt-connect-to-iot-dps.md?toc=/azure/iot-dps/toc.json&bc=/azure/iot-dps/breadcrumb/toc.json
90+
href: iot-mqtt-connect-to-iot-dps.md
9191
- name: TLS support
9292
href: tls-support.md
9393
- name: Security practices for device manufacturers

articles/iot-edge/how-to-connect-downstream-device.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ Most applications use the Windows-provided TLS stack called [Schannel](/windows/
130130

131131
## Use certificates with Azure IoT SDKs
132132

133-
[Azure IoT SDKs](../iot/iot-sdks.md) connect to an IoT Edge device using simple sample applications. The samples' goal is to connect the device client and send device telemetry messages to the gateway, then close the connection and exit.
133+
[Azure IoT SDKs](../iot-hub/iot-sdks.md) connect to an IoT Edge device using simple sample applications. The samples' goal is to connect the device client and send device telemetry messages to the gateway, then close the connection and exit.
134134

135135
Before using the application-level samples, obtain the following items:
136136

articles/iot-hub/TOC.yml

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@
4040
- name: Protocol support
4141
items:
4242
- name: MQTT support
43-
href: ../iot/iot-mqtt-connect-to-iot-hub.md?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json
43+
href: iot-mqtt-connect-to-iot-hub.md
4444
- name: AMQP support
4545
href: iot-hub-amqp-support.md
4646
- name: Supporting additional protocols
@@ -242,6 +242,8 @@
242242
href: iot-hub-message-enrichments-overview.md
243243
- name: Use message enrichments
244244
href: tutorial-message-enrichments.md
245+
- name: Tutorial - Connect a device with MQTT
246+
href: tutorial-use-mqtt.md
245247
- name: Authentication and authorization
246248
items:
247249
- name: Built-in RBAC roles for IoT
@@ -303,6 +305,8 @@
303305
href: /azure/reliability/reliability-device-registry?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json
304306
- name: Disable disaster recovery
305307
href: how-to-disable-dr.md
308+
- name: Manage device reconnections
309+
href: concepts-manage-device-reconnections.md
306310
- name: Perform manual failover
307311
displayName: disaster recovery, failback, failover, geo-redundancy
308312
href: tutorial-manual-failover.md
@@ -385,7 +389,6 @@
385389
- name: X.509 certificates
386390
displayName: certificate authority (CA), subordinate CA, certificate versions, unique identifier, key identifier, binary certificate, PEM certificate, PKCS, X.509 certificates, OpenSSL, CSR, thumbprint
387391
href: reference-x509-certificates.md
388-
- name: Feature and API retirement
389392
- name: Monitoring data reference
390393
href: monitor-iot-hub-reference.md
391394
- name: Resources
@@ -413,7 +416,7 @@
413416
- name: IoT Service SDKs
414417
href: ./iot-hub-devguide-sdks.md#azure-iot-hub-service-sdks
415418
- name: IoT Device SDKs
416-
href: ../iot/iot-sdks.md
419+
href: iot-sdks.md
417420
- name: Azure IoT samples
418421
items:
419422
- name: C# (.NET)

articles/iot/concepts-manage-device-reconnections.md renamed to articles/iot-hub/concepts-manage-device-reconnections.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,12 @@
22
title: Manage device reconnections to create resilient applications
33
titleSuffix: Azure IoT
44
description: Manage the device connection and reconnection process to ensure resilient applications by using the Azure IoT Hub device SDKs.
5-
services: azure-iot
6-
author: dominicbetts
7-
ms.author: dobett
5+
author: cwatson-cat
6+
ms.author: cwatson
87
ms.date: 1/10/2025
98
ms.update-cycle: 1095-days
109
ms.topic: concept-article
11-
ms.service: azure-iot
10+
ms.service: azure-iot-hub
1211
ms.custom: [amqp, mqtt, devx-track-csharp]
1312
---
1413

articles/iot-hub/how-to-cloud-to-device-messaging.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ For more information about the cloud-to-device message lifecycle and how IoT Hub
8686

8787
## Connection reconnection policy
8888

89-
This article doesn't demonstrate a message retry policy for the device to IoT Hub connection or external application to IoT Hub connection. In production code, you should implement connection retry policies as described in [Manage device reconnections to create resilient applications](/azure/iot/concepts-manage-device-reconnections).
89+
This article doesn't demonstrate a message retry policy for the device to IoT Hub connection or external application to IoT Hub connection. In production code, you should implement connection retry policies as described in [Manage device reconnections to create resilient applications](concepts-manage-device-reconnections.md).
9090

9191
## Message retention time, retry attempts, and max delivery count
9292

0 commit comments

Comments
 (0)