通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 JavaScript 的 IoT 中心 Rest 客户端库的 Azure 设备更新 - 版本 1.0.0

  • 项目

该库提供对 device Update for IoT 中心 服务的访问权限，使客户能够将 IoT 设备的更新发布到云，然后将这些更新部署到其设备， (批准对在 IoT 中心) 中管理和预配的设备组的更新。

请严重依赖 服务的文档 和 REST 客户端文档 来使用此库

关键链接：

入门

目前支持的环境

  • Node.js版本 14.x.x 或更高版本

先决条件

  • Microsoft Azure 订阅：若要调用 Microsoft Azure 服务，需要创建 Azure 订阅
  • IoT 中心 实例的设备更新
  • Azure IoT 中心 实例

安装 @azure-rest/iot-device-update 包

使用 安装适用于 JavaScript 的 npmAzure Iot 设备更新客户端库：

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

创建 DeviceUpdate 并对其进行身份验证

若要使用 Azure Active Directory (AAD) 令牌凭据，请提供从 @azure/标识 库获取的所需凭据类型的实例。

若要使用 AAD 进行身份验证，必须先 npm 安装 @azure/identity。

安装后，可以选择要使用的@azure/identity凭据类型。 例如， 可以使用 DefaultAzureCredential 对客户端进行身份验证：

将 AAD 应用程序的客户端 ID、租户 ID 和客户端密码的值设置为环境变量：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。 或者，可以在运行时通过调用 @azure/logger 中的 setLogLevel 来启用日志记录：

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

setLogLevel("info");

有关如何启用日志的更详细说明，请查看 @azure/logger 包文档。

后续步骤

贡献

若要为此库做出贡献，请阅读贡献指南，详细了解如何生成和测试代码。

曝光数