Biblioteca de clientes de assinatura do Azure para JavaScript – versão 6.0.0

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

O cliente de assinatura

Código-fonte | Pacote (NPM) | Documentação | Amostras

Como começar

Ambientes com suporte no momento

• Versões LTS do Node.js
• Versões mais recentes do Safari, Chrome, Edge e Firefox.

Confira nossa política de suporte para mais detalhes.

Pré-requisitos

• Uma assinatura do Azure.

Instalar o pacote @azure/arm-subscriptions

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

npm install @azure/arm-subscriptions

Criar e autenticar um SubscriptionClient

Para criar um objeto de cliente para acessar a API de Assinatura do Azure, você precisará do endpoint recurso de Assinatura do Azure e de um credentialarquivo . O cliente de Assinatura do Azure pode usar as credenciais do Azure Active Directory para autenticar. Você pode encontrar o ponto de extremidade do recurso de Assinatura do Azure 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 AAD e conceder acesso à Assinatura do Azure atribuindo a função adequada à entidade de serviço (observação: funções como não "Owner" concederão as permissões necessárias).

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

Usando ambientes semelhantes a Node.js e nó, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

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

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

Para ambientes de navegador, use o InteractiveBrowserCredential do pacote @azure/identity para autenticar.

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

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

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 .

Conceitos principais

Cliente de Assinatura

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

Resolução de problemas

Registro em 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:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

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

Próximas etapas

Examine os exemplos de diretório para obter exemplos detalhados sobre como usar essa biblioteca.

Contributing

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

Projetos relacionados

• do SDK do Microsoft Azure para JavaScript