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

IoT Platform:ゲートウェイデバイスの作成 (MQTT)

最終更新日:Jun 17, 2026

一対一認証を使用するプロダクト向けのゲートウェイデバイスを作成するには、デバイス認証情報をインポートします。IoT Platform はこの情報を使用して、接続時にデバイスを認証します。

前提条件

ゲートウェイを追加し、一対一認証を使用するゲートウェイプロダクトを作成しておく必要があります。詳細については、「ゲートウェイプロダクトの作成 (MQTT)」をご参照ください。

背景情報

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

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

  • [一対一認証]を使用するゲートウェイを作成した後、デバイス認証情報を IoT Platform にインポートしてゲートウェイデバイスを作成します。

デバイスの一括追加

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

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

  3. 左側メニューで、[デバイス管理] > [プロダクト] を選択します。作成したゲートウェイプロダクトを見つけ、**[操作]** 列の [デバイスを管理] をクリックします。

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

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

  6. テンプレートに SN、MQTT ユーザー名、MQTT パスワードを入力し、ファイルを保存します。

    重要
    • MQTT ユーザー名と MQTT パスワードは必須です。SN は任意です。

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

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

    • 1 つのファイルには最大 10,000 件のデバイスレコードを含めることができます。重複するデバイスはインポートしないでください。

  7. [デバイスの一括追加] ダイアログボックスに戻り、[ファイルをアップロード] をクリックし、保存したファイルを選択してから [OK] をクリックします。

    ファイルがアップロードされると、ダイアログボックスに [解析完了] のステータスと [デバイス総数] が表示されます。情報を確認した後、[OK] をクリックします。

    デバイスのリストに無効な情報が含まれている場合、エラーメッセージが表示されます。[無効なリストのダウンロード] をクリックし、無効なエントリを確認して修正し、再度ファイルをアップロードします。

    エラーメッセージには、無効な [SN][MQTT ユーザー名][MQTT パスワード] など、具体的な無効なフィールドが示されます。情報を確認して修正してから、再度ファイルをアップロードしてください。

関連 API

API

説明

ImportDevice

単一のデバイスを MQTT ゲートウェイプロダクトにインポートします。

BatchImportDevice

複数のデバイスを MQTT ゲートウェイプロダクトにインポートします。

BatchCheckImportDevice

一括インポートされたデバイスを検証します。

QueryImportedDeviceByApplyId

アプリケーション ID (ApplyId) に基づいて、一括インポートされたデバイスのリストを照会します。

結果

デバイス認証情報がインポートされると、IoT Platform はエントリごとにデバイスを作成し、アップロードされた MQTT ユーザー名をデバイス名として使用します。新しいゲートウェイデバイスは、[デバイス管理] > [デバイス] ページに表示されます。[デバイスリスト] では、各デバイスの [ノードタイプ][ゲートウェイ] であり、デバイスは有効化されているもののまだ接続されていないためステータスは [非アクティブ] となり、[最終オンライン時間] 列は空です。

次のステップ

ゲートウェイデバイスを作成した後、それらのエンドポイントを更新する必要があります。

  • デバイスにエンドポイントが設定済みの場合、CNAME レコードを作成してそのエンドポイントをゲートウェイ URL にマッピングします。DNS 設定の詳細については、「Alibaba Cloud DNS」をご参照ください。

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

ゲートウェイ URL を確認するには、「ゲートウェイ URL の表示」をご参照ください。

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

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