Criar um Hub IoT usando o portal do AzureCreate an IoT hub using the Azure portal

Este artigo descreve como criar e gerenciar hubs IoT usando o portal do Azure.This article describes how to create and manage IoT hubs using the Azure portal.

Para usar as etapas neste tutorial, você precisa de uma assinatura do Azure.To use the steps in this tutorial, you need an Azure subscription. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Crie um hub IoTCreate an IoT hub

Esta seção descreve como criar um hub IoT usando o portal do Azure.This section describes how to create an IoT hub using the Azure portal.

  1. Entre no portal do Azure.Sign in to the Azure portal.

  2. Na página inicial do Azure, selecione o botão Criar um recurso e, em seguida, insira Hub IoT no campo Pesquisar no Marketplace.From the Azure homepage, select the + Create a resource button, and then enter IoT Hub in the Search the Marketplace field.

  3. Selecione Hub IoT nos resultados da pesquisa e, em seguida, selecione Criar.Select IoT Hub from the search results, and then select Create.

  4. Na guia Básico, preencha os campos da seguinte maneira:On the Basics tab, complete the fields as follows:

    • Assinatura: Selecione a assinatura a ser usada para o hub.Subscription: Select the subscription to use for your hub.

    • Grupo de Recursos: Selecione um grupo de recursos ou crie um novo.Resource Group: Select a resource group or create a new one. Para criar um novo, selecione Criar novo e preencha o nome que deseja usar.To create a new one, select Create new and fill in the name you want to use. Para usar um grupo de recursos existente, selecione esse grupo de recursos.To use an existing resource group, select that resource group. Para obter mais informações, veja Gerenciar grupos de recursos do Azure Resource Manager.For more information, see Manage Azure Resource Manager resource groups.

    • Região: Selecione a região na qual você deseja que o hub esteja localizado.Region: Select the region in which you want your hub to be located. Selecione a localização mais próxima de você.Select the location closest to you. Alguns recursos, como os Fluxos de dispositivo do Hub IoT, estão disponíveis apenas em regiões específicas.Some features, such as IoT Hub device streams, are only available in specific regions. Para esses recursos limitados, você deve selecionar uma das regiões com suporte.For these limited features, you must select one of the supported regions.

    • Nome do Hub IoT: Digite um nome para o seu hub.IoT Hub Name: Enter a name for your hub. Esse nome deve ser globalmente exclusivo.This name must be globally unique. Caso o nome inserido esteja disponível, uma marca de seleção verde será exibida.If the name you enter is available, a green check mark appears.

    Importante

    Como o Hub IoT será publicamente detectável como um ponto de extremidade DNS, evite inserir informações de identificação pessoal ou confidenciais ao nomeá-lo.Because the IoT hub will be publicly discoverable as a DNS endpoint, be sure to avoid entering any sensitive or personally identifiable information when you name it.

    Criar um hub no portal do Azure

  5. Selecione Avançar: Tamanho e escala para continuar criando o hub IoT.Select Next: Size and scale to continue creating your hub.

    Definir o tamanho e a escala para um novo hub usando o portal do Azure

    Você pode aceitar as configurações padrão aqui.You can accept the default settings here. Se desejar, você poderá modificar qualquer um dos seguintes campos:If desired, you can modify any of the following fields:

    • Tipo e escala de preço: Seu nível selecionado.Pricing and scale tier: Your selected tier. É possível escolher entre várias camadas, dependendo de quantos recursos você quer e quantas mensagens você envia por dia usando sua solução.You can choose from several tiers, depending on how many features you want and how many messages you send through your solution per day. A camada gratuita destina-se a testes e avaliação.The free tier is intended for testing and evaluation. Ela permite que 500 dispositivos sejam conectados ao hub e até 8 mil mensagens por dia.It allows 500 devices to be connected to the hub and up to 8,000 messages per day. Cada assinatura do Azure pode criar um hub IoT na Camada gratuita.Each Azure subscription can create one IoT hub in the free tier.

      Se você estiver trabalhando em um Início Rápido para fluxos de dispositivo do Hub IoT, selecione a camada gratuita.If you are working through a Quickstart for IoT Hub device streams, select the free tier.

    • Unidades do Hub IoT: O número de mensagens permitidas por unidade ao dia depende do tipo de preço do seu hub.IoT Hub units: The number of messages allowed per unit per day depends on your hub's pricing tier. Por exemplo, se você quiser que o hub dê suporte à entrada de 700 mil mensagens, escolha duas unidades do nível S1.For example, if you want the hub to support ingress of 700,000 messages, you choose two S1 tier units. Para obter detalhes sobre as outras opções da camada, consulte Escolher a camada certa do Hub IoT.For details about the other tier options, see Choosing the right IoT Hub tier.

    • Central de Segurança do Azure: Ative essa opção para adicionar uma camada extra de proteção contra ameaças à IoT e aos seus dispositivos.Azure Security Center: Turn this on to add an extra layer of threat protection to IoT and your devices. Ela não está disponível para hubs na camada gratuita.This option is not available for hubs in the free tier. Para mais informações sobre esse recurso, veja Central de Segurança do Azure para IoT.For more information about this feature, see Azure Security Center for IoT.

    • Configurações avançadas > Partições de dispositivo para nuvem: Essa propriedade está relacionada a mensagens de dispositivo para nuvem para o número de leitores simultâneos das mensagens.Advanced Settings > Device-to-cloud partitions: This property relates the device-to-cloud messages to the number of simultaneous readers of the messages. A maioria dos hubs precisa apenas de quatro partições.Most hubs need only four partitions.

  6. Selecione Avançar: Marcas para avançar para a próxima tela.Select Next: Tags to continue to the next screen.

    Marcas são pares nome/valor.Tags are name/value pairs. Você pode atribuir a mesma marca a vários recursos e grupos de recursos para categorizá-los e consolidar a cobrança.You can assign the same tag to multiple resources and resource groups to categorize resources and consolidate billing. Para obter mais informações, veja Usar marcas para organizar os recursos do Azure.For more information, see Use tags to organize your Azure resources.

    Atribuir marcas para o hub usando o portal do Azure

  7. Selecione Avançar: Analisar + criar para examinar suas escolhas.Select Next: Review + create to review your choices. Você verá algo semelhante a esta tela, mas com os valores que você selecionou ao criar o hub.You see something similar to this screen, but with the values you selected when creating the hub.

    Examinar informações para criar o hub

  8. Selecione Criar para criar o hub.Select Create to create your new hub. Criar o hub leva alguns minutos.Creating the hub takes a few minutes.

Alterar as configurações do Hub IoTChange the settings of the IoT hub

Você poderá alterar as configurações de um Hub IoT existente depois que ele for criado no painel Hub IoT.You can change the settings of an existing IoT hub after it's created from the IoT Hub pane.

Captura de tela mostrando as configurações do Hub IoT

Aqui estão algumas das propriedades que você pode definir para um hub IoT:Here are some of the properties you can set for an IoT hub:

Preço e escala : você pode usar essa propriedade para migrar para uma camada diferente ou definir o número de unidades do Hub IoT.Pricing and scale : You can use this property to migrate to a different tier or set the number of IoT Hub units.

Monitoramento de operações : ative ou desative as diferentes categorias de monitoramento, como registro em log para eventos relacionados a mensagens de dispositivo para nuvem ou mensagens de nuvem para dispositivo.Operations monitoring : Turn the different monitoring categories on or off, such as logging for events related to device-to-cloud messages or cloud-to-device messages.

Filtro de IP : especifique um intervalo de endereços IP que serão aceitos ou rejeitados pelo Hub IoT.IP Filter : Specify a range of IP addresses that will be accepted or rejected by the IoT hub.

Propriedades : fornece a lista de propriedades que você pode copiar e usar em outros lugares, como ID de recurso, grupo de recursos, local e assim por diante.Properties : Provides the list of properties that you can copy and use elsewhere, such as the resource ID, resource group, location, and so on.

Políticas de acesso compartilhadoShared access policies

Você também pode exibir ou modificar a lista de políticas de acesso compartilhado clicando em Políticas de acesso compartilhado na seção Configurações .You can also view or modify the list of shared access policies by clicking Shared access policies in the Settings section. Essas políticas definem as permissões para que dispositivos e serviços se conectem ao Hub IoT.These policies define the permissions for devices and services to connect to IoT Hub.

Clique em Adicionar para abrir a folha Adicionar uma política de acesso compartilhado .Click Add to open the Add a shared access policy blade. Você poderá inserir o nome da nova política e as permissões que quer associar a essa política, como mostrado na seguinte figura:You can enter the new policy name and the permissions that you want to associate with this policy, as shown in the following figure:

Captura de tela mostrando a adição de uma política de acesso compartilhado

  • As políticas Leitura do Registro e Gravação do Registro concedem direitos de acesso de leitura e de gravação registro de identidade.The Registry read and Registry write policies grant read and write access rights to the identity registry. Essas permissões são usadas pelos serviços de nuvem de back-end para gerenciar identidades de dispositivo.These permissions are used by back-end cloud services to manage device identities. A escolha da opção de gravação escolhe automaticamente a opção de leitura.Choosing the write option automatically chooses the read option.

  • A política de conexão de serviço concede permissão para acessar pontos de extremidade de serviço.The Service connect policy grants permission to access service endpoints. Essa permissão é usada pelos serviços de nuvem de back-end para enviar e receber mensagens de dispositivos, bem como para atualizar e ler dados de dispositivo e do módulo.This permission is used by back-end cloud services to send and receive messages from devices as well as to update and read device twin and module twin data.

  • A política Conectar dispositivo concede permissões para enviar e receber mensagens usando os pontos de extremidade do lado do dispositivo do Hub IoT.The Device connect policy grants permissions for sending and receiving messages using the IoT Hub device-side endpoints. Essa permissão é usada pelos dispositivos para enviar e receber mensagens de um hub IoT, atualizar e ler os dados do dispositivo e do módulo e executar carregamentos de arquivos.This permission is used by devices to send and receive messages from an IoT hub, update and read device twin and module twin data, and perform file uploads.

Clique em Criar para adicionar essa política recém-criada à lista existente.Click Create to add this newly created policy to the existing list.

Para obter informações mais detalhadas sobre o acesso concedido por permissões específicas, consulte permissões do Hub IOT.For more detailed information about the access granted by specific permissions, see IoT Hub permissions.

Registrar um novo dispositivo no hub IoTRegister a new device in the IoT hub

Nesta seção, você cria uma identidade de dispositivo no registro de identidade no hub IoT.In this section, you create a device identity in the identity registry in your IoT hub. Um dispositivo não pode se conectar ao hub, a menos que ele tenha uma entrada no registro de identidade.A device cannot connect to a hub unless it has an entry in the identity registry. Para obter mais informações, consulte o Guia de desenvolvedor do Hub IoT.For more information, see the IoT Hub developer guide.

  1. No menu de navegação do hub IoT, abra Dispositivos IoT e, em seguida, selecione Novo para adicionar um dispositivo no hub IoT.In your IoT hub navigation menu, open IoT Devices, then select New to add a device in your IoT hub.

    Criar identidade do dispositivo no portal

  2. Em Criar um dispositivo, forneça um nome para o novo dispositivo, como myDeviceId e selecione Salvar.In Create a device, provide a name for your new device, such as myDeviceId, and select Save. Essa ação cria uma identidade do dispositivo para o seu hub IoT.This action creates a device identity for your IoT hub.

    Adicionar um novo dispositivo

    Importante

    A ID do dispositivo pode estar visível nos logs coletados para o atendimento ao cliente e à solução de problemas. Portanto, evite informações confidenciais ao nomear.The device ID may be visible in the logs collected for customer support and troubleshooting, so make sure to avoid any sensitive information while naming it.

  3. Após a criação do dispositivo, abra o dispositivo na lista do painel Dispositivos IoT.After the device is created, open the device from the list in the IoT devices pane. Copie a Cadeia de Conexão Primária para usá-la mais tarde.Copy the Primary Connection String to use later.

    Cadeia de conexão de dispositivo

Observação

O Registro de identidade do Hub IoT armazena apenas as identidades de dispositivo para habilitar o acesso seguro ao Hub IoT.The IoT Hub identity registry only stores device identities to enable secure access to the IoT hub. Ele armazena as IDs e as chaves do dispositivo a usar como credenciais de segurança e um sinalizador habilitado/desabilitado que você poderá usar para desabilitar o acesso de um dispositivo individual.It stores device IDs and keys to use as security credentials, and an enabled/disabled flag that you can use to disable access for an individual device. Se seu aplicativo precisar armazenar outros metadados específicos do dispositivo, ele deverá usar um repositório específico do aplicativo.If your application needs to store other device-specific metadata, it should use an application-specific store. Para saber mais, confira Guia de Desenvolvedor do Hub IoT.For more information, see IoT Hub developer guide.

Roteamento de Mensagem para um hub IoTMessage Routing for an IoT hub

Clique em Roteamento de Mensagens em Mensagens para ver o painel de Roteamento de Mensagens, no qual você define rotas e pontos de extremidade personalizados para o hub.Click Message Routing under Messaging to see the Message Routing pane, where you define routes and custom endpoints for the hub. Roteamento de mensagens permite que você gerencie como os dados são enviados de seus dispositivos para seus pontos de extremidade.Message routing enables you to manage how data is sent from your devices to your endpoints. A primeira etapa é adicionar uma nova rota.The first step is to add a new route. Em seguida, você pode adicionar um ponto de extremidade existente à rota ou criar um novo dos tipos compatíveis, como Armazenamento de Blobs.Then you can add an existing endpoint to the route, or create a new one of the types supported, such as blob storage.

Painel de roteamento de mensagem

RotasRoutes

Rotas é a primeira guia no painel Roteamento de Mensagens.Routes is the first tab on the Message Routing pane. Para adicionar uma nova rota, clique em + Adicionar .To add a new route, click + Add . Você verá a tela a seguir.You see the following screen.

Captura de tela mostrando a adição de uma nova rota

Nomeie a rota.Name your route. O nome da rota deve ser exclusivo na lista de rotas para esse Hub.The route name must be unique within the list of routes for that hub.

Para Ponto de Extremidade , você pode selecionar um na lista suspensa ou adicionar um novo.For Endpoint , you can select one from the dropdown list, or add a new one. Neste exemplo, uma conta de armazenamento e o contêiner já estão disponíveis.In this example, a storage account and container are already available. Para adicioná-los como um ponto de extremidade, clique em + Adicionar ao lado da lista suspensa Ponto de Extremidade e selecione Armazenamento de Blobs .To add them as an endpoint, click + Add next to the Endpoint dropdown and select Blob Storage . A tela a seguir mostra o local em que a conta de armazenamento e o contêiner são especificados.The following screen shows where the storage account and container are specified.

Captura de tela mostrando a adição de um ponto de extremidade de armazenamento para a regra de roteamento

Clique em Escolher um contêiner para selecionar a conta de armazenamento e o contêiner.Click Pick a container to select the storage account and container. Quando você tiver selecionado esses campos, ele retornará para o painel do Ponto de Extremidade.When you have selected those fields, it returns to the Endpoint pane. Use os padrões para o restante dos campos e Criar para criar o ponto de extremidade da conta de armazenamento e adicioná-lo às regras de roteamento.Use the defaults for the rest of the fields and Create to create the endpoint for the storage account and add it to the routing rules.

Para Fonte de dados , selecione Mensagens de Telemetria do Dispositivo.For Data source , select Device Telemetry Messages.

Em seguida, adicione uma consulta de roteamento.Next, add a routing query. Neste exemplo, as mensagens que têm uma propriedade de aplicativo chamada level com um valor igual a critical são roteadas para a conta de armazenamento.In this example, the messages that have an application property called level with a value equal to critical are routed to the storage account.

Captura de tela mostrando como salvar uma nova regra de roteamento

Clique em Salvar para salvar a regra de roteamento.Click Save to save the routing rule. Você retorna ao painel de Roteamento de Mensagens e a nova regra de roteamento é exibida.You return to the Message Routing pane, and your new routing rule is displayed.

Pontos de extremidade personalizadosCustom endpoints

Clique na guia pontos de extremidade personalizados . Você verá todos os pontos de extremidade personalizados já criados.Click the Custom endpoints tab. You see any custom endpoints already created. Daqui, você pode adicionar novos pontos de extremidade ou excluir pontos de extremidade existentes.From here, you can add new endpoints or delete existing endpoints.

Observação

Se você excluir uma rota, não serão excluídos os pontos de extremidade atribuídos a ela.If you delete a route, it does not delete the endpoints assigned to that route. Para excluir um ponto de extremidade, clique na guia Pontos de extremidade personalizados, selecione o ponto de extremidade que você deseja excluir e clique em Excluir.To delete an endpoint, click the Custom endpoints tab, select the endpoint you want to delete, and click Delete.

Você pode ler mais sobre pontos de extremidade personalizados em Referência — Pontos de extremidade do Hub IoT.You can read more about custom endpoints in Reference - IoT hub endpoints.

Você pode definir até 10 pontos de extremidade personalizados para o Hub IoT.You can define up to 10 custom endpoints for an IoT hub.

Para ver um exemplo completo de como usar pontos de extremidade personalizados com o roteamento, veja Roteamento de mensagem com o Hub IoT.To see a full example of how to use custom endpoints with routing, see Message routing with IoT Hub.

Localize um hub IoT específicoFind a specific IoT hub

Aqui estão duas maneiras de localizar um hub IoT específico em sua assinatura:Here are two ways to find a specific IoT hub in your subscription:

  1. Se você souber a qual grupo de recursos o hub IoT pertence, clique em Grupos de recursos e selecione o grupo de recursos na lista.If you know the resource group to which the IoT hub belongs, click Resource groups , then select the resource group from the list. A tela de grupo de recursos mostra todos os recursos nesse grupo, incluindo os hubs IoT.The resource group screen shows all of the resources in that group, including the IoT hubs. Clique no hub que você está procurando.Click on the hub for which you're looking.

  2. Clique em Todos os recursos .Click All resources . No painel Todos os recursos , há uma lista suspensa que assume All types como padrão.On the All resources pane, there is a dropdown list that defaults to All types. Clique na lista suspensa e desmarque a opção Select all.Click on the dropdown list, uncheck Select all. Localize IoT Hub e verifique-o.Find IoT Hub and check it. Clique na caixa de listagem suspensa para fechá-la, e as entradas serão filtradas, mostrando apenas seus hubs IoT.Click on the dropdown list box to close it, and the entries will be filtered, showing only your IoT hubs.

Excluir o Hub IoTDelete the IoT hub

Para excluir um hub IoT, localize o hub IoT que você deseja excluir e, em seguida, clique no botão Excluir abaixo do nome do hub IoT.To delete an Iot hub, find the IoT hub you want to delete, then click the Delete button below the IoT hub name.

Próximas etapasNext steps

Para saber mais sobre o gerenciamento do Hub IoT do Azure, siga estes links:Follow these links to learn more about managing Azure IoT Hub: