Libreria client di Azure IotCentral per JavaScript - versione 6.0.0
Questo pacchetto contiene un SDK isomorfo (eseguito sia in Node.js che nei browser) per il client Azure IotCentral.
Usare questa API per gestire le applicazioni IoT Central nella sottoscrizione di Azure.
Codice | sorgente Pacchetto (NPM) | Documentazione di | riferimento sulle API Campioni
Introduzione
Ambienti attualmente supportati
- Versioni LTS di Node.js
- Versioni più recenti di Safari, Chrome, Edge e Firefox.
Prerequisiti
Installare il pacchetto @azure/arm-iotcentral
Installare la libreria client di Azure IotCentral per JavaScript con npm
:
npm install @azure/arm-iotcentral
Creare e autenticare un oggetto IotCentralClient
Per creare un oggetto client per accedere all'API Azure IotCentral, sarà necessario disporre della endpoint
risorsa Azure IotCentral e di un credential
oggetto . Il client Azure IotCentral può usare le credenziali di Azure Active Directory per l'autenticazione.
È possibile trovare l'endpoint per la risorsa Azure IotCentral nel portale di Azure.
È possibile eseguire l'autenticazione con Azure Active Directory usando una credenziale dalla libreria di @azure/identità o da un token AAD esistente.
Per usare il provider DefaultAzureCredential illustrato di seguito o altri provider di credenziali forniti con Azure SDK, installare il @azure/identity
pacchetto:
npm install @azure/identity
Sarà anche necessario registrare una nuova applicazione AAD e concedere l'accesso ad Azure IotCentral assegnando il ruolo appropriato all'entità servizio (nota: i ruoli come "Owner"
non concederanno le autorizzazioni necessarie).
Impostare i valori dell'ID client, dell'ID tenant e del segreto client dell'applicazione AAD come variabili di ambiente: AZURE_CLIENT_ID
, AZURE_TENANT_ID
AZURE_CLIENT_SECRET
.
Per altre informazioni su come creare un'applicazione Azure AD, vedere questa guida.
const { IotCentralClient } = require("@azure/arm-iotcentral");
const { DefaultAzureCredential } = require("@azure/identity");
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new IotCentralClient(new DefaultAzureCredential(), subscriptionId);
JavaScript Bundle
Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per informazioni dettagliate su come eseguire questa operazione, vedere la documentazione di raggruppamento.
Concetti chiave
IotCentralClient
IotCentralClient
è l'interfaccia primaria per gli sviluppatori che usano la libreria client IotCentral di Azure. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio Azure IotCentral a cui è possibile accedere.
Risoluzione dei problemi
Registrazione
L'abilitazione della registrazione consente di 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
in @azure/logger
:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
Per istruzioni più dettagliate su come abilitare i log, è possibile esaminare la documentazione del pacchetto @azure/logger.
Passaggi successivi
Per esempi dettagliati su come usare questa libreria, vedere la directory degli esempi .
Contributo
Per contribuire a questa libreria, leggere la guida ai contributi per altre informazioni su come compilare e testare il codice.
Progetti correlati
Azure SDK for JavaScript