.NET 用 azure Device Update for IoT Hub クライアント ライブラリ - バージョン 1.0.0

  • [アーティクル]

このライブラリは、IoT Hub サービスの Device Update へのアクセスを提供します。これにより、お客様は IoT デバイスの更新プログラムをクラウドに発行し、それらの更新プログラムを自分のデバイスに展開できます (IoT Hubで管理およびプロビジョニングされたデバイスのグループに対する更新を承認します)。

ソースコード | パッケージ | 製品ドキュメント

作業の開始

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

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

前提条件

  • Microsoft Azure サブスクリプション: Microsoft Azure サービスを呼び出すには、Azure サブスクリプションを作成する必要があります
  • IoT Hub インスタンスの Device Update
  • Azure IoT Hub インスタンス

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

NuGet を使用して .NET 用の device Update for IoT Hub クライアント ライブラリをインストールします。

dotnet add package Azure.IoT.DeviceUpdate

クライアントの認証

IoT Hub サービスの Device Update を操作するには、TokenCredential クラスのインスタンスを作成し、それを DeviceUpdateClient クラスと DeviceManagementClient クラスのコンストラクターに渡す必要があります。

主要な概念

device Update for IoT Hub は、IoT デバイスの空中更新プログラムをデプロイできるマネージド サービスです。 クライアント ライブラリには、次の 3 つのメイン コンポーネントがあります。

  • DeviceManagementClient: デバイス、グループ、展開管理 (デバイス、グループ、展開などを列挙、作成、取得、削除)
  • DeviceUpdateClient: 更新管理 (インポート、列挙、削除など)

IoT Hubのデバイス更新プログラムの詳細については、「IoT Hubのデバイス更新プログラム」を参照してください。

例

サンプルを使用して、さまざまな API について理解することができます。

トラブルシューティング

IoT Hub サービス操作のすべての Device Update は、役に立つ ErrorCodes で失敗した場合に RequestFailedException をスローします。

たとえば、操作を GetUpdateAsync 使用していて、探しているモデルが存在しない場合は、その特定の HttpStatusCode をキャッチして、その場合に続く操作を決定できます。

try
{
    Response update = await _updatesClient.GetUpdateAsync(
      "provider", "name", "1.0.0.0");
}
catch (RequestFailedException ex) when (ex.Status == (int)HttpStatusCode.NotFound)
{
    // Update does not exist.
}

次の手順

device Update for IoT Hub サンプルの使用を開始する

共同作成

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

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

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