Azure Device Update para IoT Hub biblioteca cliente para .NET: versión 1.0.0

La biblioteca proporciona acceso a Device Update para IoT Hub servicio que permite a los clientes publicar actualizaciones para sus dispositivos IoT en la nube y, a continuación, implementar estas actualizaciones en sus dispositivos (aprobar actualizaciones en grupos de dispositivos administrados y aprovisionados en IoT Hub).

Código | fuente Paquete | Documentación del producto

Introducción

El SDK completo de Microsoft Azure se puede descargar desde la página Descargas de Microsoft Azure y se incluye con compatibilidad con la creación de paquetes de implementación, integración 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 revisiones.

Requisitos previos

• Suscripción de Microsoft Azure: para llamar a los servicios de Microsoft Azure, debe crear una suscripción de Azure.
• Device Update para IoT Hub instancia
• instancia de Azure IoT Hub

Instalar el paquete

Instale Device Update para IoT Hub biblioteca cliente para .NET con NuGet:

dotnet add package Azure.IoT.DeviceUpdate

Autenticación del cliente

Para interactuar con Device Update para IoT Hub servicio, deberá crear una instancia de una clase TokenCredential y pasarla al constructor de la clase DeviceUpdateClient y DeviceManagementClient.

Conceptos clave

Device Update para IoT Hub es un servicio administrado que permite implementar actualizaciones inalámbricas para los dispositivos IoT. La biblioteca cliente tiene tres componentes principales:

• DeviceManagementClient: dispositivo, grupo, administración de implementación (enumerar, crear, recuperar, eliminar dispositivo, grupo, implementación, etc.)
• DeviceUpdateClient: administración de actualizaciones (importación, enumeración, eliminación, etc.)

Para obtener más información sobre Device Update para IoT Hub, visite Device Update para IoT Hub.

Ejemplos

Puede familiarizarse con diferentes API mediante ejemplos.

Solución de problemas

Todas las operaciones del servicio Device Update para IoT Hub producirán una excepción RequestFailedException en caso de error con códigos de error útiles.

Por ejemplo, si usa la GetUpdateAsync operación y el modelo que busca no existe, puede detectar ese HttpStatusCode específico para decidir la operación siguiente en ese caso.

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.
}

Pasos siguientes

Introducción a Device Update para ejemplos de IoT Hub

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 obtener más información, visite Contrato de licencia de colaborador.

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.