TOC.yml

- name: IoT Hub documentation
  href: index.yml
- name: Overview
  items:
    - name: IoT concepts and Azure IoT Hub
      href: iot-concepts-and-iot-hub.md
- name: Quickstarts
  expanded: true
  items:
    - name: Codeless quickstart using CLI
      href: quickstart-send-telemetry-cli.md
    - name: Send telemetry using SDK
      href: ../iot-develop/quickstart-send-telemetry-iot-hub.md?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json
    - name: Control a device
      href: quickstart-control-device.md
    - name: Auto-route messages using Bicep
      displayName: ARM, Resource Manager, Template
      href: quickstart-bicep-route-messages.md
    - name: Auto-route messages using an ARM template
      displayName: Resource Manager
      href: horizontal-arm-route-messages.md
- name: Tutorials
  items:
    - name: Route device messages to storage
      href: tutorial-routing.md
    - name: Message enrichments
      href: tutorial-message-enrichments.md
    - name: Use metrics and logs
      href: tutorial-use-metrics-and-diags.md
    - name: Perform manual failover
      href: tutorial-manual-failover.md
    - name: Configure your devices
      href: tutorial-device-twins.md
    - name: Manage device updates
      href: ../iot-hub-device-update/device-update-raspberry-pi.md
    - name: Test device connectivity
      href: tutorial-connectivity.md
    - name: Data visualization in Power BI
      href: iot-hub-live-data-visualization-in-power-bi.md
    - name: Using X.509 certificates
      items:
        - name: Introduction
          href: tutorial-x509-introduction.md
        - name: Certificate fields
          href: tutorial-x509-certificates.md
        - name: Using the supplied scripts
          href: tutorial-x509-scripts.md
        - name: Using OpenSSL
          href: tutorial-x509-openssl.md
        - name: Creating self-signed certificates
          href: tutorial-x509-self-sign.md
        - name: Proving possession
          href: tutorial-x509-prove-possession.md
        - name: Testing authentication
          href: tutorial-x509-test-certificate.md
- name: Concepts
  items:
    - name: Develop
      items:
      - name: Device-to-cloud feature guide
        href: iot-hub-devguide-d2c-guidance.md
      - name: Cloud-to-device feature guide
        href: iot-hub-devguide-c2d-guidance.md
      - name: Understand device twins
        href: iot-hub-devguide-device-twins.md
      - name: Understand module twins
        href: iot-hub-devguide-module-twins.md
      - name: Invoke direct methods on a device
        href: iot-hub-devguide-direct-methods.md
      - name: Schedule jobs on multiple devices
        href: iot-hub-devguide-jobs.md
      - name: IoT Hub endpoints
        href: iot-hub-devguide-endpoints.md
      - name: Query language
        href: iot-hub-devguide-query-language.md
      - name: Quotas and throttling
        href: iot-hub-devguide-quotas-throttling.md
      - name: Compare IoT Hub and Event Hubs
        href: iot-hub-compare-event-hubs.md
      - name: React to IoT Hub events with Event Grid
        href: iot-hub-event-grid.md
      - name: Upload files from a device
        href: iot-hub-devguide-file-upload.md
      - name: Overview of IoT Hub device streams (preview)
        href: iot-hub-device-streams-overview.md
    - name: Manage
      items:
      - name: Choose the right IoT Hub tier
        href: iot-hub-scaling.md
      - name: Pricing examples
        href: iot-hub-devguide-pricing.md
    - name: Messaging
      items:
      - name: Send and receive messages
        href: iot-hub-devguide-messaging.md
      - name: Create and read IoT Hub messages
        href: iot-hub-devguide-messages-construct.md
      - name: Send cloud-to-device messages from IoT Hub
        href: iot-hub-devguide-messages-c2d.md
      - name: Choose a device communication protocol
        href: iot-hub-devguide-protocols.md
      - name: Read device-to-cloud messages from the built-in endpoint
        href: iot-hub-devguide-messages-read-builtin.md
      - name: Message enrichments overview
        href: iot-hub-message-enrichments-overview.md    
    - name: Message routing
      items:
      - name: Use message routing to send device-to-cloud messages
        href: iot-hub-devguide-messages-d2c.md
      - name: Use custom endpoints and routing rules for device-to-cloud messages
        href: iot-hub-devguide-messages-read-custom.md
      - name: Add queries to message routes
        href: iot-hub-devguide-routing-query-syntax.md
      - name: Compare message and event routing
        href: iot-hub-event-grid-routing-comparison.md
    - name: Device management
      items:
      - name: Overview of device management
        href: iot-hub-device-management-overview.md
      - name: Manage device identities
        href: iot-hub-devguide-identity-registry.md
      - name: Device configuration best practices
        href: iot-hub-configuration-best-practices.md
    - name: Connectivity
      items:
      - name: Understanding IoT hub IP address
        href: iot-hub-understand-ip-address.md
    - name: Scaling and availability
      items:
      - name: High availability and disaster recovery
        href: iot-hub-ha-dr.md
      - name: How to clone an IoT Hub to another region
        href: iot-hub-how-to-clone.md

    - name: Control access to IoT Hub
      items:
        - name: Overview
          href: iot-hub-devguide-security.md
        - name: Control access with Azure AD
          href: iot-hub-dev-guide-azure-ad-rbac.md
        - name: Control access with SAS
          href: iot-hub-dev-guide-sas.md
    - name: IoT Hub SDKs
      items:
        - name: SDK overview
          href: iot-hub-devguide-sdks.md
        - name: Develop without the SDK
          href: iot-hub-devguide-no-sdk.md   
        - name: Manage connectivity and reliable messaging
          href: iot-hub-reliability-features-in-sdks.md
    - name: Protocol support
      items:
        - name: MQTT support
          href: iot-hub-mqtt-support.md
        - name: MQTT 5 support (preview)
          items:
            - name: MQTT 5 overview
              href: iot-hub-mqtt-5.md
            - name: MQTT 5 API reference
              href: iot-hub-mqtt-5-reference.md
        - name: AMQP support
          href: iot-hub-amqp-support.md
        - name: Supporting additional protocols
          href: ../iot-edge/iot-edge-as-gateway.md
    - name: Security
      items:
        - name: TLS support
          href: iot-hub-tls-support.md
        - name: Virtual networks support
          href: virtual-network-support.md
        - name: Security baseline
          href: /security/benchmark/azure/baselines/iot-hub-security-baseline?toc=/azure/iot-hub/TOC.json
        - name: Recommendations
          href: ../iot-fundamentals/security-recommendations.md?context=%2fazure%2fiot-hub%2frc%2frc
        - name: Security from the ground up
          href: ../iot-fundamentals/iot-security-ground-up.md?context=%2fazure%2fiot-hub%2frc%2frc
        - name: Security best practices
          href: ../iot-fundamentals/iot-security-best-practices.md?context=%2fazure%2fiot-hub%2frc%2frc
        - name: Security architecture
          href: ../iot-fundamentals/iot-security-architecture.md?context=%2fazure%2fiot-hub%2frc%2frc
        - name: Secure your IoT deployment
          href: ../iot-fundamentals/iot-security-deployment.md?context=%2fazure%2fiot-hub%2frc%2frc
        - name: Security controls by Azure Policy
          displayName: regulatory, compliance, standards, domains
          href: ./security-controls-policy.md
        - name: Secure using X.509 CA certificates
          items:
            - name: X.509 CA certificate security overview
              href: iot-hub-x509ca-overview.md
            - name: X.509 CA certificate security concepts
              href: iot-hub-x509ca-concept.md

- name: How-to guides
  items:
    - name: Develop
      items:
        - name: Use device and service SDKs
          items:
            - name: Azure IoT Embedded C SDK
              href: iot-hub-device-embedded-c-sdk.md
            - name: Azure IoT C SDK
              items:
                - name: Use the Azure IoT C SDK
                  href: iot-hub-device-sdk-c-intro.md
                  items:
                    - name: Use the IoTHubClient
                      href: iot-hub-device-sdk-c-iothubclient.md
                - name: Azure IoT C SDK resource information
                  href: https://github.com/Azure/azure-iot-sdk-c/blob/master/doc/c_sdk_resource_information.md
                - name: Develop for constrained devices
                  href: iot-hub-devguide-develop-for-constrained-devices.md
                - name: Develop for mobile devices
                  href: iot-hub-how-to-develop-for-mobile-devices.md
                - name: Develop for Android Things platform
                  href: iot-hub-how-to-android-things.md
        - name: Control a device on Android
          href: quickstart-control-device-android.md
        - name: Query Avro data from a hub route
          href: iot-hub-query-avro-data.md
        - name: Send cloud-to-device messages
          items:
            - name: .NET
              href: iot-hub-csharp-csharp-c2d.md
            - name: Java
              href: iot-hub-java-java-c2d.md
            - name: Node.js
              href: iot-hub-node-node-c2d.md
            - name: Python
              href: iot-hub-python-python-c2d.md
            - name: iOS
              href: iot-hub-ios-swift-c2d.md
        - name: Upload files from devices
          items:
            - name: .NET
              href: iot-hub-csharp-csharp-file-upload.md
            - name: Java
              href: iot-hub-java-java-file-upload.md
            - name: Node.js
              href: iot-hub-node-node-file-upload.md
            - name: Python
              href: iot-hub-python-python-file-upload.md
        - name: Get started with device twins
          items:
            - name: Node.js
              href: iot-hub-node-node-twin-getstarted.md
            - name: .NET
              href: iot-hub-csharp-csharp-twin-getstarted.md
            - name: Java
              href: iot-hub-java-java-twin-getstarted.md
            - name: Python
              href: iot-hub-python-twin-getstarted.md
        - name: Get started with module twins
          items:
            - name: Portal
              href: iot-hub-portal-csharp-module-twin-getstarted.md
            - name: .NET
              href: iot-hub-csharp-csharp-module-twin-getstarted.md
            - name: Python
              href: iot-hub-python-python-module-twin-getstarted.md
            - name: C
              href: iot-hub-c-c-module-twin-getstarted.md
            - name: Node.js
              href: iot-hub-node-node-module-twin-getstarted.md
        - name: Get started with device management
          items:
            - name: Node.js
              href: iot-hub-node-node-device-management-get-started.md
            - name: .NET
              href: iot-hub-csharp-csharp-device-management-get-started.md
            - name: Java
              href: iot-hub-java-java-device-management-getstarted.md
            - name: Python
              href: iot-hub-python-python-device-management-get-started.md
        - name: Schedule and broadcast jobs
          items:
            - name: Node.js
              href: iot-hub-node-node-schedule-jobs.md
            - name: .NET
              href: iot-hub-csharp-csharp-schedule-jobs.md
            - name: Java
              href: iot-hub-java-java-schedule-jobs.md
            - name: Python
              href: iot-hub-python-python-schedule-jobs.md
    - name: Manage
      items:
        - name: Create an IoT hub
          items:
            - name: Use Azure portal
              href: iot-hub-create-through-portal.md
            - name: Use Azure IoT Tools for VS Code
              href: iot-hub-create-use-iot-toolkit.md
            - name: Use Azure PowerShell
              href: iot-hub-create-using-powershell.md
            - name: Use Azure CLI
              href: iot-hub-create-using-cli.md
            - name: Use the REST API
              href: iot-hub-rm-rest.md
            - name: Use a template from Azure PowerShell
              displayName: Azure Resource Manager
              href: iot-hub-rm-template-powershell.md
            - name: Use a template from .NET
              href: iot-hub-rm-template.md
        - name: Configure managed identities
          href: iot-hub-managed-identity.md
        - name: Configure file upload
          items:
            - name: Use Azure portal
              href: iot-hub-configure-file-upload.md
            - name: Use Azure PowerShell
              href: iot-hub-configure-file-upload-powershell.md
            - name: Use Azure CLI
              href: iot-hub-configure-file-upload-cli.md
        - name: Upgrade an IoT hub
          href: iot-hub-upgrade.md
        - name: Configure IP filtering
          href: iot-hub-ip-filtering.md
        - name: Manage public network access
          href: iot-hub-public-network-access.md
        - name: Restrict outbound network access
          href: iot-hub-restrict-outbound-network-access.md
        - name: Automatic device management at scale
          items:
            - name: Use Azure portal
              href: iot-hub-automatic-device-management.md
            - name: Use Azure CLI
              href: iot-hub-automatic-device-management-cli.md
        - name: Bulk import and export IoT devices
          href: iot-hub-bulk-identity-mgmt.md
    - name: Monitor
      items:
        - name: Monitor IoT Hub
          href: monitor-iot-hub.md
        - name: Monitoring data reference
          href: monitor-iot-hub-reference.md
        - name: Enable message tracing
          href: iot-hub-distributed-tracing.md
        - name: IoT Hub service and resource health
          href: iot-hub-azure-service-health-integration.md
        - name: Order device connection state events from Event Grid
          href: iot-hub-how-to-order-connection-state-events.md
    - name: Deploy updates
      items:
        - name: Create a device update account
          href: ../iot-hub-device-update/create-device-update-account.md
        - name: Import an update
          href: ../iot-hub-device-update/import-update.md
        - name: Create an update group
          href: ../iot-hub-device-update/create-update-group.md
        - name: Deploy an update
          href: ../iot-hub-device-update/deploy-update.md
    - name: Use real devices
      items:
        - name: Use an online simulator
          href: iot-hub-raspberry-pi-web-simulator-get-started.md
        - name: Use a physical device
          href: iot-hub-get-started-physical.md
          items:
            - name: Raspberry Pi with Node.js
              href: iot-hub-raspberry-pi-kit-node-get-started.md
            - name: Raspberry Pi with C
              href: iot-hub-raspberry-pi-kit-c-get-started.md
    - name: Extended IoT scenarios
      items:
        - name: Manage cloud device messaging with Azure IoT Tools for VS Code
          href: iot-hub-vscode-iot-toolkit-cloud-device-messaging.md
        - name: Data Visualization in a web app
          href: iot-hub-live-data-visualization-in-web-apps.md
        - name: Weather forecast using Azure Machine Learning
          href: iot-hub-weather-forecast-machine-learning.md
        - name: Device management with Azure IoT Tools for VS Code
          href: iot-hub-device-management-iot-toolkit.md
        - name: Device management with IoT extension for Azure CLI
          href: iot-hub-device-management-iot-extension-azure-cli-2-0.md
        - name: Remote monitoring and notifications with ​Logic ​Apps
          href: iot-hub-monitoring-notifications-with-azure-logic-apps.md     
    - name: Troubleshoot and problem solution
      items:
        - name: Troubleshoot device connectivity
          href: iot-hub-troubleshoot-connectivity.md
        - name: Troubleshoot message routing
          href: troubleshoot-message-routing.md
        - name: Resolve error codes
          href: troubleshoot-error-codes.md
- name: Reference
  items:
    - name: Azure CLI
      href: /cli/azure/azure-cli-reference-for-IoT
    - name: Azure PowerShell
      href: /powershell/module/az.iothub#iothub
    - name: .NET (Device)
      href: /dotnet/api/microsoft.azure.devices.client
    - name: .NET (Service)
      href: /dotnet/api/microsoft.azure.devices
    - name: .NET (Management)
      href: /dotnet/api/overview/azure/iot/management
    - name: Java (Device)
      href: /java/api/com.microsoft.azure.sdk.iot.device
    - name: Java (Service)
      href: /java/api/com.microsoft.azure.sdk.iot.service
    - name: Node.js (Device)
      href: /javascript/api/azure-iot-device/
    - name: Node.js (Service)
      href: /javascript/api/azure-iothub/
    - name: Node.js (Management)
      href: /javascript/api/overview/azure/iot-hub
    - name: Python (Device)
      href: /python/api/azure-iot-device
    - name: Python (Service)
      href: /python/api/azure-iot-hub
    - name: Python (Management)
      href: /python/api/azure-mgmt-iothub
    - name: C device SDK
      href: /azure/iot-hub/iot-c-sdk-ref/
    - name: REST (Device)
      href: /rest/api/iothub/device
    - name: REST (Service)
      href: /rest/api/iothub/service/configuration
    - name: REST (IoT Hub Resource)
      href: /rest/api/iothub/iothubresource
    - name: REST (Certificates)
      href: /rest/api/iothub/certificates
    - name: Resource Manager template
      href: /azure/templates/microsoft.devices/iothub-allversions
    - name: Azure Policy built-ins
      displayName: samples, policies, definitions
      href: ./policy-reference.md
    - name: Feature and API retirement
      items:
        - name: TLS 1.0 and 1.1 deprecation
          href: iot-hub-tls-deprecating-1-0-and-1-1.md
        - name: Classic IP filter
          href: iot-hub-ip-filter-classic.md
- name: Resources
  items:
    - name: Support and help options
      href: ../iot-fundamentals/iot-support-help.md?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json
    - name: IoT Glossary
      href: ../iot-fundamentals/iot-glossary.md?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json
    - name: Azure IoT services
      items:
      - name: IoT Hub
        href: ../iot-hub/index.yml
      - name: IoT Hub Device Provisioning Service
        href: ../iot-dps/index.yml
      - name: IoT Central
        href: ../iot-central/index.yml
      - name: IoT Edge
        href: ../iot-edge/index.yml
      - name: Azure Maps
        href: ../azure-maps/index.yml
      - name: Time Series Insights
        href: ../time-series-insights/index.yml
    - name: IoT device developer
      href: ../iot-develop/index.yml
    - name: Azure IoT SDKs
      items:
      - name: IoT Service SDKs
        href: ./iot-hub-devguide-sdks.md#azure-iot-hub-service-sdks
      - name: IoT Device SDKs
        href: ../iot-develop/about-iot-sdks.md
    - name: Azure IoT samples
      items:
      - name: C# (.NET)
        href: https://azure.microsoft.com/resources/samples/azure-iot-samples-csharp/
      - name: Node.js
        href: https://azure.microsoft.com/resources/samples/azure-iot-samples-node/
      - name: Java
        href: https://azure.microsoft.com/resources/samples/azure-iot-samples-java/
      - name: Python
        href: https://azure.microsoft.com/resources/samples/azure-iot-samples-python/
      - name: iOS Platform
        href: https://azure.microsoft.com/resources/samples/azure-iot-samples-ios/
    - name: Azure Certified Device catalog
      href: https://devicecatalog.azure.com/
    - name: Azure IoT Developer Center
      href: https://azure.microsoft.com/develop/iot/
    - name: Customer data requests
      href: iot-hub-customer-data-requests.md
    - name: Azure Roadmap
      href: https://azure.microsoft.com/roadmap/?category=iot
    - name: Azure IoT Tools
      href: https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools
    - name: Azure IoT Explorer tool
      href: https://github.com/Azure/azure-iot-explorer
    - name: iothub-diagnostics tool
      href: https://github.com/Azure/iothub-diagnostics
    - name: Pricing
      href: https://azure.microsoft.com/pricing/details/iot-hub/
    - name: Pricing calculator
      href: https://azure.microsoft.com/pricing/calculator/
    - name: Service updates
      href: https://azure.microsoft.com/updates/?product=iot-hub
    - name: Technical case studies
      href: https://microsoft.github.io/techcasestudies/#technology=IoT&sortBy=featured
    - name: Videos
      href: https://azure.microsoft.com/documentation/videos/index/?services=iot-hub