.NET 用 Azure IoT モデル リポジトリ クライアント ライブラリ - バージョン 1.0.0-preview.5

  • [アーティクル]

このライブラリには、 Azure IoT モデル リポジトリと対話するための機能が用意されています。 また、Azure IoT 規則に従って、デジタル ツイン モデル リポジトリを操作する一貫したエクスペリエンスを提供することも目的としています。

ソースコード | パッケージ (nuget)

はじめに

完全な Microsoft Azure SDK は 、Microsoft Azure のダウンロード ページからダウンロードでき、デプロイ パッケージの構築、ツールとの統合、豊富なコマンドライン ツールなどのサポートが付属しています。

最適な開発エクスペリエンスを実現するために、開発者はライブラリ用の公式の Microsoft NuGet パッケージを使用する必要があります。 NuGet パッケージは、新しい機能とバグ修正によって定期的に更新されます。

パッケージをインストールする

NuGet を使用して .NET 用の Azure IoT モデル リポジトリ クライアント ライブラリをインストールします。

Install-Package Azure.IoT.ModelsRepository

nuget.org でパッケージの詳細を表示します。

前提条件

  • Azure IoT 規則に従ったモデル リポジトリ
    • モデル リポジトリは、ローカル ファイルシステム上に配置することも、Web サーバーでホストすることもできます。
    • Azure IoT は、URI が指定されていない場合にクライアントが既定で指すグローバル Azure IoT モデル リポジトリ をホストします。

クライアントを認証する

現在、クライアントでは認証メカニズムはサポートされていません。 グローバル エンドポイントは Azure サブスクリプションに関連付けられていないので、認証をサポートしていません。公開されているすべてのモデルは、匿名のパブリック消費を目的としています。

主要な概念

Azure IoT モデル リポジトリを使用すると、ビルダーはデジタル ツイン モデルを管理および共有できます。 モデルは、Digital Twins Definition Language (DTDL) を使用して定義された JSON-LD ドキュメントです。

リポジトリは、デジタル ツイン モデル識別子 (DTMI) に基づいて DTDL インターフェイスをディレクトリ構造に格納するパターンを定義します。 DTMI を相対パスに変換することで、リポジトリ内のインターフェイスを見つけることができます。 たとえば、DTMI "dtmi:com:example:Thermostat;1" は に /dtmi/com/example/thermostat-1.json変換されます。

スレッド セーフ

すべてのクライアント インスタンス メソッドがスレッド セーフであり、相互に独立していることを保証します。 スレッド セーフ ガイドラインを参照してください。 これにより、スレッド間であっても、クライアント インスタンスの再利用に関する推奨事項が常に安全になります。

その他の概念

クライアント オプション | 応答 | へのアクセス実行時間の長い操作 | エラーの | 処理診断 | あざける | クライアントの有効期間

例

IoT モデル リポジトリのサンプルを使用して、クライアントについて理解することができます。

トラブルシューティング

すべてのサービス操作では、失敗時に RequestFailedException がスローされ、役に立つエラー コードやその他の情報が表示されます。 また、クライアントは、 EventListener でリッスンできる診断イベントとログも生成します。

次のステップ

コード サンプルを使用した実装例を参照してください。

共同作成

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、https://cla.microsoft.com を参照してください。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。