Delen via

Azure Device Update voor IoT Hub Rest-clientbibliotheek voor JavaScript - versie 1.0.0

  • Artikel

De bibliotheek biedt toegang tot de Device Update for IoT Hub-service waarmee klanten updates voor hun IoT-apparaten in de cloud kunnen publiceren en deze updates vervolgens op hun apparaten kunnen implementeren (updates goedkeuren voor groepen apparaten die worden beheerd en ingericht in IoT Hub).

Vertrouw sterk op de documentatie van de service en onze REST-clientdocumenten om deze bibliotheek te gebruiken

Belangrijke koppelingen:

Aan de slag

Momenteel ondersteunde omgevingen

  • Node.js versie 14.x.x of hoger

Vereisten

  • Microsoft Azure-abonnement: als u Microsoft Azure-services wilt aanroepen, moet u een Azure-abonnement maken
  • Apparaatupdate voor IoT Hub-exemplaar
  • Azure IoT Hub-exemplaar

Installeer het pakket @azure-rest/iot-device-update

Installeer de Azure Iot Device Update-clientbibliotheek voor JavaScript met npm:

npm install @azure-rest/iot-device-update

Een maken en verifiëren DeviceUpdate

Als u een AAD-tokenreferentie (Azure Active Directory) wilt gebruiken, geeft u een exemplaar op van het gewenste referentietype dat is verkregen uit de @azure-/identiteitsbibliotheek .

Als u wilt verifiëren met AAD, moet u eerst npm installeren @azure/identity.

Na de installatie kunt u kiezen welk type referentie@azure/identity u wilt gebruiken. Als voorbeeld kan DefaultAzureCredential worden gebruikt om de client te verifiëren:

Stel de waarden van de client-id, tenant-id en clientgeheim van de AAD-toepassing in als omgevingsvariabelen: AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_CLIENT_SECRET

Gebruik de geretourneerde tokenreferentie om de client te verifiëren:

import DeviceUpdate from "@azure-rest/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";
const client = DeviceUpdate(
  "https://<my-instance-id>.api.adu.microsoft.com",
  new DefaultAzureCredential()
);

Belangrijkste concepten

REST-client

Deze klant is een van onze REST-klanten. We raden u ten zeerste aan hier te lezen hoe u een REST-client gebruikt.

Voorbeelden

In de volgende sectie ziet u hoe u uw client initialiseert en verifieert en vervolgens alle apparaten op haalt.

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

async function main() {
  console.log("== List devices ==");
  const client = DeviceUpdate(endpoint, new DefaultAzureCredential());

  const result = await client
    .path("/deviceupdate/{instanceId}/management/devices", instanceId)
    .get();

  console.log(result);
}

main().catch(console.error);

Problemen oplossen

Logboekregistratie

Het inschakelen van logboekregistratie kan helpen bij het ontdekken van nuttige informatie over fouten. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de AZURE_LOG_LEVEL omgevingsvariabele in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door aan te roepen setLogLevel in de @azure/logger:

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

setLogLevel("info");

Voor meer gedetailleerde instructies over het inschakelen van logboeken kunt u de @azure-/loggerpakketdocumenten bekijken.

Volgende stappen

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.

Weergaven