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

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

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

Справочник по API служб портала Azure

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

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

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

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

Предпосылки

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

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

npm install @azure/arm-portalservicescopilot

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

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

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

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

npm install @azure/identity

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

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

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

import { PortalServicesClient } from "@azure/arm-portalservicescopilot";
import { DefaultAzureCredential } from "@azure/identity";

const client = new PortalServicesClient(new DefaultAzureCredential());

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { PortalServicesClient } from "@azure/arm-portalservicescopilot";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>"
 });
const client = new PortalServicesClient(credential);

Пакет JavaScript

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

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

PortalServicesClient

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

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

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

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

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

setLogLevel("info");

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

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

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

Вклад

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