Azure.IoT.DeviceUpdate 1.0.0

Azure IoT Hub 设备更新客户端库用于 .NET

此库提供对 Device Update for IoT Hub 服务的访问，使客户可以将其 IoT 设备的更新发布到云中，然后部署到其设备（批准对 IoT Hub 中管理和配置的设备组的更新）。

源代码 | 包 | 产品文档

开始使用

完整的 Microsoft Azure SDK 可从 Microsoft Azure 下载 页面上下载，其中包含了构建部署包、集成到工具中、丰富的命令行工具等功能。

为了获得最佳的开发体验，开发人员应使用官方的Microsoft NuGet软件包进行库开发。NuGet软件包会定期更新新功能和热补丁。

先决条件

• Microsoft Azure订阅：为了调用Microsoft Azure服务，您需要创建一个Azure订阅
• 设备更新针对IoT Hub实例的更新
• Azure IoT Hub实例

安装软件包

使用NuGet 安装针对.NET的Device Update for IoT Hub客户端库

dotnet add package Azure.IoT.DeviceUpdate

客户端认证

为了与设备更新针对IoT Hub服务交互，您需要创建一个TokenCredential类的实例，并将其传递给DeviceUpdateClient和DeviceManagementClient类的构造函数。

关键概念

设备更新针对IoT Hub是一种托管的云服务，它使您能够为IoT设备部署空中更新。客户端库有三个主要组件

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

您可以访问Device Update for IoT Hub了解更多关于设备更新针对IoT Hub的信息。

示例

您可以通过示例熟悉不同的API。

故障排除

所有设备更新针对IoT Hub服务操作在失败时都会抛出一个带有有用ErrorCodes的RequestFailedException。

例如，如果您使用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 Hub示例开始。

贡献

此项目欢迎贡献和建议。大多数贡献都需要您同意贡献者许可协议（CLA），声明您有权并且实际上确实授予我们使用您的贡献的权利。有关详细信息，请访问贡献者许可协议。

当您提交拉取请求时，CLA机器人将自动确定您是否需要提供CLA以及适当标记PR（例如，标签、注释）。只需遵循机器人提供的说明即可。您只需在实际托管了我们CLA的所有存储库中这样做一次。

此项目遵循Microsoft开放源代码行为准则。有关更多信息，请参阅行为准则常见问题解答或通过[email protected]与任何额外的疑问或评论联系。