Azure DeviceUpdate client library for JavaScript - verzió 1.1.0

Ez a csomag izomorf SDK-t tartalmaz (Node.js-ban és böngészőben egyaránt) Azure DeviceUpdate klienshez.

Az Device Update for IoT Hub egy Azure szolgáltatás, amely lehetővé teszi az ügyfelek számára, hogy frissítéseket tegyenek közzé IoT eszközeik felhőjében, majd telepítsék azokat az eszközeikre (jóváhagyják a frissítéseket az IoT Hub-ban kezelt és felállított eszközcsoportok számára). A Windows Update platform bizonyított biztonságát és megbízhatóságát használja ki, amely IoT eszközökre optimalizált. Globálisan működik, és tudja, mikor és hogyan kell frissíteni az eszközöket, így az ügyfelek üzleti céljaikra koncentrálhatnak, és hagyják, hogy az IoT Hub Device Update kezelje a frissítéseket.

Főbb hivatkozások:

Kezdő lépések

Jelenleg támogatott környezetek

További részletekért tekintse meg támogatási szabályzatunkat.

Prerequisites

Telepítse a(z) @azure/iot-device-update csomagot

Install the Azure DeviceUpdate client library for JavaScript with npm:

npm install @azure/iot-device-update

DeviceUpdateClient létrehozása és hitelesítése

Az ügyfélobjektum létrehozásához az Azure DeviceUpdate API-hoz való hozzáféréshez szükséged lesz endpoint az Azure DeviceUpdate erőforrásodra és egy credential. Az Azure DeviceUpdate kliens Azure Active Directory hitelesítési adataival hitelesítheti a hitelesítést. Az Azure DeviceUpdate erőforrásod végpontját az Azure Portal-ban találhatod.

Az Azure Active Directoryval hitelesítést végezhet a @azure/identitástárból vagy egy meglévő AAD-jogkivonatból származó hitelesítő adatokkal.

Az alább látható DefaultAzureCredential szolgáltató vagy az Azure SDK által biztosított egyéb hitelesítő adatok szolgáltatójának használatához telepítse a @azure/identity csomagot:

npm install @azure/identity

Emellett regisztrálnod kell egy új AAD alkalmazást, és hozzáférést kell adni az Azure DeviceUpdate-hez azzal, hogy a megfelelő szerepet hozzárendeled a szolgáltatási főnevednek (megjegyzés: az ilyen "Owner" szerepek nem adják meg a szükséges jogosultságokat).

Az Azure AD-alkalmazások létrehozásáról az útmutató .

A Node.js és a csomópontszerű környezetek használatával a DefaultAzureCredential osztály használatával hitelesítheti az ügyfelet.

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

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

Böngészőkörnyezetek esetén a hitelesítéshez használja a InteractiveBrowserCredential csomagból származó @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-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek módjáról további információt a csomagküldő dokumentációbantalál.

főbb fogalmak

DeviceUpdateClient

DeviceUpdateClientaz elsődleges interfész az Azure DeviceUpdate klienskönyvtárat használó fejlesztők számára. Fedezze fel ezen a kliensobjektumon található módszereket, hogy megértse az Azure DeviceUpdate szolgáltatás különböző funkcióit, amelyeket elérhet.

Hibaelhárítás

Fakitermelés

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL következőre info: . Alternatívaként a naplózás futásidőben is engedélyezhető a setLogLevel hívásával a @azure/logger.

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

setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációit.

Contributing

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót, amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

  • Last updated on