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


Клиентская библиотека AzureTerraformResourceProvider для JavaScript

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

API управления Azure Terraform предоставляет набор веб-служб RESTful, используемых для управления ресурсами Azure Terraform.

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

  • пакета (NPM)
  • Справочная документация по API

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

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

Дополнительные сведения см. в политике поддержки .

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

Установка пакета @azure/arm-terraform

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

npm install @azure/arm-terraform

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

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

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

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

npm install @azure/identity

Кроме того, необходимо зарегистрировать новое приложение AAD и предоставить доступ к AzureTerraformResourceProvider, назначив подходящую роль субъекту-службе (примечание. Роли, такие как "Owner", не будут предоставлять необходимые разрешения). Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения AAD в качестве переменных среды: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

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

const { AzureTerraformClient } = require("@azure/arm-terraform");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

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

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new AzureTerraformClient(credential, subscriptionId);

Пакет JavaScript

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

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

AzureTerraformClient

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

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

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

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

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

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

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

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