Клиентская библиотека Azure ImageBuilder для JavaScript — версия 5.0.0

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

Шаблон изображения виртуальной машины

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

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

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

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

Необходимые условия

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

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

npm install @azure/arm-imagebuilder

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

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

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

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

npm install @azure/identity

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

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

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

import { ImageBuilderClient } from "@azure/arm-imagebuilder";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ImageBuilderClient } from "@azure/arm-imagebuilder";

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

Пакет JavaScript

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

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

ImageBuilderClient

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

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

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

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

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

setLogLevel("info");

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

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

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

Способствует

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