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

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

Microsoft. API управления поставщиком ресурсов обнаружения.

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

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

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

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

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

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

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

npm install @azure/arm-discovery

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

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

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

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

npm install @azure/identity

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

Для получения дополнительной информации о том, как создать заявку Azure AD, ознакомьтесь с этим руководством.

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

import { DiscoveryClient } from "@azure/arm-discovery";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { DiscoveryClient } from "@azure/arm-discovery";

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

Пакет JavaScript

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

Ключевые понятия

DiscoveryClient

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

Troubleshooting

Logging

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

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

setLogLevel("info");

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

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

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

Contributing

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