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


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

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

Клиент, который можно использовать для управления службами поиска ИИ Azure и ключами API.

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

Getting started

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

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

Prerequisites

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

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

npm install @azure/arm-search

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

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

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

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

npm install @azure/identity

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

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

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

import { SearchManagementClient } from "@azure/arm-search";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { SearchManagementClient } from "@azure/arm-search";

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

JavaScript Bundle

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

Key concepts

SearchManagementClient

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

Troubleshooting

Logging

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

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

setLogLevel("info");

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

Next steps

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

Contributing

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