Extensão Hub IoT do Azure para Visual Studio Code

O Visual Studio Code (VS Code) permite adicionar extensões, como linguagens, depuradores e ferramentas, à instalação do VS Code para dar suporte ao fluxo de trabalho de desenvolvimento. A extensão Hub IoT do Azure para o Visual Studio Code permite adicionar o suporte do Hub IoT do Azure à instalação do VS Code. Isso permite gerenciar e interagir com seus dispositivos, módulos e hubs IoT durante o desenvolvimento. A extensão Hub IoT do Azure está disponível no Marketplace do Visual Studio Code.

Observação

Alguns dos recursos mencionados neste artigo, como mensagens de nuvem para dispositivo, dispositivos gêmeos e gerenciamento de dispositivo estão disponíveis somente na camada Standard do Hub IoT. Para obter mais informações sobre as camadas básica e padrão/gratuita do Hub IoT, confira Escolher a camada certa do Hub IoT para a sua solução.

Instalar a extensão

Você pode localizar e instalar a extensão diretamente no Visual Studio Code ou no Marketplace do Visual Studio Code.

Instalar a partir do Visual Studio Code

Para localizar e instalar a extensão a partir do Visual Studio Code, siga as etapas a seguir.

1. No VS Code, selecione a exibição Extensões clicando no ícone de exibição Extensões na barra de exibição ou selecionando Ctrl+Shift+X.

   

2. Insira Hub IoT do Azure na caixa de pesquisa para filtrar as ofertas do Marketplace. Você deve ver a extensão Hub IoT do Azure na lista. Selecione a extensão na lista para exibir a página de detalhes da extensão.

   

3. Confirme se o identificador exclusivo da extensão selecionada, exibido na seção Mais Informações da página de detalhes da extensão, está definido como vsciot-vscode.azure-iot-toolkit.

   

4. Selecione o botão Instalar para a extensão selecionada, na lista ou na página de detalhes da extensão, para instalar a extensão.

Instalar a partir do Marketplace do Visual Studio Code

Para localizar e instalar a extensão a partir do VS Code Marketplace, siga as etapas a seguir.

1. No navegador, acesse a página da extensão Hub IoT do Azure no VS Code Marketplace.

2. Confirme se o identificador exclusivo da extensão selecionada, exibido na seção Mais Informações da página de detalhes da extensão Hub IoT do Azure, está definido como vsciot-vscode.azure-iot-toolkit.

3. Clique no botão Instalar para iniciar o Visual Studio Code, se ainda não estiver em execução, e exiba a página de detalhes da extensão no VS Code.

4. No VS Code, clique no botão Instalar na página de detalhes da extensão para instalar a extensão.

A instalação da extensão Hub IoT do Azure para o Visual Studio Code também instala a extensão Conta do Azure para o Visual Studio Code, que fornece uma experiência de logon único no Azure e filtragem de assinatura para todas as outras extensões do Azure. A extensão Conta do Azure também disponibiliza o serviço do Azure Cloud Shell no terminal integrado do VS Code.

Observação

A extensão Hub IoT do Azure depende da extensão Conta do Azure para conectividade. Não é possível desinstalar a extensão Conta do Azure sem desinstalar a extensão Hub IoT do Azure.

Entre na sua conta do Azure

Antes que a extensão possa interagir com o Hub IoT do Azure, você deve entrar na sua conta do Azure a partir do Visual Studio Code. Você pode usar a extensão Conta do Azure para:

• Criar uma conta do Azure
• Entrar e sair da sua conta do Azure
• Filtrar as assinaturas do Azure disponíveis para a extensão Hub IoT do Azure a partir da sua conta do Azure
• Carregar um arquivo na sua conta de armazenamento do Azure Cloud Shell

Siga essas etapas para entrar no Azure e selecione seu hub IoT a partir da sua assinatura do Azure:

1. Na modo de exibição Explorer do VS Code, expanda a seção Hub IoT do Azure na barra lateral.

2. Selecione o botão de reticências (...) da seção Hub IoT do Azure para exibir o menu de ações e, em seguida, selecione Selecionar Hub IoT no menu de ações.

3. Se você não estiver conectado ao Azure, uma notificação pop-up será mostrada no canto inferior direito para permitir que você entre no Azure. Selecione Entrar e siga as instruções para entrar no Azure.

4. Selecione sua assinatura do Azure na lista suspensa Selecionar Assinatura.

5. Selecione seu Hub IoT na lista suspensa Selecionar Hub IoT.

6. Os dispositivos do seu Hub IoT são recuperados do Hub IoT e mostrados no nó Dispositivos na seção Hub IoT do Azure da barra lateral.

   Observação

   Você também pode usar uma cadeia de conexão para acessar seu Hub IoT selecionando Definir cadeia de conexão do Hub IoT no menu de ações e inserindo a cadeia de conexão de política iothubowner para o seu Hub IoT na caixa de inserções Cadeia de Conexão do Hub IoT.

Depois de entrar, você pode interagir com seus hubs, dispositivos e módulos na Paleta de Comandos ou no menu de ação na exibição Explorer do VS Code. Para obter mais informações sobre como interagir com a extensão, incluindo perguntas frequentes e exemplos de interação, confira o wiki da extensão Hub IoT do Azure.

Gerenciar seus hubs IoT

Você pode executar as seguintes tarefas de gerenciamento do hub IoT a partir da extensão:

• Criar um hub IoT e selecioná-lo como o hub IoT atual para sua extensão
• Selecionar um hub IoT existente como o hub IoT atual para sua extensão
• Listar pontos de extremidade internos e personalizados existentes para o hub IoT atual selecionando o botão Atualizar para a seção Hub IoT do Azure na exibição Explorer
• Copiar a cadeia de conexão do hub IoT atual para sua área de transferência
• Gerar um token SAS para o hub IoT atual e copiá-lo para sua área de transferência

Gerenciar seus dispositivos

Você pode executar as seguintes tarefas de gerenciamento de dispositivos para o hub IoT atual a partir da extensão:

• Criar um dispositivo no Hub IoT
• Criar um dispositivo no IoT Edge
• Listar dispositivos existentes selecionando o botão Atualizar para o hub IoT atual na exibição Explorer ou especificando o comando Hub IoT do Azure: Listar Dispositivos na Paleta de Comandos
• Obter informações sobre o dispositivo selecionado como um documento JSON, mostrado no painel de Saída do VS Code
• Editar o dispositivo gêmeo para o dispositivo selecionado, como um documento JSON no editor do VS Code
• Copiar a cadeia de conexão do dispositivo selecionado para a área de transferência
• Gerar um token SAS para o dispositivo selecionado e copiá-lo para sua área de transferência
• Invocar um método direto para o dispositivo selecionado e exibir os resultados no painel de Saída do VS Code
• Excluir o dispositivo selecionado do hub IoT atual

Dica

Você pode habilitar um bloqueio em seus recursos de IoT para impedir que sejam excluídos de modo acidental ou mal-intencionado. Para obter mais informações sobre bloqueios de recursos no Azure, consulte Bloquear recursos para proteger a infraestrutura.

Gerenciar seus módulos

Você pode executar as seguintes tarefas de gerenciamento de módulo para o dispositivo selecionado no hub IoT atual:

• Criar um módulo
• Listar módulos existentes selecionando o botão Atualizar para o dispositivo atual na exibição Explorer do VS Code
• Obter informações sobre o módulo selecionado como um documento JSON, mostrado no painel de Saída do VS Code
• Editar o módulo gêmeo para o módulo selecionado, como um documento JSON no editor do VS Code
• Copiar a cadeia de conexão do módulo selecionado para a área de transferência
• Invocar um método direto para o módulo selecionado e exibir os resultados no painel de Saída do VS Code
• Excluir o módulo selecionado do dispositivo atual

Observação

Os módulos do sistema do Azure IoT Edge são somente leitura e não podem ser modificados. As alterações podem ser enviadas implantando uma configuração para o dispositivo IoT Edge relacionado.

Interação com o Hub IoT

Você pode executar as seguintes tarefas interativas para os recursos no hub IoT atual:

• Gerar código em uma linguagem de programação selecionada para executar uma tarefa comum, como enviar uma mensagem do dispositivo para nuvem, para o recurso selecionado
• Enviar uma mensagem do dispositivo para nuvem (D2C) para o Hub IoT para o dispositivo selecionado
• Iniciar e interromper o monitoramento do ponto de extremidade do evento interno para o hub IoT atual e exibir os resultados no painel de Saída do VS Code
• Enviar uma mensagem da nuvem para dispositivo (C2D) para o dispositivo selecionado para o hub IoT atual e exibir os resultados no painel de Saída do VS Code
• Iniciar e interromper o monitoramento de mensagens C2D para o dispositivo selecionado para o hub IoT atual e exibir os resultados no painel de Saída do VS Code
• Atualizar as configurações de rastreamento distribuído para dispositivos
• Iniciar e interromper o monitoramento dos pontos de extremidade de Hubs de Eventos personalizados para o hub IoT atual e exibir os resultados no painel de Saída do VS Code

Interação com o IoT Edge

Você pode executar as seguintes tarefas interativas para dispositivos do Azure IoT Edge no hub IoT atual:

• Criar uma implantação para o dispositivo IoT Edge selecionado e exibir os resultados no painel de Saída do VS Code
• Se você tiver um manifesto de implantação apropriado, crie uma implantação em escala para vários dispositivos IoT Edge e exiba os resultados no painel de Saída do VS Code