通过

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

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

  • 项目

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

源代码 | 包 | 产品文档

入门

可以从 Microsoft Azure 下载页下载完整的 Microsoft Azure SDK，并提供对生成部署包、与工具集成、丰富的命令行工具等的支持。

为了获得最佳开发体验，开发人员应使用库的官方 Microsoft NuGet 包。 NuGet 包会定期更新新功能和修补程序。

先决条件

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

安装包

使用 NuGet 安装适用于 .NET IoT 中心 客户端库的设备更新：

dotnet add package Azure.IoT.DeviceUpdate

对客户端进行身份验证

为了与 device Update for IoT 中心 服务进行交互，需要创建 TokenCredential 类的实例，并将其传递给 DeviceUpdateClient 和 DeviceManagementClient 类的构造函数。

关键概念

device Update for IoT 中心 是一项托管服务，可用于为 IoT 设备部署无线更新。 客户端库有三个main组件：

  • DeviceManagementClient：设备、组、部署管理 (枚举、创建、检索、删除设备、组、部署等)
  • DeviceUpdateClient：更新管理 (导入、枚举、删除等)

可以通过访问适用于IoT 中心的设备更新来详细了解适用于IoT 中心的设备更新。

示例

可以使用 示例熟悉不同的 API。

故障排除

IoT 中心服务操作的所有 Device Update 都将在失败时引发 RequestFailedException，并显示有用的 ErrorCodes。

例如，如果使用 GetUpdateAsync 操作，并且要查找的模型不存在，则可以捕获特定的 HttpStatusCode ，以确定在这种情况下接下来的操作。

try
{
    Response update = await _updatesClient.GetUpdateAsync(
      "provider", "name", "1.0.0.0");
}
catch (RequestFailedException ex) when (ex.Status == (int)HttpStatusCode.NotFound)
{
    // Update does not exist.
}

后续步骤

适用于IoT 中心示例的设备更新入门

贡献

本项目欢迎贡献和建议。 大多数贡献要求你同意贡献者许可协议 (CLA)，并声明你有权（并且确实有权）授予我们使用你的贡献的权利。 有关详细信息，请访问 参与者许可协议。

提交拉取请求时，CLA 机器人将自动确定你是否需要提供 CLA，并相应地修饰 PR（例如标签、注释）。 直接按机器人提供的说明操作。 只需使用 CLA 对所有存储库执行一次这样的操作。

此项目采用了 Microsoft 开放源代码行为准则。 有关详细信息，请参阅行为准则常见问题解答，或如果有任何其他问题或意见，请与 联系。