すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:MQTT ゲートウェイ製品にデバイスを追加する

最終更新日:Mar 26, 2025

認証タイプパラメーターが一方検証に設定されているゲートウェイ製品に、デバイスの検証情報をインポートする必要があります。このようにして、デバイスを IoT Platform に接続するときに、この情報を使用してデバイスを検証できます。このトピックでは、デバイスの検証情報をインポートする方法について説明します。

前提条件

認証タイプパラメーターが一方検証に設定されているゲートウェイが、IoT Platform コンソールで製品として作成されています。詳細については、「MQTT ゲートウェイを作成する」をご参照ください。

背景情報

  • 認証タイプパラメーターが サードパーティ認証 に設定されているゲートウェイを作成し、そのゲートウェイを使用してデバイスを IoT Platform に初めて接続すると、IoT Platform は deviceName パラメーターの戻り値をデバイス名として自動的に使用してデバイスを作成します。

    MQTT.fx を使用してデバイスをシミュレートし、ゲートウェイを使用してデバイスを IoT Platform に接続して通信を有効にすることができます。詳細については、「MQTT.fx を使用してデバイスを接続する(デバイス検証用の Function Compute)」をご参照ください。

  • 認証タイプパラメーターが 一方検証 に設定されているゲートウェイを作成した後は、デバイスの検証情報をインポートして、IoT Platform コンソールのゲートウェイ製品にデバイスを追加する必要があります。次のセクションでは、デバイスを追加する方法について説明します。

複数のデバイスを追加する

  1. IoT Platform コンソール にログオンします。

  2. [概要] タブで、管理する Exclusive Enterprise Edition インスタンスをクリックします。

  3. 左側のナビゲーションウィンドウで、[デバイス] > [製品] を選択します。作成したゲートウェイを見つけ、[操作] 列の [デバイスの管理] をクリックします。

  4. [デバイス] ページで、[一括追加] をクリックします。

    批量添加

  5. [デバイスの一括追加] ダイアログボックスで、[.csv テンプレートのダウンロード] をクリックして、デバイス検証情報のテンプレートをダウンロードします。

    批量添加设备

  6. テンプレートファイルに、追加する各デバイスのシリアル番号(SN)、MQTT ユーザー名、および MQTT パスワードを入力して、ファイルを保存します。

    重要
    • MQTT ユーザー名と MQTT パスワードは必須です。SN はオプションです。

    • MQTT ユーザー名は 4 ~ 32 文字で、英字、数字、ハイフン(-)、アンダースコア(_)、アットマーク(@)、ピリオド(.)、コロン(:)を含めることができます。各 MQTT ユーザー名は、製品内で一意である必要があります。

    • MQTT パスワードは 1 ~ 32 文字で、英字、数字、ハイフン(-)、アンダースコア(_)、アットマーク(@)、ピリオド(.)、コロン(:)を含めることができます。

    • 各テンプレートファイルには、最大 10,000 台のデバイスの情報を含めることができます。重複するデバイスに関する情報はインポートしないでください。

    设备文件

  7. [デバイスの一括追加] ダイアログボックスに移動し、[ファイルのアップロード] をクリックして、完成したテンプレートファイルを IoT Platform コンソールにアップロードし、[OK] をクリックします。

    上传文件

    テンプレートファイルに無効な情報が含まれている場合は、エラーが返されます。[無効なデバイス名リストのダウンロード] をクリックして、無効な情報を表示して変更し、テンプレートファイルを再度アップロードします。

    不合法输入

関連操作

API

説明

ImportDevice

MQTT ゲートウェイ製品にデバイスを追加します。

BatchImportDevice

MQTT ゲートウェイ製品に複数のデバイスを同時に追加します。

BatchCheckImportDevice

同時に追加された複数のデバイスを検証します。

QueryImportedDeviceByApplyId

アプリケーション ID によって同時に追加された複数のデバイスをクエリします。

結果

デバイス検証情報がインポートされると、IoT Platform はデバイスを作成し、アップロードされた MQTT ユーザー名を DeviceName として使用します。[デバイス] ページには、作成されたデバイスに関する情報が表示されます。设备列表

次の手順

デバイスをゲートウェイ製品に追加した後、各デバイスのエンドポイントを更新する必要があります。

  • デバイスにエンドポイントが指定されている場合は、CNAME レコードを設定して、エンドポイントをゲートウェイ URL に変更する必要があります。ドメイン名の解決方法については、「Alibaba Cloud DNS」をご参照ください。

  • デバイスにエンドポイントが指定されていない場合は、ゲートウェイ URL をデバイスのエンドポイントとして指定する必要があります。詳細については、「MQTT 経由でデバイスを IoT Platform に接続する」をご参照ください。

ゲートウェイ URL の取得方法については、「ゲートウェイのゲートウェイ URL を表示する」をご参照ください。

ゲートウェイを使用してデバイスを IoT Platform に接続する方法については、「メッセージング」をご参照ください。

MQTT.fx を使用してデバイスをシミュレートし、ゲートウェイを使用してデバイスを IoT Platform に接続して通信を確立できます。詳細については、「MQTT.fx を使用してデバイスを接続する(一方検証)」をご参照ください。