1---2name: azure-digital-twins3description: Expert knowledge for Azure Digital Twins development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when modeling with DTDL, querying twin graphs, integrating IoT Hub/Functions, or migrating control plane APIs, and other Azure Digital Twins related development tasks. Not for Azure IoT Hub (use azure-iot-hub), Azure IoT Central (use azure-iot-central), Azure IoT Edge (use azure-iot-edge), Azure IoT Operations (use azure-iot-operations).4---5# Azure Digital Twins Skill67This skill provides expert guidance for Azure Digital Twins. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.89## How to Use This Skill1011> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file1213This skill requires **network access** to fetch documentation content:14- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch`. Returns Markdown.15- **Fallback**: Use `WebFetch`. Returns Markdown.1617## Category Index1819| Category | Lines | Description |20|----------|-------|-------------|21| Troubleshooting | L33-L42 | Diagnosing and fixing common Azure Digital Twins issues: 403/404 errors, Explorer auth problems, CLI parse failures, known bugs, and performance troubleshooting. |22| Best Practices | L43-L49 | Guidance on modeling best practices: converting RDF/OWL ontologies to DTDL, extending DTDL for Azure Digital Twins, and designing effective tagging patterns for twin graphs. |23| Decision Making | L50-L55 | Guidance on selecting DTDL-based industry ontologies for your twin models and instructions for migrating from Azure Digital Twins preview control plane APIs to current APIs. |24| Architecture & Design Patterns | L56-L61 | Patterns for routing data into/out of Azure Digital Twins, plus strategies for high availability, redundancy, and disaster recovery planning and configuration. |25| Limits & Quotas | L62-L67 | Details on Azure Digital Twins query unit usage, plus service limits, throttling behavior, and how to view/request changes to adjustable quotas. |26| Security | L68-L76 | Security guidance for Azure Digital Twins: auth with Entra app registrations, client authentication, Private Link setup, and handling customer personal data and best practices. |27| Configuration | L77-L101 | Configuring and operating Azure Digital Twins: instance setup, security, endpoints/routes, data history, monitoring, graph/twin/model management, Explorer/3D tools, and query language usage. |28| Integrations & Coding Patterns | L102-L118 | APIs, SDKs, CLI, and query usage; integrating IoT Hub, Azure Data Explorer, Functions, Power Platform; coding .NET clients and validating DTDL models for Azure Digital Twins. |29| Deployment | L119-L122 | Guidance for moving an Azure Digital Twins instance to a different region, including prerequisites, supported scenarios, and step-by-step migration procedures. |3031### Troubleshooting32| Topic | URL |33|-------|-----|34| Fix Azure Digital Twins 403 Forbidden errors | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-403-digital-twins |35| Fix Azure Digital Twins 404 sub-domain not found errors | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-404-digital-twins |36| Resolve Azure Digital Twins Explorer authentication errors | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-azure-digital-twins-explorer-authentication |37| Resolve Azure Digital Twins CLI parse failed errors | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-cli-parse |38| Resolve known issues in Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-known-issues |39| Troubleshoot Azure Digital Twins performance issues | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-performance |4041### Best Practices42| Topic | URL |43|-------|-----|44| Convert RDF/OWL ontologies to DTDL models | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-convert |45| Extend DTDL ontologies for Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-extend |46| Implement tagging patterns for Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-tags |4748### Decision Making49| Topic | URL |50|-------|-----|51| Choose DTDL-based industry ontologies for Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-adopt |52| Migrate from Azure Digital Twins preview control plane APIs | https://learn.microsoft.com/en-us/azure/digital-twins/resources-migrate-from-preview-apis |5354### Architecture & Design Patterns55| Topic | URL |56|-------|-----|57| Design data ingress and egress for Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-ingress-egress |58| Plan high availability and disaster recovery for Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-high-availability-disaster-recovery |5960### Limits & Quotas61| Topic | URL |62|-------|-----|63| Understand Query Unit consumption in Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-query-units |64| Azure Digital Twins service limits and adjustable quotas | https://learn.microsoft.com/en-us/azure/digital-twins/reference-service-limits |6566### Security67| Topic | URL |68|-------|-----|69| Apply security best practices to Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-security |70| Implement client authentication for Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-authenticate-client |71| Create Entra app registration for Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-app-registration |72| Enable Private Link for Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-enable-private-link |73| Handle customer personal data in Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/resources-customer-data-requests |7475### Configuration76| Topic | URL |77|-------|-----|78| Interpret Azure Digital Twins event notifications | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-event-notifications |79| Configure endpoints and event routes in Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-route-events |80| Set up Azure Digital Twins data history connection | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-data-history-connection |81| Configure Azure Digital Twins event endpoints | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-endpoints |82| Configure event routes and filters in Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-routes |83| Manage Azure Digital Twins graphs and relationships | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-graph |84| Manage DTDL models in Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-model |85| Manage individual digital twins via APIs/SDKs | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-twin |86| Configure monitoring, metrics, and logs for Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-monitor |87| Provision and secure Digital Twins via CLI | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-set-up-instance-cli |88| Set up an Azure Digital Twins instance in portal | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-set-up-instance-portal |89| Use 3D Scenes Studio features with Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-3d-scenes-studio |90| Operate Azure Digital Twins Explorer features | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-azure-digital-twins-explorer |91| Use FROM clause in Azure Digital Twins query language | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-from |92| Use JOIN clause in Azure Digital Twins graph queries | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-join |93| Use MATCH clause for graph traversal in Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-match |94| Use SELECT clause in Azure Digital Twins query language | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-select |95| Use WHERE clause in Azure Digital Twins queries | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-where |96| Use functions in Azure Digital Twins query language | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-functions |97| Use operators in Azure Digital Twins query language | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-operators |98| Reserved keywords in Azure Digital Twins query language | https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-reserved |99100### Integrations & Coding Patterns101| Topic | URL |102|-------|-----|103| Work with Azure Digital Twins APIs and SDKs | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-apis-sdks |104| Use Azure Digital Twins CLI command set | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli |105| Query Digital Twins via Azure Data Explorer plugin | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-explorer-plugin |106| Configure data history with Azure Data Explorer | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-history |107| Use Azure Digital Twins query language | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-query-language |108| Ingest IoT Hub telemetry into Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-ingest-iot-hub-data |109| Parse and validate DTDL models with .NET | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-parse-models |110| Query Azure Digital Twins graphs with examples | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-query-graph |111| Set up twin-to-twin event propagation with Azure Functions | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-send-twin-to-twin-events |112| Call Azure Digital Twins REST APIs using .http files | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-apis |113| Use Power Platform connector with Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-power-platform-logic-apps-connector |114| Code a .NET client for Azure Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/tutorial-code |115| Use Azure CLI commands with Digital Twins | https://learn.microsoft.com/en-us/azure/digital-twins/tutorial-command-line-cli |116117### Deployment118| Topic | URL |119|-------|-----|120| Move an Azure Digital Twins instance across regions | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-move-regions |
atc-net