azure-iot-hub について
azure-iot-hubは、Azure IoT Hub、DPS、Device Updateを扱う開発者や運用担当者向けのガイダンススキルです。ローカルの参照情報とリモート文書の取得を組み合わせ、トラブルシューティングから設計、セキュリティ、デプロイまで扱います。
主な機能
- 01トラブルシューティングのガイダンス
- 02ベストプラクティスと設計パターン
- 03制限、クォータ、スケーリング
- 04セキュリティと構成の助言
- 05統合とデプロイのガイダンス
活用シーン
- 01デバイス接続やプロビジョニングのエラー診断
- 02安全なIoTデバイス展開の計画
- 03IoT 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ツールを利用できない場合は、インストールするようユーザーに提案してください:インストールガイド
このスキルでは、ドキュメントの内容を取得するためにネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L53 | IoT Hub、DPS、Device Update の問題を診断して解決します。接続、ルーティング、プロビジョニングエラー、エラーコード、デバイスとサービスの診断ログの収集と活用が含まれます。 |
| ベストプラクティス | L54-L61 | 大規模な DPS プロビジョニング、OEM デバイスのセキュリティ、回復性の高いデバイス再接続パターン、Azure IoT Hub でのデバイス構成の自動化に関するベストプラクティスです。 |
| 意思決定 | L62-L74 | IoT Hub と代替サービスの選択、DR の利用、ルーティングオプション、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 |