Azure DeviceUpdate client library for JavaScript - version 1.1.0

このパッケージには、DeviceUpdateクライアント用の同型SDKが含まれています(Node.js とブラウザの両方で動作Azure。

IoT HubのDevice Update は、顧客が自社のIoTデバイスのアップデートをクラウドに公開し、そのアップデートをデバイスにデプロイできる(IoT Hubで管理・プロビジョニングされたデバイス群へのアップデートを承認)ことを可能にするAzureサービスです。 IoTデバイス向けに最適化された、実証済みのセキュリティと信頼性を備えたWindows Updateプラットフォームを活用しています。 グローバルに機能し、デバイスの更新タイミングや方法を把握し、顧客がビジネス目標に集中できるようにし、Device Update for IoT Hubにアップデートを任せます。

主要なリンク:

作業の開始

現在サポートされている環境

詳細については、サポート ポリシーの を参照してください。

Prerequisites

@azure/iot-device-update パッケージをインストールする

JavaScript用のAzure DeviceUpdateクライアントライブラリをnpmインストールしてください:

npm install @azure/iot-device-update

DeviceUpdateClient を作成して認証する

Azure DeviceUpdate APIにアクセスするクライアントオブジェクトを作成するには、Azure DeviceUpdateリソースのendpointとcredentialが必要です。 Azure DeviceUpdateクライアントはAzure Active Directoryの認証情報を使用できます。 Azure DeviceUpdateリソースのエンドポイントはAzure portalで見つけることができます。

@azure/ID ライブラリの資格情報を使用するか、既存の AAD トークンを して、Azure Active Directory で認証できます。

以下に示す DefaultAzureCredential プロバイダー、または Azure SDK で提供されているその他の資格情報プロバイダーを使用するには、@azure/identity パッケージをインストールしてください。

npm install @azure/identity

また、新しいAADアプリケーションを登録し、サービスプリンシパルに適切な役割を割り当ててDeviceUpdate Azureへのアクセスを許可する必要があります(注:"Owner"などのロールは必要な権限を与えません)。

Azure AD アプリケーションを作成する方法の詳細については、このガイド確認してください。

Node.js とノードに似た環境を使用すると、DefaultAzureCredential クラスを使用してクライアントを認証できます。

import { DeviceUpdateClient } from "@azure/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";

const client = new DeviceUpdateClient("<endpoint>", new DefaultAzureCredential(), "<instanceId>");

ブラウザー環境では、InteractiveBrowserCredential パッケージの @azure/identity を使用して認証します。

import { InteractiveBrowserCredential } from "@azure/identity";
import { DeviceUpdateClient } from "@azure/iot-device-update";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new DeviceUpdateClient("<endpoint>", credential, "<instanceId>");

JavaScript バンドル

ブラウザーでこのクライアント ライブラリを使用するには、まず、バンドルを使用する必要があります。 これを行う方法の詳細については、バンドルドキュメントを参照してください。

主な概念

DeviceUpdateClient

DeviceUpdateClientはAzure DeviceUpdateクライアントライブラリを使用する開発者向けの主要なインターフェースです。 このクライアントオブジェクトのメソッドを探索して、アクセス可能なAzure DeviceUpdateサービスのさまざまな機能を理解してください。

Troubleshooting

ログの記録

ログ記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、AZURE_LOG_LEVEL 環境変数を infoに設定します。 または、setLogLevelで @azure/logger を呼び出すことによって、実行時にログを有効にすることもできます。

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

ログを有効にする方法の詳細な手順については、 @azure/logger パッケージのドキュメントを参照してください。

Contributing

このライブラリに投稿する場合は、コードをビルドしてテストする方法の詳細については、投稿ガイド を参照してください。

  • Microsoft Azure SDK for JavaScript の
  • Last updated on