Biblioteca cliente del repositorio de modelos de Azure IoT para .NET: versión 1.0.0-preview.5

Artículo
04/24/2023

Esta biblioteca proporciona funcionalidad para interactuar con el repositorio de modelos de Azure IoT. También tiene como objetivo proporcionar una experiencia coherente trabajando con repositorios de modelos de gemelos digitales siguiendo las convenciones de Azure IoT.

Código | fuente Paquete (nuget)

Introducción

El SDK de Microsoft Azure completo se puede descargar desde la página de descargas de Microsoft Azure y se incluye con compatibilidad para compilar paquetes de implementación, integrar con herramientas, herramientas de línea de comandos enriquecidas, etc.

Para obtener la mejor experiencia de desarrollo, los desarrolladores deben usar los paquetes NuGet oficiales de Microsoft para bibliotecas. Los paquetes NuGet se actualizan periódicamente con nuevas funcionalidades y correcciones de errores.

Instalar el paquete

Instale la biblioteca cliente del repositorio de modelos de Azure IoT para .NET con NuGet:

Install-Package Azure.IoT.ModelsRepository

Vea los detalles del paquete en nuget.org.

Requisitos previos

Un repositorio de modelos después de las convenciones de Azure IoT
- El repositorio de modelos se puede ubicar en el sistema de archivos local o hospedarse en un servidor web.
- Azure IoT hospeda el repositorio global de modelos de Azure IoT al que el cliente apuntará de forma predeterminada si no se proporciona ningún URI.

Autenticar el cliente

Actualmente no se admite ningún mecanismo de autenticación en el cliente. El punto de conexión global no está vinculado a una suscripción de Azure y no admite la autenticación. Todos los modelos publicados están diseñados para el consumo público anónimo.

Conceptos clave

El repositorio de modelos de Azure IoT permite a los generadores administrar y compartir modelos de gemelos digitales. Los modelos son documentos JSON-LD definidos mediante el lenguaje de definición de Digital Twins (DTDL).

El repositorio define un patrón para almacenar interfaces DTDL en una estructura de directorios basada en el identificador de modelo de gemelo digital (DTMI). Puede encontrar una interfaz en el repositorio convirtiendo la DTMI en una ruta de acceso relativa. Por ejemplo, el DTMI "dtmi:com:example:Thermostat;1" se traduce en /dtmi/com/example/thermostat-1.json.

Seguridad para subprocesos

Garantizamos que todos los métodos de instancia de cliente son seguros para subprocesos e independientes entre sí. Consulte la guía de seguridad de subprocesos. Esto garantiza que la recomendación de reutilizar instancias de cliente siempre es segura, incluso entre subprocesos.

Conceptos adicionales

Ejemplos

Puede familiarizarse con el cliente mediante ejemplos para el repositorio de modelos de IoT.

Solución de problemas

Todas las operaciones de servicio producirán RequestFailedException en caso de error, con códigos de error útiles y otra información. El cliente también genera eventos de diagnóstico y registro que se pueden escuchar con un eventListener.

Pasos siguientes

Consulte ejemplos de implementación con nuestros ejemplos de código.

Contribuciones

Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para más información, visite https://cla.microsoft.com.

Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo será necesario que lo haga una vez en todos los repositorios con nuestro CLA.

Este proyecto ha adoptado el Código de conducta de Microsoft Open Source. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.