Клиентская библиотека политики Azure для JavaScript версии 6.0.0

2025-04-08

Этот пакет содержит isomorphic SDK (выполняется как в Node.js, так и в браузерах) для клиента политики Azure.

Для управления доступом к ресурсам и управления ими можно определить настраиваемые политики и назначить их в области.

справочная документация по API исходного кода | (NPM) | | примеры

Начало работы

Поддерживаемые в настоящее время среды

Версии Node.js LTS
Последние версии Safari, Chrome, Edge и Firefox.

Чтобы получить дополнительные сведения, ознакомьтесь с нашей политикой поддержки.

Предпосылки

Подписка Azure

Установите пакет `@azure/arm-policy`.

Установите клиентскую библиотеку политики Azure для JavaScript с npm:

npm install @azure/arm-policy

Создание и проверка подлинности `PolicyClient`

Чтобы создать клиентский объект для доступа к API политики Azure, потребуется endpoint ресурса политики Azure и credential. Клиент политики Azure может использовать учетные данные Azure Active Directory для проверки подлинности. Конечную точку для ресурса политики Azure можно найти на портале Azure.

Вы можете пройти проверку подлинности с помощью Azure Active Directory с помощью учетных данных из библиотеки @azure/удостоверений или существующегомаркера AAD.

Чтобы использовать поставщик defaultAzureCredential, показанный ниже, или другие поставщики учетных данных, предоставленные пакетом Azure SDK, установите пакет :

npm install @azure/identity

Вам также потребуется зарегистрировать новое приложение AAD и предоставить доступ к политики Azure, назначив соответствующую роль субъекту-службе (обратите внимание: роли, такие как "Owner" не будут предоставлять необходимые разрешения).

Дополнительные сведения о создании приложения Azure AD см. в этом руководстве.

Используя среды Node.js и node-like, можно использовать класс DefaultAzureCredential для проверки подлинности клиента.

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);

Для сред браузера используйте InteractiveBrowserCredential из пакета @azure/identity для проверки подлинности.

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);

Пакет JavaScript

Чтобы использовать эту клиентную библиотеку в браузере, сначала необходимо использовать пакет. Дополнительные сведения о том, как это сделать, см. в нашей документации по .

Основные понятия

PolicyClient

PolicyClient — это основной интерфейс для разработчиков с помощью клиентской библиотеки политики Azure. Изучите методы этого клиентского объекта, чтобы понять различные функции службы политики Azure, к которым можно получить доступ.

Устранение неполадок

Лесозаготовка

Включение ведения журнала может помочь выявить полезные сведения о сбоях. Чтобы просмотреть журнал HTTP-запросов и ответов, задайте для переменной среды AZURE_LOG_LEVEL значение info. В альтернативном порядке, логирование можно включить во время выполнения, вызвав setLogLevel в @azure/logger:

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

setLogLevel("info");

Дополнительные инструкции по включению журналов см. в документации по пакету @azure/loger.

Дальнейшие действия

Ознакомьтесь с примерами каталога, чтобы получить подробные примеры использования этой библиотеки.

Вклад

Если вы хотите внести свой вклад в эту библиотеку, ознакомьтесь с руководством по вкладу, чтобы узнать больше о том, как создавать и тестировать код.

пакет SDK Microsoft Azure для JavaScript