Partilhar via


Biblioteca de cliente do Azure ResourceManagement para JavaScript - versão 7.0.0

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

Fornece operações para trabalhar com recursos e grupos de recursos.

Código | fontePacote (NPM) | Documentação | Amostras

Getting started

Ambientes atualmente suportados

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

Prerequisites

  • Uma assinatura do Azure.

Instalar o pacote @azure/arm-resources

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

npm install @azure/arm-resources

Criar e autenticar um ResourceManagementClient

Para criar um objeto de cliente para acessar a API do Azure ResourceManagement, você precisará endpoint do recurso do Azure ResourceManagement e de um credentialarquivo . O cliente Azure ResourceManagement pode usar credenciais do Azure Ative Directory para autenticar. Você pode encontrar o ponto de extremidade para seu recurso Azure ResourceManagement 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 DefaultAzureCredential mostrado abaixo ou outros provedores de credenciais fornecidos com o SDK do Azure, instale o @azure/identity pacote:

npm install @azure/identity

Você também precisará registrar um novo aplicativo AAD e conceder acesso ao Azure ResourceManagement 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 obter mais informações sobre como criar um Aplicativo do Azure AD, confira este guia.

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

import { ResourceManagementClient } from "@azure/arm-resources";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ResourceManagementClient(new DefaultAzureCredential(), subscriptionId);

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ResourceManagementClient } from "@azure/arm-resources";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ResourceManagementClient(credential, subscriptionId);

JavaScript Bundle

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.

Key concepts

ResourceManagementClient

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

Troubleshooting

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 AZURE_LOG_LEVEL variável de ambiente como info. Como alternativa, o registro em log pode ser habilitado em tempo de execução chamando setLogLevel o @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.

Next steps

Por favor, dê uma olhada no diretório de exemplos 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.