Condividi tramite

Libreria client di Azure MongoClusterManagement per JavaScript - versione 1.0.1

  • Articolo

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

L'API di gestione di Microsoft Azure offre funzionalità di creazione, lettura, aggiornamento ed eliminazione per le risorse vCore di Azure Cosmos DB per MongoDB, inclusi cluster e regole del firewall.

documentazione di riferimento dell'APIdel codice sorgentepackage (NPM)

Introduttiva

Ambienti attualmente supportati

Per altri dettagli, vedere i criteri di supporto .

Prerequisiti

  • Una sottoscrizione di Azure .

Installare il pacchetto @azure/arm-mongocluster

Installare la libreria client azure MongoClusterManagement per JavaScript con npm:

npm install @azure/arm-mongocluster

Creare ed autenticare un MongoClusterManagementClient

Per creare un oggetto client per accedere all'API MongoClusterManagement di Azure, è necessario il endpoint della risorsa Azure MongoClusterManagement e un credential. Il client Azure MongoClusterManagement può usare le credenziali di Azure Active Directory per l'autenticazione. È possibile trovare l'endpoint per la risorsa MongoClusterManagement di Azure nel 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

Sarà anche necessario registrare una nuova applicazione AAD e concedere l'accesso ad Azure MongoClusterManagement assegnando il ruolo appropriato all'entità servizio(nota: i ruoli come "Owner" 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 { MongoClusterManagementClient } = require("@azure/arm-mongocluster");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new MongoClusterManagementClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new MongoClusterManagementClient(credential, 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

MongoClusterManagementClient

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

Risoluzione dei problemi

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:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

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

Contribuire

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