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

适用于 .NET 的 Azure IoT 模型存储库客户端库 - 版本 1.0.0-preview.5

项目
04/24/2023

此库提供与 Azure IoT 模型存储库交互的功能。它还旨在提供遵循 Azure IoT 约定使用数字孪生模型存储库的一致体验。

源代码 | 包 (nuget)

入门

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

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

安装包

使用 NuGet 安装适用于 .NET 的 Azure IoT 模型存储库客户端库：

Install-Package Azure.IoT.ModelsRepository

在 nuget.org 查看包详细信息。

先决条件

遵循 Azure IoT 约定的模型存储库
- 模型存储库可以位于本地文件系统上，也可以托管在 Web 服务器上。
- Azure IoT 托管全局 Azure IoT 模型存储库，如果未提供 URI，则客户端将默认指向该存储库。

验证客户端

客户端目前不支持身份验证机制。全局终结点不绑定到 Azure 订阅，并且不支持身份验证。发布的所有模型都供匿名公共使用。

关键概念

Azure IoT 模型存储库使构建者能够管理和共享数字孪生模型。这些模型是使用数字孪生定义语言 (DTDL) 定义的 JSON-LD 文档。

存储库定义一种模式，以基于数字孪生模型标识符 (DTMI) 将 DTDL 接口存储在目录结构中。通过将 DTMI 转换为相对路径，可以在存储库中找到接口。例如，DTMI“”dtmi:com:example:Thermostat;1转换为 /dtmi/com/example/thermostat-1.json。

线程安全

我们保证所有客户端实例方法都是线程安全的且彼此独立。请参阅线程安全指南。这可确保重用客户端实例的建议始终是安全的，即使在线程之间也是如此。

其他概念

示例

可以使用 IoT 模型存储库的示例来熟悉客户端。

疑难解答

所有服务操作都会在失败时引发 RequestFailedException，其中包含有用的错误代码和其他信息。客户端还会生成可以使用 EventListener 侦听的诊断事件和日志记录。

后续步骤

请参阅代码示例的实现示例。

贡献

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

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

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

通过