Atualização de dispositivo do Azure para Hub IoT biblioteca de clientes para Java – versão 1.0.12

Artigo
10/21/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 | 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 avançadas de linha de comando e muito mais.

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

Pré-requisitos

Um Java Development Kit (JDK) versão 8 ou posterior.
Assinatura do Azure
Atualização de dispositivo para Hub IoT instância
Hub IoT do Azure instância

Incluir o Pacote

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-iot-deviceupdate</artifactId>
  <version>1.0.12</version>
</dependency>

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 de sua DeviceUpdateClientBuilder classe.

Consulte o documento Introdução ao SDK do Java para obter mais configuração de autenticação.

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 dois componentes main:

DeviceUpdate: gerenciamento de atualizações (importar, enumerar, excluir etc.)
DeviceManagement: gerenciamento de dispositivos (enumerar dispositivos e recuperar propriedades do dispositivo), gerenciamento de implantação (iniciar e monitorar implantações de atualização em um conjunto de dispositivos)

Você pode saber mais sobre a Atualização de Dispositivo para Hub IoT visitando a 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 um ErrorResponseException em caso de falha com ErrorCodes úteis.

Por exemplo, se você usar a getUpdateWithResponse 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<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");
    }
}

Próximas etapas

Introdução à nossa 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.

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.

Impressões

Partilhar via