Azure DeviceUpdate biblioteca client per JavaScript - versione 1.1.0

Questo pacchetto contiene un SDK isomorfo (che funziona sia in Node.js che nei browser) per Azure client DeviceUpdate.

Device Update for hub IoT è un servizio Azure che consente ai clienti di pubblicare aggiornamenti per i loro dispositivi IoT nel cloud, per poi distribuire quell'aggiornamento sui loro dispositivi (approvare gli aggiornamenti a gruppi di dispositivi gestiti e provisionati in hub IoT). Sfrutta la sicurezza e l'affidabilità comprovate della piattaforma Windows Update, ottimizzata per dispositivi IoT. Opera a livello globale e sa quando e come aggiornare i dispositivi, permettendo ai clienti di concentrarsi sui propri obiettivi aziendali e lasciare che Device Update for hub IoT gestisca gli aggiornamenti.

Collegamenti chiave:

Come iniziare

Ambienti attualmente supportati

Per altri dettagli, vedere i criteri di supporto .

Prerequisites

Installare il pacchetto @azure/iot-device-update

Installa la libreria client Azure DeviceUpdate per JavaScript con npm:

npm install @azure/iot-device-update

Creare ed autenticare un DeviceUpdateClient

Per creare un oggetto client per accedere all'API Azure DeviceUpdate, avrai bisogno della endpoint tua risorsa Azure DeviceUpdate e di un credentialfile . Il client Azure DeviceUpdate può utilizzare le credenziali di Azure Active Directory per autenticarsi. Puoi trovare l'endpoint per la tua risorsa Azure DeviceUpdate nell'portale di Azure.

È possibile eseguire l'autenticazione con Azure Active Directory usando credenziali dalla libreria di di @azure/identità o un token AAD esistente.

Per usare il provider DefaultAzureCredential illustrato di seguito o altri provider di credenziali forniti con Azure SDK, installare il pacchetto :

npm install @azure/identity

Dovrai anche registrare una nuova applicazione AAD e concedere l'accesso ad Azure DeviceUpdate assegnando il ruolo appropriato al tuo principale di servizio (nota: ruoli come "Owner" non concederanno i permessi necessari).

Per altre informazioni su come creare un'applicazione Azure AD, vedere questa guida.

Usando Node.js e ambienti simili a Node, è possibile usare la classe DefaultAzureCredential per autenticare il client.

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

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

Per gli ambienti del browser, usare il InteractiveBrowserCredential dal pacchetto di @azure/identity per l'autenticazione.

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>");

Pacchetto JavaScript

Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per informazioni dettagliate su come eseguire questa operazione, vedere la documentazione di creazione di bundle .

Concetti chiave

DeviceUpdateClient

DeviceUpdateClientè l'interfaccia principale per gli sviluppatori che utilizzano la libreria client Azure DeviceUpdate. Esplora i metodi su questo oggetto client per comprendere le diverse funzionalità del servizio Azure DeviceUpdate a cui puoi accedere.

Troubleshooting

Registrazione

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel nel @azure/logger:

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

setLogLevel("info");

Per istruzioni più dettagliate su come abilitare i log, è possibile esaminare la documentazione del pacchetto @azure/logger.

Contributing

Per contribuire a questa libreria, leggere la guida contribuire per altre informazioni su come compilare e testare il codice.

  • Last updated on