Partilhar via

Biblioteca de cliente do Azure Policy 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 Política do Azure.

Para gerenciar e controlar o acesso aos seus recursos, você pode definir políticas personalizadas e atribuí-las em um escopo.

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

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-policy

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

npm install @azure/arm-policy

Criar e autenticar um PolicyClient

Para criar um objeto de cliente para acessar a API de Política do Azure, você precisará do endpoint do recurso de Política do Azure e de um credential. O cliente de Política do Azure pode usar as credenciais do Azure Ative Directory para autenticar. Você pode encontrar o ponto de extremidade para seu recurso de Política do Azure 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 de 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 ao de Política 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 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 { PolicyClient } from "@azure/arm-policy";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { PolicyClient } from "@azure/arm-policy";

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

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

PolicyClient

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

Solução de problemas

Registo

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.

Próximos passos

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

Contribuir

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