Azure IoT device and service SDKs

Esta referência lista os SDKs do Azure que pode usar para construir soluções IoT, incluindo SDKs de dispositivos, serviços e gestão para Hub IoT e Device Provisioning Service (DPS), SDKs de pré-visualização para gestão de certificados e ligações para APIs do plano de controlo e plano de dados do Azure Digital Twins.

SDKs de dispositivo

Os SDKs de dispositivos Microsoft Azure IoT contêm código que facilita a construção de aplicações que se ligam e são geridas por serviços do Hub IoT do Azure. Esses SDKs podem ser executados em um dispositivo de computação geral baseado em MPU, como um PC, tablet, smartphone ou Raspberry Pi. Os SDKs suportam o desenvolvimento em C e em linguagens geridas modernas, incluindo C#, Node.js, Python e Java.

Os SDKs estão disponíveis em vários idiomas , oferecendo a flexibilidade de escolher o que melhor se adapta à sua equipe e cenário.

O SDK Java dispositivo inclui samples para Android.

O SDK do dispositivo C inclui amostras para iOS que usam CocoaPods.

Use os SDKs dos dispositivos para desenvolver código a executar em dispositivos IoT que se liguem ao Hub IoT ou ao IoT Central.

SDKs de dispositivos incorporados

Esses SDKs foram projetados e criados para serem executados em dispositivos com recursos limitados de computação e memória e são implementados usando a linguagem C.

Os SDKs de dispositivos incorporados estão disponíveis para vários sistemas operacionais, oferecendo a flexibilidade de escolher o que melhor se adapta ao seu cenário.

Use os SDKs de dispositivos embutidos para desenvolver código a executar em dispositivos IoT que se ligam ao Hub IoT ou ao IoT Central.

Para saber mais sobre quando usar os SDKs de dispositivo incorporado, consulte Cenários de uso do C SDK e do Embedded C SDK.

Ciclo de vida e suporte do SDK do dispositivo

Esta secção resume o ciclo de vida e a política de suporte do Azure IoT Device SDK. Para mais informações, consulte SDK do Azure Política de ciclo de vida e apoio.

Ciclo de vida do pacote

Os pacotes são lançados nas seguintes categorias. Cada categoria tem uma estrutura de apoio definida.

1. Beta - Também conhecido como Preview ou Release Candidate. Disponível para acesso antecipado e feedback e não é recomendado para uso em produção. O suporte para versões de pré-visualização está limitado a questões do GitHub. As versões de visualização normalmente existem por menos de seis meses, após os quais são descontinuadas ou lançadas como ativas.

2. Ativo - Geralmente disponível e totalmente suportado, recebe novas atualizações de recursos, bem como correções de bugs e segurança. Use a versão mais recente porque essa versão recebe correções e atualizações.

3. Preterido - Substituído por uma versão mais recente. A obsolescência ocorre ao mesmo tempo em que a nova versão se torna ativa. As versões preteridas abordam as correções de bugs e correções de segurança mais críticas por mais 12 meses.

Obtenha suporte

Se tiver problemas ao utilizar os SDKs Azure IoT, procure apoio através das seguintes opções:

• Reportar bugs - Todos os clientes podem reportar bugs na página de problemas do repositório GitHub associado ao SDK relevante.

• Microsoft equipa de Apoio ao Cliente - Utilizadores que tenham um plano suporte podem envolver-se com a equipa de Suporte ao Cliente da Microsoft criando um ticket de suporte diretamente a partir do portal Azure.

SDKs de serviços Hub IoT

Os SDKs do serviço Azure IoT contêm código para facilitar a construção de aplicações que interagem diretamente com o Hub IoT para gerir dispositivos e segurança.

Para saber mais sobre a utilização dos SDKs de serviços para interagir com dispositivos através de um hub IoT, consulte IoT Plug and Play guia para desenvolvedores de serviços.

SDKs de gestão de Hub IoT

Os SDKs de gestão do Hub IoT ajudam-no a construir aplicações backend que gerem os hubs IoT na sua subscrição Azure.

Alternativas aos SDKs de gestão incluem o CLI do Azure, PowerShell e REST.

SDKs de dispositivo DPS

Os SDKs de dispositivo DPS fornecem implementações da API de registo e outras que os dispositivos chamam para provisionar através do DPS. Os SDKs de dispositivo podem ser executados em dispositivos de computação baseados em MPU em geral, como um PC, tablet, smartphone ou Raspberry Pi. Os SDKs suportam o desenvolvimento em C e em linguagens geridas modernas, incluindo C#, Node.js, Python e Java.

A tabela seguinte lista os SDKs de dispositivos disponíveis para cada linguagem suportada.

SDKs de DPS para dispositivos incorporados

Esses SDKs foram projetados e criados para serem executados em dispositivos com recursos limitados de computação e memória e são implementados usando a linguagem C.

Saiba mais sobre os SDKs de dispositivos e dispositivos embutidos em SDKs de IoT.

SDKs para serviços DPS

Os SDKs de serviço DPS ajudam a criar aplicações de back-end para gerir inscrições e registos de matrícula em instâncias DPS.

SDKs de gerenciamento DPS

Os SDKs de gestão DPS ajudam-no a construir aplicações backend que gerem as instâncias DPS e os seus metadados na sua subscrição do Azure.

SDKs de gestão de certificados (pré-visualização)

Para SDKs que suportam a gestão de certificados X.509 apoiada pela Microsoft em pré-visualização, utilize as seguintes instruções e exemplos. Para usar os SDKs de gestão de certificados em pré-visualização, deve usar o Hub IoT do Azure com uma instância DPS ligada, e os dispositivos devem provisionar-se através do DPS.

SDKs de dispositivos de gestão de certificados (pré-visualização)

A tabela seguinte lista os SDKs da plataforma que atualmente suportam a gestão de certificados X.509 apoiada pela Microsoft em pré-visualização.

SDKs de dispositivos embutidos de gestão de certificados (pré-visualização)

A tabela seguinte lista os SDKs embutidos que atualmente suportam a gestão de certificados X.509 apoiada pela Microsoft em pré-visualização.

Azure Digital Twins control plane APIs

As APIs do plano de controlo são APIs ARM usadas para gerir a sua instância Azure Digital Twins como um todo, por isso cobrem operações como criar ou eliminar toda a sua instância. Você também usará essas APIs para criar e eliminar pontos de extremidade.

Para chamar diretamente as APIs, consulte a pasta Swagger mais recente no repositório Swagger control plane. Esta pasta também inclui uma pasta de exemplos que mostram o uso.

Aqui estão os SDKs atualmente disponíveis para as APIs do Azure Digital Twins Control Plane.

Azure Digital Twins data plane APIs

As APIs do plano de dados são as APIs do Azure Digital Twins usadas para gerir os elementos dentro da sua instância do Azure Digital Twins. Eles incluem operações como criar rotas, carregar modelos, criar relacionamentos e gerenciar gêmeos, e podem ser divididos nas seguintes categorias:

• DigitalTwinModels - A categoria DigitalTwinModels contém APIs para gerir o models numa instância Azure Digital Twins. As atividades de gerenciamento incluem upload, validação, recuperação e exclusão de modelos criados na DTDL.
• DigitalTwins - A categoria DigitalTwins contém as APIs que permitem aos programadores criar, modificar e eliminar gémeos digitais e as suas relações numa instância Azure Digital Twins.
• Query - A categoria Consulta permite que os desenvolvedores encontrem conjuntos de gémeos digitais no grafo de gémeos através de relacionamentos.
• Event Routes - A categoria Rotas de Eventos contém APIs para rotear dados, através do sistema e para serviços downstream.
• Import Jobs - A API de Trabalhos de Importação permite gerir uma ação assíncrona de longa duração para importar modelos, gémeos e relacionamentos em grande escala.
• Delete Jobs - A API Delete Jobs permite gerenciar uma ação assíncrona de longa duração para excluir todos os modelos, gêmeos e relacionamentos em uma instância.

Para chamar diretamente as APIs, consulte a pasta Swagger mais recente no repositório Swagger data plane. Esta pasta também inclui uma pasta de exemplos que mostram o uso. Você também pode visualizar a documentação de referência da API do plano de dados.

Aqui estão os SDKs atualmente disponíveis para as APIs do Azure Digital Twins data plane.

Passos seguintes

As próximas etapas sugeridas incluem:

• Guia do desenvolvedor de dispositivos
• Guia do desenvolvedor de serviços