Compartilhar via

Atualização de dispositivo do Azure para Hub IoT biblioteca de Clientes Rest para JavaScript – versão 1.0.0

  • Artigo

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

Confie muito na documentação do serviço e nos documentos do cliente REST para usar essa biblioteca

Links principais:

Introdução

Ambientes com suporte no momento

  • Node.js versão 14.x.x ou superior

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 @azure-rest/iot-device-update

Instale a biblioteca de clientes do Azure Iot Device Update para JavaScript com npm:

npm install @azure-rest/iot-device-update

Criar e autenticar um DeviceUpdate

Para usar uma credencial de token do AAD (Azure Active Directory), forneça uma instância do tipo de credencial desejado obtido da biblioteca de @azure/identidade .

Para autenticar com o AAD, primeiro npm você deve instalar @azure/identityo .

Após a instalação, você pode escolher de qual tipo de credencial@azure/identity usar. Por exemplo, DefaultAzureCredential pode ser usado para autenticar o cliente:

Defina os valores da ID do cliente, da ID do locatário e do segredo do cliente do aplicativo AAD como variáveis de ambiente: AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_CLIENT_SECRET

Use a credencial de token retornada para autenticar o cliente:

import DeviceUpdate from "@azure-rest/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";
const client = DeviceUpdate(
  "https://<my-instance-id>.api.adu.microsoft.com",
  new DefaultAzureCredential()
);

Principais conceitos

Cliente REST

Esse cliente é um dos nossos clientes REST. É altamente recomendável que você leia como usar um cliente REST aqui.

Exemplos

A seção a seguir mostra como inicializar e autenticar seu cliente e obter todos os dispositivos.

import DeviceUpdate from "@azure-rest/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";

async function main() {
  console.log("== List devices ==");
  const client = DeviceUpdate(endpoint, new DefaultAzureCredential());

  const result = await client
    .path("/deviceupdate/{instanceId}/management/devices", instanceId)
    .get();

  console.log(result);
}

main().catch(console.error);

Solução de problemas

Log

A habilitação do log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o log pode ser habilitado no runtime chamando setLogLevel em @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Para obter instruções mais detalhadas sobre como habilitar logs, veja os documentos do pacote @azure/logger.

Próximas etapas

Contribuição

Se você quiser contribuir com essa biblioteca, leia o guia de contribuição para saber como criar e testar o código.

Impressões