Libreria client del servizio di Azure per JavaScript - versione 3.0.0-beta.1
Questo pacchetto contiene un SDK isomorfico (eseguito sia in Node.js che nei browser) per il client del servizio di Azure.
Informazioni di riferimento sulle API di Mapping dei servizi
Codice | sorgente Pacchetto (NPM) | Documentazione | di riferimento sulle APICampioni
Introduzione
Ambienti attualmente supportati
- Versioni LTS di Node.js
- Versioni più recenti di Safari, Chrome, Edge e Firefox.
Prerequisiti
Installare il pacchetto @azure/arm-servicemap
Installare la libreria client del servizio di Azure per JavaScript con npm
:
npm install @azure/arm-servicemap
Creare e autenticare un oggetto ServiceMap
Per creare un oggetto client per accedere all'API del servizio di Azure, è necessario disporre endpoint
della risorsa del servizio di Azure e di un oggetto credential
. Il client del servizio di Azure può usare le credenziali di Azure Active Directory per l'autenticazione.
È possibile trovare l'endpoint per la risorsa del servizio di Azure nel portale di Azure.
È possibile eseguire l'autenticazione con Azure Active Directory usando credenziali dalla libreria @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 al servizio di Azure assegnando il ruolo appropriato all'entità servizio(nota: i ruoli, "Owner"
ad esempio, non concedono 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 { ServiceMap } = require("@azure/arm-servicemap");
const { DefaultAzureCredential } = require("@azure/identity");
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ServiceMap(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 creazione di bundle.
Concetti chiave
ServiceMap
ServiceMap
è l'interfaccia principale per gli sviluppatori che usano la libreria client del servizio di Azure. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio di Azure 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 di @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