Biblioteca de clientes do Azure iotHub para JavaScript – versão 6.3.0
Esse pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente IotHub do Azure.
Use essa API para gerenciar os hubs IoT em sua assinatura do Azure.
Código-fonte | Pacote (NPM) | Documentação | de referência da APIAmostras
Introdução
Ambientes com suporte no momento
- Versões LTS do Node.js
- Versões mais recentes do Safari, Chrome, Edge e Firefox.
Confira nossa política de suporte para mais detalhes.
Pré-requisitos
- Uma assinatura do Azure.
Instalar o pacote @azure/arm-iothub
Instale a biblioteca de clientes do Azure iotHub para JavaScript com npm
:
npm install @azure/arm-iothub
Criar e autenticar um IotHubClient
Para criar um objeto de cliente para acessar a API do Azure iotHub, você precisará do endpoint
do recurso do IotHub do Azure e de um credential
. O cliente do Azure iotHub pode usar credenciais do Azure Active Directory para autenticar.
Você pode encontrar o ponto de extremidade do recurso IotHub do Azure no Portal do Azure.
Você pode autenticar com o Azure Active Directory usando uma credencial da biblioteca de @azure/identidade ou um Token do AAD existente.
Para usar o provedor DefaultAzureCredential mostrado abaixo ou outros provedores de credenciais fornecidos com o SDK do Azure, instale o @azure/identity
pacote:
npm install @azure/identity
Você também precisará registrar um novo aplicativo do AAD e conceder acesso ao Azure iotHub atribuindo a função adequada à entidade de serviço (observação: funções como "Owner"
não concederão as permissões necessárias).
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
.
Para obter mais informações sobre como criar um aplicativo Azure AD marcar este guia.
const { IotHubClient } = require("@azure/arm-iothub");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new IotHubClient(new DefaultAzureCredential(), subscriptionId);
// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
// tenantId: "<YOUR_TENANT_ID>",
// clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new IotHubClient(credential, subscriptionId);
Pacote JavaScript
Para usar essa biblioteca de clientes no navegador, primeiro você precisa usar um empacotador. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agrupamento.
Principais conceitos
IotHubClient
IotHubClient
é a interface principal para desenvolvedores que usam a biblioteca de clientes do Azure iotHub. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço IotHub do Azure que você pode acessar.
Solução de problemas
Registro em 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
:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
Para obter instruções mais detalhadas sobre como habilitar logs, veja os documentos do pacote @azure/logger.
Próximas etapas
Dê uma olhada no diretório de exemplos para obter exemplos detalhados sobre como usar essa biblioteca.
Contribuição
Se você quiser contribuir com essa biblioteca, leia o guia de contribuição para saber como criar e testar o código.
Projetos relacionados
Azure SDK for JavaScript