Biblioteca de clientes do Repositório de Modelos IoT do Azure para .NET – versão 1.0.0-preview.5

Essa biblioteca fornece funcionalidade para interagir com o Repositório de Modelos de IoT do Azure. Ele também tem como objetivo fornecer uma experiência consistente trabalhando com repositórios de modelo de gêmeo digital seguindo as convenções de IoT do Azure.

Código-fonte | Pacote (nuget)

Introdução

O SDK completo do Microsoft Azure pode ser baixado na página de 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 correções de bugs.

Instalar o pacote

Instale a biblioteca de clientes do Repositório de Modelos IoT do Azure para .NET com o NuGet:

Install-Package Azure.IoT.ModelsRepository

Exiba os detalhes do pacote em nuget.org.

Pré-requisitos

• Um repositório de modelos seguindo as convenções de IoT do Azure
  • O repositório de modelos pode estar localizado no sistema de arquivos local ou hospedado em um servidor Web.
  • O Azure IoT hospeda o Repositório global de Modelos de IoT do Azure para o qual o cliente apontará por padrão se nenhum URI for fornecido.

Autenticar o cliente

Atualmente, não há suporte para mecanismos de autenticação no cliente. O ponto de extremidade global não está vinculado a uma assinatura do Azure e não dá suporte à autenticação. Todos os modelos publicados destinam-se ao consumo público anônimo.

Principais conceitos

O Repositório de Modelos IoT do Azure permite que os construtores gerenciem e compartilhem modelos de gêmeo digital. Os modelos são documentos JSON-LD definidos usando a DTDL (Linguagem de Definição de Gêmeos Digitais).

O repositório define um padrão para armazenar interfaces DTDL em uma estrutura de diretório com base no DTMI (Digital Twin Model Identifier). Você pode localizar uma interface no repositório convertendo o DTMI em um caminho relativo. Por exemplo, o DTMI "dtmi:com:example:Thermostat;1" é convertido /dtmi/com/example/thermostat-1.jsonem .

Acesso thread-safe

Garantimos que todos os métodos de instância do cliente sejam thread-safe e independentes uns dos outros. Consulte diretrizes de segurança de thread. Isso garante que a recomendação de reutilize instâncias de cliente seja sempre segura, mesmo entre threads.

Conceitos adicionais

Opções | do cliente Acessando a resposta | Operações de execução prolongada | Tratamento de falhas | Diagnostics | Zombando | Tempo de vida do cliente

Exemplos

Você pode se familiarizar com o cliente usando exemplos para o Repositório de Modelos de IoT.

Solução de problemas

Todas as operações de serviço lançarão RequestFailedException em caso de falha, com códigos de erro úteis e outras informações. O cliente também produz eventos de diagnóstico e registro em log que podem ser ouvidos com um EventListener.

Próximas etapas

Confira exemplos de implementação com nossos exemplos de código.

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, acesse https://cla.microsoft.com

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.