Azure Subscription client library per JavaScript - versione 3.0.0

Questo pacchetto contiene un SDK isomorfico (viene eseguito sia in Node.js che nei browser) per il client di sottoscrizione di Azure.

Collegamenti chiave:

Come iniziare

Ambienti attualmente supportati

Per altri dettagli, vedere i criteri di supporto .

Prerequisiti

Installare il pacchetto @azure/arm-resources-subscriptions

Installare la libreria client della sottoscrizione di Azure per JavaScript con npm:

npm install @azure/arm-resources-subscriptions

Creare ed autenticare un SubscriptionClient

Per creare un oggetto client per accedere all'API della sottoscrizione di Azure, è necessario disporre endpoint della risorsa della sottoscrizione di Azure e di un credentialfile . Il client della sottoscrizione di Azure può usare le credenziali di Azure Active Directory per l'autenticazione. È possibile trovare l'endpoint per la risorsa Sottoscrizione di Azure nel portale di Azure.

Puoi autenticarti con Azure Active Directory usando una credenziale della libreria @azure/identity oppure un token AAD esistente.

Per utilizzare il provider DefaultAzureCredential mostrato qui sotto, o altri fornitori di credenziali forniti con il Azure SDK, si prega di installare il pacchetto @azure/identity:

npm install @azure/identity

Sarà anche necessario registrare una nuova applicazione AAD e concedere l'accesso alla sottoscrizione di Azure assegnando il ruolo appropriato all'entità servizio (nota: ruoli come quelli che "Owner" non concederanno le autorizzazioni necessarie).

Per maggiori informazioni su come creare una Azure applicazione AD, consulta questa guida.

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

import { SubscriptionClient } from "@azure/arm-resources-subscriptions";
import { DefaultAzureCredential } from "@azure/identity";

const client = new SubscriptionClient(new DefaultAzureCredential());

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { SubscriptionClient } from "@azure/arm-resources-subscriptions";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new SubscriptionClient(credential);

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

SubscriptionClient

SubscriptionClient è l'interfaccia principale per gli sviluppatori che usano la libreria client della sottoscrizione di Azure. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio di sottoscrizione di Azure a cui è possibile accedere.

Risoluzione dei problemi

Logging

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.

Passaggi successivi

Per esempi dettagliati su come usare questa libreria, vedere gli esempi di directory.

Contributing

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

  • Last updated on