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

Клиентская библиотека поставщика ресурсов Azure Visual Studio для JavaScript версии 4.0.0-beta.2

  • Статья

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

Используйте эти API для управления ресурсами Visual Studio Team Services с помощью Resource Manager Azure. Все операции задач соответствуют спецификации протокола HTTP/1.1. Каждая операция возвращает заголовок x-ms-request-id, который может использоваться для получения информации о запросе. Необходимо убедиться, что запросы к этим ресурсам безопасны. Дополнительные сведения см. в разделе /rest/api/index.

Исходный код | Пакет (NPM) | Справочная документация по | API Образцы

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

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

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

Предварительные требования

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

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

npm install @azure/arm-visualstudio

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

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

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

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

npm install @azure/identity

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

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

const { VisualStudioResourceProviderClient } = require("@azure/arm-visualstudio");
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 VisualStudioResourceProviderClient(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 VisualStudioResourceProviderClient(credential, subscriptionId);

Пакет JavaScript

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

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

VisualStudioResourceProviderClient

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

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

Ведение журнала

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

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

Более подробные инструкции по включению журналов см. в документации по пакету @azure и средству ведения журнала.

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

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

Участие

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

Просмотры