TOC.yml

- name: IoT Hub Documentation
  href: index.yml
- name: Overview
  items:
    - name: What is Azure IoT Hub?
      href: about-iot-hub.md
- name: Quickstarts
  expanded: true
  items:
    - name: Send telemetry
      items:
        - name: Get started
          href: quickstart-send-telemetry-cli.md
        - name: C
          href: quickstart-send-telemetry-c.md
        - name: Node.js
          href: quickstart-send-telemetry-node.md
        - name: .NET
          href: quickstart-send-telemetry-dotnet.md
        - name: Java
          href: quickstart-send-telemetry-java.md
        - name: Python
          href: quickstart-send-telemetry-python.md
        - name: Android
          href: quickstart-send-telemetry-android.md
        - name: iOS
          href: quickstart-send-telemetry-ios.md
    - name: Control a device
      items:
        - name: Node.js
          href: quickstart-control-device-node.md
        - name: .NET
          href: quickstart-control-device-dotnet.md
        - name: Java
          href: quickstart-control-device-java.md
        - name: Python
          href: quickstart-control-device-python.md
        - name: Android
          href: quickstart-control-device-android.md
    - name: Communicate using device streams (preview)
      items:
        - name: .NET
          href: quickstart-device-streams-echo-csharp.md
        - name: Node.js
          href: quickstart-device-streams-echo-nodejs.md
        - name: C
          href: quickstart-device-streams-echo-c.md
    - name: SSH/RDP using device streams (preview)
      items:
        - name: .NET
          href: quickstart-device-streams-proxy-csharp.md
        - name: Node.js
          href: quickstart-device-streams-proxy-nodejs.md
        - name: C
          href: quickstart-device-streams-proxy-c.md
    - name: Auto-route messages using an ARM template
      displayName: Resource Manager
      href: horizontal-arm-route-messages.md
- name: Tutorials
  items:
    - name: Routing messages
      items:
        - name: Part 1 - Configure message routing
          items:
            - name: Portal
              href: tutorial-routing.md
            - name: Azure RM template
              href: tutorial-routing-config-message-routing-RM-template.md
            - name: Azure CLI
              href: tutorial-routing-config-message-routing-CLI.md
            - name: PowerShell
              href: tutorial-routing-config-message-routing-PowerShell.md
        - name: Part 2 - View message routing results
          href: tutorial-routing-view-message-routing-results.md
    - name: Message enrichments
      href: tutorial-message-enrichments.md
    - name: Use metrics and diagnostic 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 firmware updates
      href: tutorial-firmware-update.md
    - name: Test device connectivity
      href: tutorial-connectivity.md
- name: Concepts
  items:
    - name: TLS support
      href: iot-hub-tls-support.md
    - name: Virtual networks support
      href: virtual-network-support.md
    - name: Message enrichments overview
      href: iot-hub-message-enrichments-overview.md
    - name: Overview of device management
      href: iot-hub-device-management-overview.md
    - name: Compare IoT Hub and Event Hubs
      href: iot-hub-compare-event-hubs.md
    - name: Choose the right tier
      href: iot-hub-scaling.md
    - 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: Understanding IoT hub IP address
      href: iot-hub-understand-ip-address.md
    - name: Supporting additional protocols
      href: iot-hub-protocol-gateway.md
    - name: Compare message and event routing
      href: iot-hub-event-grid-routing-comparison.md
    - name: Device configuration best practices
      href: iot-hub-configuration-best-practices.md
    - name: Azure IoT SDKs platform support
      href: iot-hub-device-sdk-platform-support.md
    - name: Overview of IoT Hub device streams (preview)
      href: iot-hub-device-streams-overview.md
    - name: Developer guide
      href: iot-hub-devguide.md
      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: Send and receive messages
          href: iot-hub-devguide-messaging.md
          items:
            - name: Use message routing to send device-to-cloud messages
              href: iot-hub-devguide-messages-d2c.md
              items:
                - name: Create and read IoT Hub messages
                  href: iot-hub-devguide-messages-construct.md
                - name: Read device-to-cloud messages from the built-in endpoint
                  href: iot-hub-devguide-messages-read-builtin.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: React to IoT Hub events
              href: iot-hub-event-grid.md
            - name: Send cloud-to-device messages from IoT Hub
              href: iot-hub-devguide-messages-c2d.md
            - name: Choose a communication protocol
              href: iot-hub-devguide-protocols.md
        - name: Upload files from a device
          href: iot-hub-devguide-file-upload.md
        - name: Manage device identities
          href: iot-hub-devguide-identity-registry.md
        - name: Control access to IoT Hub
          href: iot-hub-devguide-security.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: Pricing examples
          href: iot-hub-devguide-pricing.md
        - name: Device and service SDKs
          href: iot-hub-devguide-sdks.md
        - name: MQTT support
          href: iot-hub-mqtt-support.md
        - name: AMQP support
          href: iot-hub-amqp-support.md
        - name: Glossary
          href: iot-hub-devguide-glossary.md
    - name: Security
      items:
        - name: Security baseline
          href: security-baseline.md
        - name: Recommendations
          href: /azure/iot-fundamentals/security-recommendations?context=azure/iot-hub/rc/rc
        - name: Security from the ground up
          href: /azure/iot-fundamentals/iot-security-ground-up?context=azure/iot-hub/rc/rc
        - name: Security best practices
          href: /azure/iot-fundamentals/iot-security-best-practices?context=azure/iot-hub/rc/rc
        - name: Security architecture
          href: /azure/iot-fundamentals/iot-security-architecture?context=azure/iot-hub/rc/rc
        - name: Secure your IoT deployment
          href: /azure/iot-fundamentals/iot-security-deployment?context=azure/iot-hub/rc/rc
        - 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
          href: iot-hub-devguide-sdks.md
          items:
            - name: Azure IoT SDKs platform support
              href: iot-hub-device-sdk-platform-support.md
            - name: Use the IoT device SDK for C
              href: iot-hub-device-sdk-c-intro.md
              items:
                - name: Use the IoTHubClient
                  href: iot-hub-device-sdk-c-iothubclient.md
                - name: Use the serializer
                  href: iot-hub-device-sdk-c-serializer.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: Manage connectivity and reliable messaging
              href: iot-hub-reliability-features-in-sdks.md
            - name: Develop for Android Things platform
              href: iot-hub-how-to-android-things.md
        - name: Query Avro data from a hub route
          href: iot-hub-query-avro-data.md
        - name: Order device connection state events from Event Grid
          href: iot-hub-how-to-order-connection-state-events.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 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: Metrics in Azure Monitor
          href: iot-hub-metrics.md
        - name: Set up diagnostic logs
          href: iot-hub-monitor-resource-health.md
        - name: Secure your hub with an X.509 certificate
          href: iot-hub-security-x509-get-started.md
        - name: Upgrade an IoT hub
          href: iot-hub-upgrade.md
        - name: Enable message tracing
          href: iot-hub-distributed-tracing.md
        - name: Configure IP filtering
          href: iot-hub-ip-filtering.md
        - name: Manage public network access
          href: iot-hub-public-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: 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: MXChip IoT DevKit with Arduino
              href: iot-hub-arduino-iot-devkit-az3166-get-started.md
        - name: Use MXChip IoT DevKit
          items:
            - name: Translate voice message with Azure Cognitive Services
              href: iot-hub-arduino-iot-devkit-az3166-translator.md
            - name: Retrieve a Twitter message with Azure Functions
              href: iot-hub-arduino-iot-devkit-az3166-retrieve-twitter-message.md
            - name: Send messages to an MQTT server using Eclipse Paho APIs
              href: iot-hub-arduino-iot-devkit-az3166-mqtt-helloworld.md
            - name: Monitor the magnetic sensor and send email notifications with Azure Functions
              href: iot-hub-arduino-iot-devkit-az3166-door-monitor.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: Manage cloud device messaging with Cloud Explorer for Visual Studio
              href: iot-hub-visual-studio-cloud-device-messaging.md
            - name: Data Visualization in Power BI
              href: iot-hub-live-data-visualization-in-power-bi.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 Cloud Explorer for Visual Studio
              href: iot-hub-device-management-visual-studio.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: Device disconnects
          href: iot-hub-troubleshoot-connectivity.md
        - name: Troubleshoot message routing
          href: troubleshoot-message-routing.md
        - name: Problem resolution
          items:          
            - name: 400027 ConnectionForcefullyClosedOnNewConnection
              href: iot-hub-troubleshoot-error-400027-connectionforcefullyclosedonnewconnection.md
            - name: 401003 IoTHubUnauthorized
              href: iot-hub-troubleshoot-error-401003-iothubunauthorized.md
            - name: 403002 IoTHubQuotaExceeded
              href: iot-hub-troubleshoot-error-403002-iothubquotaexceeded.md
            - name: 403004 DeviceMaximumQueueDepthExceeded
              href: iot-hub-troubleshoot-error-403004-devicemaximumqueuedepthexceeded.md
            - name: 403006 DeviceMaximumActiveFileUploadLimitExceeded
              href: iot-hub-troubleshoot-error-403006-devicemaximumactivefileuploadlimitexceeded.md
            - name: 404001 DeviceNotFound
              href: iot-hub-troubleshoot-error-404001-devicenotfound.md
            - name: 404103 DeviceNotOnline
              href: iot-hub-troubleshoot-error-404103-devicenotonline.md
            - name: 404104 DeviceConnectionClosedRemotely
              href: iot-hub-troubleshoot-error-404104-deviceconnectionclosedremotely.md
            - name: 409001 DeviceAlreadyExists
              href: iot-hub-troubleshoot-error-409001-devicealreadyexists.md
            - name: 409002 LinkCreationConflict
              href: iot-hub-troubleshoot-error-409002-linkcreationconflict.md
            - name: 412002 DeviceMessageLockLost
              href: iot-hub-troubleshoot-error-412002-devicemessagelocklost.md
            - name: 429001 ThrottlingException
              href: iot-hub-troubleshoot-error-429001-throttlingexception.md
            - name: 500xxx Internal errors
              href: iot-hub-troubleshoot-error-500xxx-internal-errors.md
            - name: 503003 PartitionNotFound
              href: iot-hub-troubleshoot-error-503003-partitionnotfound.md
            - name: 504101 GatewayTimeout
              href: iot-hub-troubleshoot-error-504101-gatewaytimeout.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: https://docs.microsoft.com/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: https://docs.microsoft.com/javascript/api/azure-iot-device/
    - name: Node.js (Service)
      href: https://docs.microsoft.com/javascript/api/azure-iothub/
    - name: Node.js (Management)
      href: https://docs.microsoft.com/javascript/api/overview/azure/iothub/management
    - name: Python (Device)
      href: https://docs.microsoft.com/python/api/azure-iot-device
    - name: Python (Service)
      href: https://docs.microsoft.com/python/api/azure-iot-hub
    - name: Python (Management)
      href: https://docs.microsoft.com/python/api/azure-mgmt-iothub
    - name: C device SDK
      href: https://docs.microsoft.com/azure/iot-hub/iot-c-sdk-ref/
    - name: REST (Device)
      href: https://docs.microsoft.com/rest/api/iothub/device
    - name: REST (Service)
      href: https://docs.microsoft.com/rest/api/iothub/service/configuration
    - name: REST (IoT Hub Resource)
      href: https://docs.microsoft.com/rest/api/iothub/iothubresource
    - name: REST (Certificates)
      href: https://docs.microsoft.com/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: Operations monitoring
          href: iot-hub-operations-monitoring.md
        - name: Migrate to diagnostics settings
          href: iot-hub-migrate-to-diagnostics-settings.md
        - name: TLS 1.0 and 1.1 deprecation
          href: iot-hub-tls-deprecating-1-0-and-1-1.md
- name: Resources
  items:
    - name: Support and help options
      href: /azure/iot-fundamentals/iot-support-help
    - name: Azure IoT services
      items:
      - name: IoT Hub
        href: /azure/iot-hub
      - name: IoT Hub Device Provisioning Service
        href: /azure/iot-dps
      - name: IoT Central
        href: https://docs.microsoft.com/microsoft-iot-central/
      - name: IoT Edge
        href: /azure/iot-edge
      - name: IoT solution accelerators
        href: /azure/iot-accelerators
      - name: IoT Plug and Play
        href: /azure/iot-pnp
      - name: Azure Maps
        href: /azure/azure-maps
      - name: Time Series Insights
        href: /azure/time-series-insights
    - name: Azure IoT SDKs
      items:
      - name: IoT Service SDKs
        href: /azure/iot-hub/iot-hub-devguide-sdks#azure-iot-service-sdks
      - name: IoT Device SDKs
        href: /azure/iot-hub/iot-hub-devguide-sdks#azure-iot-device-sdks
    - 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 for IoT device catalog
      href: https://catalog.azureiotsolutions.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