Biblioteca cliente Azure Subscription para JavaScript - versão 3.0.0

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

Ligações principais:

Como Começar

Ambientes atualmente suportados

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

Pré-requisitos

  • Uma assinatura do Azure.

Instalar o pacote @azure/arm-resources-subscriptions

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

npm install @azure/arm-resources-subscriptions

Criar e autenticar um SubscriptionClient

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

Pode autenticar-se com Azure Active Directory usando uma credencial da biblioteca @azure/identity ou um Token AAD existente.

Para usar o fornecedor DefaultAzureCredential mostrado abaixo, ou outros fornecedores de credenciais fornecidos com o SDK do Azure, por favor instale o pacote @azure/identity:

npm install @azure/identity

Você também precisará registrar um novo aplicativo do AAD e conceder acesso à Assinatura do Azure 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).

Para mais informações sobre como criar uma Azure Aplicação AD, consulte este guia.

Usando ambientes Node.js e Node-like, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

import { SubscriptionClient } from "@azure/arm-resources-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-resources-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 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

SubscriptionClient

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

Resolução de problemas

Logging

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:

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

setLogLevel("info");

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

Passos seguintes

Por favor, dê uma olhada no exemplos diretório para obter exemplos detalhados sobre como usar esta biblioteca.

Contributing

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

  • Last updated on