Atualização de Dispositivo do Azure para Hub IoT biblioteca de clientes para .NET – versão 1.0.0

Artigo
04/19/2023

A biblioteca fornece acesso à Atualização de Dispositivo para Hub IoT serviço que permite aos clientes publicar atualizações para seus dispositivos IoT na nuvem e, em seguida, implantar essas atualizações em seus dispositivos (aprovar atualizações para grupos de dispositivos gerenciados e provisionados em Hub IoT).

Código-fonte | Pacote | Documentação do produto

Introdução

O SDK completo do Microsoft Azure pode ser baixado na página Downloads do Microsoft Azure e fornecido com suporte para a criação de pacotes de implantação, integração com ferramentas, ferramentas de linha de comando avançadas e muito mais.

Para obter a melhor experiência de desenvolvimento, os desenvolvedores devem usar os pacotes NuGet oficiais da Microsoft para bibliotecas. Os pacotes NuGet são atualizados regularmente com novas funcionalidades e hotfixes.

Pré-requisitos

Assinatura do Microsoft Azure: para chamar os serviços do Microsoft Azure, você precisa criar uma assinatura do Azure
Atualização de dispositivo para Hub IoT instância
Hub IoT do Azure instância

Instalar o pacote

Instale a Atualização de Dispositivo para Hub IoT biblioteca de clientes para .NET com o NuGet:

dotnet add package Azure.IoT.DeviceUpdate

Autenticar o cliente

Para interagir com a Atualização de Dispositivo para Hub IoT serviço, você precisará criar uma instância de uma classe TokenCredential e passá-la para o construtor da classe DeviceUpdateClient e DeviceManagementClient.

Principais conceitos

A Atualização de Dispositivo para Hub IoT é um serviço gerenciado que permite implantar atualizações over-the-air para seus dispositivos IoT. A biblioteca de clientes tem três componentes main:

DeviceManagementClient: dispositivo, grupo, gerenciamento de implantação (enumerar, criar, recuperar, excluir dispositivo, grupo, implantação etc.)
DeviceUpdateClient: gerenciamento de atualizações (importar, enumerar, excluir etc.)

Saiba mais sobre a Atualização de Dispositivo para Hub IoT visitando Atualização de Dispositivo para Hub IoT.

Exemplos

Você pode se familiarizar com APIs diferentes usando Exemplos.

Solução de problemas

Todas as operações de serviço de Atualização de Dispositivo para Hub IoT lançarão uma RequestFailedException em caso de falha com ErrorCodes úteis.

Por exemplo, se você usar a GetUpdateAsync operação e o modelo que está procurando não existir, poderá capturar esse HttpStatusCode específico para decidir a operação a seguir nesse 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.
}

Próximas etapas

Introdução à atualização de dispositivo para Hub IoT exemplos

Contribuição

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite Contrato de Licença de Colaborador.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Compartilhar via