关于 azure-iot-hub
azure-iot-hub 为使用 Azure IoT Hub、DPS 和 Device Update 的开发者与运维人员提供指导,涵盖本地速查资料及远程文档获取,涉及排障、设计、安全与部署。
主要功能
- 01故障排查指导
- 02最佳实践与设计模式
- 03限制、配额与扩缩
- 04安全与配置建议
- 05集成与部署指导
适用场景
- 01诊断设备连接或预配错误
- 02规划安全的 IoT 设备部署
- 03选择 IoT Hub 层级与消息模式
MCP 相关
该技能可通过 mcp_microsoftdocs 的 microsoft_docs_fetch 工具获取 Microsoft 文档,也可使用网页获取作为备用方式。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-iot-hub安装后在 Claude Code 中输入/azure-iot-hub确认已加载。
详细介绍
Azure IoT Hub 技能
此技能提供有关 Azure IoT Hub 的专业指导,涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式,以及部署。它结合了本地快速参考内容与远程文档获取功能。
如何使用此技能
IMPORTANT for Agent:使用下方的类别索引查找相关章节。对于包含行范围的类别(例如,
L35-L120),使用read_file读取指定行。对于包含文件链接的类别(例如,[security.md](security.md)),使用read_file读取链接的参考文件。
IMPORTANT for Agent:如果
metadata.generated_at早于 3 个月以上,建议用户从存储库拉取最新版本。如果无法使用mcp_microsoftdocs工具,建议用户安装该工具:安装指南
此技能需要网络访问权限才能获取文档内容:
- 首选:使用
mcp_microsoftdocs:microsoft_docs_fetch,并在查询字符串中加入from=learn-agent-skill。返回 Markdown。 - 备用:使用
fetch_webpage,并在查询字符串中加入from=learn-agent-skill&accept=text/markdown。返回 Markdown。
类别索引
| 类别 | 行 | 说明 |
|---|---|---|
| 故障排除 | L37-L53 | 诊断并解决 IoT Hub、DPS 和 Device Update 问题:连接、路由、预配错误、错误代码,以及收集和使用设备与服务诊断日志。 |
| 最佳实践 | L54-L61 | 大规模 DPS 预配、OEM 设备安全、可靠的设备重新连接模式,以及 Azure IoT Hub 中自动设备配置的最佳实践。 |
| 决策制定 | L62-L74 | 选择 IoT Hub 或替代方案、灾难恢复用法、路由选项、C2D/D2C 模式、定价和层级,以及监视设备连接的方法。 |
| 架构与设计模式 | L75-L81 | DPS 生命周期/HA/DR、VNet 连接、安全设备流,以及使用 Cosmos DB 可靠持久化有序 IoT Hub 事件的设计模式。 |
| 限制与配额 | L82-L88 | IoT Hub、Device Provisioning Service 和 Device Update 的限制、配额与节流,包括每项服务的上限、扩展行为,以及超出限制时的处理方式。 |
| 安全 | L89-L127 | 保护 IoT Hub、DPS 和 Device Update:身份验证(Entra、RBAC、SAS、X.509)、证书/密钥、TLS/密码套件、IP/VNet/专用终结点、出站/DLP,以及安全最佳实践/策略。 |
| 配置 | L128-L159 | 配置 IoT Hub 和 DPS 行为:设备/模块孪生、作业、消息传递、路由、扩充、协议、IP/终结点、Device Update 清单、文件上传和监视设置。 |
| 集成与编码模式 | L160-L184 | 设备到云的集成模式:DPS 预配(HTTPS/MQTT、对称密钥/X.509/TPM)、IoT Hub 消息传递、孪生、直接方法、文件上传、模块、批量操作和协议用法。 |
| 部署 | L185-L198 | 部署和更新 IoT 设备与 IoT Hub:Device Update 设置/代理、差分/映像/包更新、故障转移、平台支持、迁移和作业计划。 |
故障排除
最佳实践
| 主题 | URL |
|---|---|
| 在大规模 IoT 部署中应用 DPS 最佳实践 | https://learn.microsoft.com/en-us/azure/iot-dps/concepts-deploy-at-scale |
| 为启用 DPS 的设备实施 OEM 安全实践 | https://learn.microsoft.com/en-us/azure/iot-dps/concepts-device-oem-security-practices |
| 为 Azure IoT Hub 实施弹性设备重新连接 | https://learn.microsoft.com/en-us/azure/iot-hub/concepts-manage-device-reconnections |
| 应用 IoT Hub 自动设备配置最佳实践 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-configuration-best-practices |
决策
| 主题 | URL |
|---|---|
| 确定何时禁用 IoT Hub 灾难恢复 | https://learn.microsoft.com/en-us/azure/iot-hub/how-to-disable-dr |
| 在 Azure IoT Hub 和 Event Hubs 之间进行选择 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-compare-event-hubs |
| 选择 IoT Hub 云到设备通信选项 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-c2d-guidance |
| 选择 IoT Hub 设备到云通信选项 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-d2c-guidance |
| 了解 Azure IoT Hub 定价和计量 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-pricing |
| 在 IoT Hub 路由和 Event Grid 之间进行选择 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-event-grid-routing-comparison |
| 选择合适的 Azure IoT Hub 层级和规模 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-scaling |
| 选择并升级 Azure IoT Hub 层级和大小 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-upgrade |
| 选择 IoT Hub 设备连接监视方法 | https://learn.microsoft.com/en-us/azure/iot-hub/monitor-device-connection-state |
架构与设计模式
| 主题 | URL |
|---|---|
| 规划 DPS 设备生命周期和重新预配策略 | https://learn.microsoft.com/en-us/azure/iot-dps/concepts-device-reprovision |
| 设计 DPS 高可用性和灾难恢复 | https://learn.microsoft.com/en-us/azure/iot-dps/iot-dps-ha-dr |
| 使用 DPS 的虚拟网络连接模式 | https://learn.microsoft.com/en-us/azure/iot-dps/virtual-network-support |
限制与配额
| 主题 | URL |
|---|---|
| Azure IoT DPS 关于限制和行为的常见问题 | https://learn.microsoft.com/en-us/azure/iot-dps/dps-faq |
| 查看 Azure Device Update 服务限制 | https://learn.microsoft.com/en-us/azure/iot-hub-device-update/device-update-limits |
| Azure IoT Hub 配额、限制和节流行为 | https://learn.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-quotas-throttling |
安全
配置
集成与编码模式
部署
评论
支持 Markdown