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

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

Microsoft Connected Cache Rest Api версии 2023-05-01-preview

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

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

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

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

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

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

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

npm install @azure/arm-connectedcache

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

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

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

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

npm install @azure/identity

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

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

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

import { ConnectedCacheClient } from "@azure/arm-connectedcache";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ConnectedCacheClient } from "@azure/arm-connectedcache";

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

Пакет JavaScript

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

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

ConnectedCacheClient

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

Troubleshooting

Logging

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

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

setLogLevel("info");

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

Contributing

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