你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
适用于 Java 的 IoT 中心 客户端库的 Azure 设备更新 - 版本 1.0.12
该库提供对 device Update for IoT 中心 服务的访问权限,使客户能够将 IoT 设备的更新发布到云,然后将这些更新部署到其设备, (批准对IoT 中心) 中管理和预配的设备组的更新。
入门
可以从 Microsoft Azure 下载页下载完整的 Microsoft Azure SDK,并附带对生成部署包、与工具集成、丰富的命令行工具等的支持。
为了获得最佳开发体验,开发人员应将官方的 Microsoft NuGet 包用于库。 NuGet 包定期更新新功能和修补程序。
先决条件
- Java 开发工具包 (JDK) 8 或更高版本。
- Azure 订阅
- IoT 中心 实例的设备更新
- Azure IoT 中心 实例
包括包
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-iot-deviceupdate</artifactId>
<version>1.0.12</version>
</dependency>
验证客户端
若要与 device Update for IoT 中心 服务交互,需要创建 TokenCredential 类的实例,并将其传递给类的DeviceUpdateClientBuilder
构造函数。
有关更多身份验证配置,请参阅 Java SDK 入门文档 。
关键概念
适用于 IoT 中心 的设备更新是一项托管服务,可用于为 IoT 设备部署无线更新。 客户端库有两个main组件:
- DeviceUpdate:更新管理 (导入、枚举、删除等 )
- DeviceManagement:设备管理 (枚举设备并检索设备属性,) 、部署管理 (启动和监视一组设备的更新部署)
可以通过访问适用于 IoT 中心 的设备更新详细了解适用于IoT 中心的设备更新。
示例
可以使用 示例熟悉不同的 API。
疑难解答
IoT 中心服务操作的所有设备更新都会在失败时引发 ErrorResponseException,并显示有用的 ErrorCodes。
例如,如果使用 getUpdateWithResponse
操作,而要查找的模型不存在,则可以捕获特定的 HttpStatusCode 来决定在这种情况下执行的操作。
try {
Response<BinaryData> response = client.getUpdateWithResponse("foo", "bar", "0.0.0.1",
null);
} catch (HttpResponseException e) {
if (e.getResponse().getStatusCode() == 404) {
// update does not exist
System.out.println("update does not exist");
}
}
后续步骤
贡献
本项目欢迎贡献和建议。 大多数贡献要求你同意贡献者许可协议 (CLA),并声明你有权(并且确实有权)授予我们使用你的贡献的权利。
提交拉取请求时,CLA 机器人将自动确定你是否需要提供 CLA,并相应地修饰 PR(例如标签、注释)。 直接按机器人提供的说明操作。 只需使用 CLA 对所有存储库执行一次这样的操作。
此项目采用了 Microsoft 开放源代码行为准则。 有关详细信息,请参阅行为准则常见问题解答,或如果有任何其他问题或意见,请与 联系。