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

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

Обновление устройств для Центр Интернета вещей — это сервис Azure, который позволяет клиентам публиковать обновления для своих IoT-устройств в облаке, а затем развертывать это обновление на своих устройствах (утверждать обновления для групп устройств, управляемых и подготовленных в Центр Интернета вещей). Он использует проверенную безопасность и надёжность платформы клиентский компонент Центра обновления Windows, оптимизированной для устройств IoT. Он работает глобально и знает, когда и как обновлять устройства, позволяя клиентам сосредоточиться на своих бизнес-целях и позволить Device Update for Центр Интернета вещей заниматься обновлениями.

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

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

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

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

Prerequisites

Установите пакет @azure/iot-device-update.

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

npm install @azure/iot-device-update

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

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

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

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

npm install @azure/identity

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

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

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

import { DeviceUpdateClient } from "@azure/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";

const client = new DeviceUpdateClient("<endpoint>", new DefaultAzureCredential(), "<instanceId>");

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { DeviceUpdateClient } from "@azure/iot-device-update";

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

Пакет JavaScript

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

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

DeviceUpdateClient

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

Troubleshooting

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

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

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

setLogLevel("info");

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

Contributing

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

  • Last updated on