Biblioteca de cliente do Serviço do Azure para JavaScript – versão 3.0.0-beta.1
Este pacote contém um SDK isomórfico (executado tanto no Node.js como nos browsers) para o cliente do Serviço do Azure.
Referência da API do Mapa de Serviços
Código fonte | Pacote (NPM) | Documentação | de referência da APIExemplos
Introdução
Ambientes atualmente suportados
- Versões LTS do Node.js
- Versões mais recentes do Safari, Chrome, Edge e Firefox.
Pré-requisitos
- Uma subscrição do Azure.
Instalar o pacote @azure/arm-servicemap
Instale a biblioteca de cliente do Serviço do Azure para JavaScript com npm
:
npm install @azure/arm-servicemap
Criar e autenticar um ServiceMap
Para criar um objeto de cliente para aceder à API do Serviço do Azure, precisará do recurso do Serviço do endpoint
Azure e de um credential
. O cliente do Serviço do Azure pode utilizar credenciais do Azure Active Directory para autenticar.
Pode encontrar o ponto final do recurso do Serviço do Azure no Portal do Azure.
Pode autenticar com o Azure Active Directory com uma credencial da biblioteca de @azure/identidade ou de um Token do AAD existente.
Para utilizar o fornecedor DefaultAzureCredential mostrado abaixo ou outros fornecedores de credenciais fornecidos com o SDK do Azure, instale o @azure/identity
pacote:
npm install @azure/identity
Também terá de registar uma nova aplicação do AAD e conceder acesso ao Serviço do Azure ao atribuir a função adequada ao principal de serviço (nota: funções como "Owner"
não concederão as permissões necessárias).
Defina os valores do ID de cliente, do ID do inquilino e do segredo do cliente da aplicação do AAD como variáveis de ambiente: AZURE_CLIENT_ID
, , AZURE_TENANT_ID
AZURE_CLIENT_SECRET
.
Para obter mais informações sobre como criar uma Aplicação Azure AD veja este guia.
const { ServiceMap } = require("@azure/arm-servicemap");
const { DefaultAzureCredential } = require("@azure/identity");
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ServiceMap(new DefaultAzureCredential(), subscriptionId);
Pacote JavaScript
Para utilizar esta biblioteca de cliente no browser, primeiro tem de utilizar um bundler. Para obter detalhes sobre como fazê-lo, veja a nossa documentação de agrupamento.
Conceitos-chave
ServiceMap
ServiceMap
é a interface principal para programadores que utilizam a biblioteca de cliente do Serviço do Azure. Explore os métodos neste objeto de cliente para compreender as diferentes funcionalidades do serviço do Serviço do Azure a que pode aceder.
Resolução de problemas
Registo
Ativar o registo pode ajudar a descobrir informações úteis sobre falhas. Para ver um registo de pedidos e respostas HTTP, defina a variável de AZURE_LOG_LEVEL
ambiente como info
. Em alternativa, o registo pode ser ativado no runtime ao chamar setLogLevel
no @azure/logger
:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
Para obter instruções mais detalhadas sobre como ativar os registos, pode ver os documentos do pacote @azure/logger.
Passos seguintes
Veja o diretório de exemplos para obter exemplos detalhados sobre como utilizar esta biblioteca.
Contribuir
Se quiser contribuir para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.
Projetos relacionados
Azure SDK for JavaScript