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

  • Artigo

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

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

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

Introdução

Ambientes com suporte no momento

Consulte nossa política de suporte para obter mais detalhes.

Pré-requisitos

Instalar o pacote @azure/arm-mongocluster

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

npm install @azure/arm-mongocluster

Criar e autenticar um MongoClusterManagementClient

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

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

Para usar o provedor 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 do AAD e conceder acesso ao Azure MongoClusterManagement atribuindo a função adequada à entidade de serviço (observação: funções como "Owner" não concederão as permissões necessárias). Defina os valores da ID do cliente, da ID do locatário e do 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 clientes no navegador, primeiro você precisa usar um empacotador. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agrupamento .

Principais conceitos

MongoClusterManagementClient

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

Solucionando problemas

Log

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 runtime chamando setLogLevel no @azure/logger:

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

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

Contribuindo

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

  • do SDK do Microsoft Azure para JavaScript