Partilhar via

Biblioteca de cliente do Azure MongoClusterManagement para JavaScript - versão 1.0.0-beta.2

  • Artigo

Este pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente Azure MongoClusterManagement.

A API de gerenciamento do Microsoft Azure fornece funcionalidade de criação, leitura, atualização e exclusão para recursos vCore do Azure Cosmos DB para MongoDB, incluindo clusters e regras de firewall.

Pacote | código-fonte (NPM) | documentação de referência da API |

Primeiros passos

Ambientes atualmente suportados

Consulte o nosso de política de suporte para obter mais detalhes.

Pré-requisitos

  • Uma assinatura do Azure.

Instalar o pacote @azure/arm-mongocluster

Instale a biblioteca de cliente do Azure MongoClusterManagement para JavaScript com npm:

npm install @azure/arm-mongocluster

Criar e autenticar um MongoClusterManagementClient

Para criar um objeto de cliente para acessar a API do Azure MongoClusterManagement, você precisará do endpoint do recurso do Azure MongoClusterManagement e de um credential. O cliente Azure MongoClusterManagement pode usar credenciais do Azure Ative Directory para autenticar. Você pode encontrar o ponto de extremidade para seu recurso Azure MongoClusterManagement no Portal do Azure.

Você pode autenticar com o Azure Ative Directory usando uma credencial da biblioteca de @azure/identidade ou umde token AAD existente.

Para usar o provedor de DefaultAzureCredential mostrado abaixo ou outros provedores de credenciais fornecidos com o SDK do Azure, instale o pacote @azure/identity:

npm install @azure/identity

Você também precisará registrar um novo aplicativo AAD e conceder acesso ao Azure MongoClusterManagement atribuindo a função adequada à sua entidade de serviço (observação: funções como "Owner" não concederão as permissões necessárias). Defina os valores do ID do cliente, ID do locatário e segredo do cliente do aplicativo AAD como variáveis de ambiente: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Para obter mais informações sobre como criar um Aplicativo do Azure AD, confira este guia.

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

Pacote JavaScript

Para usar essa biblioteca de cliente no navegador, primeiro você precisa usar um bundler. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agregação de .

Conceitos-chave

MongoClusterManagementClient

MongoClusterManagementClient é a interface principal para desenvolvedores que usam a biblioteca de cliente do Azure MongoClusterManagement. Explore os métodos neste objeto de cliente para entender os diferentes recursos do serviço Azure MongoClusterManagement que você pode acessar.

Solução de problemas

Registo

Habilitar o registro em log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o registro em log pode ser habilitado em tempo de execução chamando setLogLevel no @azure/logger:

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

Para obter instruções mais detalhadas sobre como habilitar logs, você pode consultar os documentos do pacote @azure/logger.

Contribuição

Se você quiser contribuir para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.