Обновление устройств Azure для клиентской библиотеки Rest Центр Интернета вещей для JavaScript версии 1.0.0

Библиотека предоставляет доступ к службе обновления устройств для Центр Интернета вещей, которая позволяет клиентам публиковать обновления для своих устройств Интернета вещей в облаке, а затем развертывать эти обновления на своих устройствах (утверждать обновления для групп устройств, управляемых и подготовленных в Центр Интернета вещей).

Для использования этой библиотеки в значительной степени полагайтесь на документацию службы и наши клиентские документы REST .

Основные ссылки:

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

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

  • Node.js версии 14.x.x или более поздней

Предварительные требования

  • Подписка Microsoft Azure. Чтобы вызвать службы Microsoft Azure, необходимо создать подписку Azure.
  • Обновление устройства для экземпляра Центр Интернета вещей
  • экземпляр Центр Интернета вещей Azure

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

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

npm install @azure-rest/iot-device-update

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

Чтобы использовать учетные данные маркера Azure Active Directory (AAD), укажите экземпляр нужного типа учетных данных, полученных из библиотеки @azure и удостоверений .

Для проверки подлинности с помощью AAD необходимо сначала npm установить @azure/identity.

После установки можно выбрать тип учетных данных для @azure/identity использования. Например, для проверки подлинности клиента можно использовать DefaultAzureCredential :

Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения AAD в качестве переменных среды: AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_CLIENT_SECRET

Используйте возвращенные учетные данные маркера для проверки подлинности клиента:

import DeviceUpdate from "@azure-rest/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";
const client = DeviceUpdate(
  "https://<my-instance-id>.api.adu.microsoft.com",
  new DefaultAzureCredential()
);

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

Клиент REST

Этот клиент является одним из наших клиентов REST. Мы настоятельно рекомендуем ознакомиться с тем, как использовать клиент REST , здесь.

Примеры

В следующем разделе показано, как инициализировать и проверить подлинность клиента, а затем получить все устройства.

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

async function main() {
  console.log("== List devices ==");
  const client = DeviceUpdate(endpoint, new DefaultAzureCredential());

  const result = await client
    .path("/deviceupdate/{instanceId}/management/devices", instanceId)
    .get();

  console.log(result);
}

main().catch(console.error);

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

Ведение журнала

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

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

setLogLevel("info");

Более подробные инструкции по включению журналов см. в документации по пакету @azure и средства ведения журнала.

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

Участие

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

Просмотры

  • Last updated on