Todos os produtos
Search
Central de documentação

IoT Platform:Criar um dispositivo de gateway (MQTT)

Última atualização: Jun 26, 2026

Para criar dispositivos de gateway em um produto que usa verificação de parte única, importe as informações de verificação do dispositivo. O IoT Platform usa essas informações para autenticar os dispositivos durante a conexão.

Pré-requisitos

Você adicionou um gateway e criou um produto de gateway que usa verificação de parte única. Para mais informações, consulte Criar um produto de gateway (MQTT).

Contexto

  • Após criar um cloud gateway com Third-party Authentication, o IoT Platform cria automaticamente um dispositivo com base no valor deviceName retornado quando o dispositivo se conecta pela primeira vez.

    Use o MQTT.fx para simular um dispositivo conectando-se ao IoT Platform através do cloud gateway. Para mais informações, consulte Usar o MQTT.fx para conectar um dispositivo (autenticação do Alibaba Cloud FC).

  • Após criar um gateway que usa one-party verification, importe as informações de verificação do dispositivo no IoT Platform para criar dispositivos de gateway.

Adicionar dispositivos em lote

  1. Acesse o console do IoT Platform.

  2. Na página Instance Overview, clique na instância Enterprise de destino da Exclusive Edition.

  3. No painel de navegação à esquerda, acesse Device Management > Products. Encontre o produto de gateway criado e clique em Manage Devices na coluna Actions.

  4. Na página Devices, clique em Batch Add.

  5. Na caixa de diálogo Batch Add Devices, clique em Download .csv Template.

  6. No modelo, preencha o SN, o nome de usuário MQTT e a senha MQTT e salve o arquivo.

    Importante
    • O nome de usuário MQTT e a senha MQTT são obrigatórios. O SN é opcional.

    • Um nome de usuário MQTT deve ter entre 4 e 32 caracteres e pode conter letras, dígitos, hifens (-), sublinhados (_), sinais de arroba (@), pontos (.) e dois-pontos (:). Cada nome de usuário MQTT deve ser exclusivo por produto.

    • Uma senha MQTT deve ter entre 1 e 32 caracteres e pode conter letras, dígitos, hifens (-), sublinhados (_), sinais de arroba (@), pontos (.) e dois-pontos (:).

    • Um único arquivo pode conter no máximo 10.000 registros de dispositivos. Não importe dispositivos duplicados.

  7. Volte à caixa de diálogo Batch Add Devices, clique em Upload File, selecione o arquivo salvo e clique em OK.

    Após o upload do arquivo, a caixa de diálogo exibe o status Parsing Completed e o total Total Devices. Após confirmar as informações, clique em OK.

    Se a lista de dispositivos contiver informações inválidas, uma mensagem de erro aparecerá. Clique em Download Invalid List, revise as entradas inválidas, corrija-as e faça o upload do arquivo novamente.

    A mensagem de erro indica os campos inválidos específicos, como um SN, MQTT username ou MQTT password inválido. Verifique e corrija as informações antes de fazer o upload do arquivo novamente.

Referência de API

API

Descrição

ImportDevice

Importa um único dispositivo em um produto de gateway MQTT.

BatchImportDevice

Importa vários dispositivos em um produto de gateway MQTT.

BatchCheckImportDevice

Verifica um lote de dispositivos importados.

QueryImportedDeviceByApplyId

Consulta uma lista de dispositivos importados em lote pelo ID do aplicativo (ApplyId).

Resultados

Após importar as informações de verificação do dispositivo, o IoT Platform cria um dispositivo para cada entrada e usa o nome de usuário MQTT enviado como nome do dispositivo. Os novos dispositivos de gateway aparecem na página Device Management > Devices. Na Device List, o tipo de nó de cada dispositivo é device, o status é inactive, o dispositivo está habilitado e a coluna Last Online Time está vazia.

Próximas etapas

Após criar os dispositivos de gateway, atualize os endpoints deles:

  • Se os dispositivos já tiverem um endpoint configurado, crie um registro CNAME para mapear esse endpoint para a URL do gateway. Para mais informações sobre configuração de DNS, consulte Alibaba Cloud DNS.

  • Se os dispositivos não tiverem um endpoint configurado, configure a URL do gateway nos dispositivos. Para mais informações, consulte Conectar um dispositivo via MQTT.

Para encontrar a URL do gateway, consulte Visualizar a URL do gateway.

Para mais informações sobre como os dispositivos de gateway se conectam ao IoT Platform para comunicação, consulte Visão geral de mensagens.

Use o MQTT.fx para simular um dispositivo de gateway e conectá-lo ao IoT Platform para comunicação. Para mais informações, consulte Conectar um dispositivo usando o MQTT.fx (verificação de parte única).