Поделиться через

Клиентская библиотека Azure Bicep для JavaScript — версия 1.0.0-beta.1

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

Клиент Bicep

Ключевые ссылки:

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

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

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

Предпосылки

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

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

npm install @azure/arm-resourcesbicep

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

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

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

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

npm install @azure/identity

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

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

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

import { BicepClient } from "@azure/arm-resourcesbicep";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { BicepClient } from "@azure/arm-resourcesbicep";

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

Пакет JavaScript

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

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

BicepClient

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

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

Logging

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

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

setLogLevel("info");

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

Дальнейшие шаги

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

Contributing

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

  • Last updated on