デバイス SDK、IoT Platform SDK、または AMQP SDK を開発する場合、ターゲットインスタンスのエンドポイントとしてアクセスドメイン名を設定する必要があります。このトピックでは、各インスタンスタイプのエンドポイント情報を取得する方法について説明します。
前提条件
-
SDK 開発ガイドについては、「デバイスサイド SDK」、「IoT Platform SDK」、および「AMQP クライアントの接続」をご参照ください。
-
インスタンスタイプの比較については、「インスタンスの概要」をご参照ください。
インスタンス
リージョン
説明
表示方法
レガシーパブリックインスタンス
中国 (上海)、日本 (東京)、シンガポール、ドイツ (フランクフルト)、米国 (シリコンバレー)、および米国 (バージニア)
IoT Platform コンソールの [概要] ページでは、インスタンス [ID] の値は表示されません。
[開発設定] パネルは IoT Platform コンソールでは利用できません。エンドポイントの詳細については、「レガシーパブリックインスタンスのエンドポイントの表示」をご参照ください。
パブリックインスタンス
-
IoT Platform コンソールの [概要] ページでは、インスタンス [ID] の値が表示され、[インスタンスの詳細] ページが利用可能です。
-
パブリックインスタンスは、IoT Platform をアクティブ化するとデフォルトで作成されます。
コンソールで [開発設定] パネルが利用できます。「パブリックインスタンスと Enterprise Edition インスタンスのエンドポイントの表示」をご参照ください。
Enterprise Edition インスタンス
中国 (上海)、中国 (北京)、中国 (深セン)、日本 (東京)、シンガポール、ドイツ (フランクフルト)、米国 (シリコンバレー)、および米国 (バージニア)
-
背景情報
-
エンドポイントのタイプ
-
エンドポイントは、パブリックエンドポイントと VPC エンドポイントに分類されます。VPC エンドポイントは、ネットワークレイテンシーとパブリック帯域幅のコストを削減し、接続のセキュリティと安定性を向上させます。
-
デバイスは、MQTT、CoAP、または HTTP 経由で IoT Platform に接続できます。Premium Enterprise Edition インスタンスは VPC 接続もサポートしており、デバイスは MQTT VPC エンドポイントを使用できます。
-
VPC 内の ECS インスタンスから IoT Platform にアクセスするには、AMQP サーバーサイドサブスクリプションと IoT Platform API の呼び出しに VPC エンドポイントを設定する必要があります。
-
-
インスタンスタイプ
-
中国 (上海)、中国 (北京)、および中国 (深セン) の Standard および Premium Enterprise Edition インスタンスは、MQTT エンドポイントへの固定 IP のバインドをサポートしています。
-
Premium Enterprise Edition インスタンスでは、専用の MQTT エンドポイントを手動で作成する必要があります。ポート番号と証明書をカスタマイズすることもできます。
-
レガシーパブリックインスタンスのエンドポイントの表示
|
通信プロトコル |
エンドポイントの形式 |
ポート |
|
MQTT |
|
1883 または 443。 MQTT over WebSocket にはポート 443 を使用します。 |
|
CoAP |
|
|
|
HTTP |
デバイスごとの個別証明書： |
443。 |
|
プロダクトごとの事前登録済み個別証明書： 重要
HTTPS 経由のプロダクトごとの事前登録済み個別証明書は、中国 (上海) リージョンでのみサポートされています。 |
||
|
AMQP |
|
|
|
IoT Platform API |
リクエスト構造は |
該当なし。 |
|
ID² |
および 日本 (東京) リージョンでのみサポートされています。 |
1883。 |
エンドポイント URL の次のパラメーターを置き換えてください。
|
パラメーター |
説明 |
|
|
デバイスを含むプロダクトの ProductKey。IoT Platform コンソールにログインし、デバイス詳細ページで ProductKey を確認します。 |
|
|
デバイスが配置されているリージョンの ID。リージョン ID については、「サポートされているリージョン」をご参照ください。 |
|
|
Alibaba Cloud アカウント ID。IoT Platform コンソールにログインし、プロフィール写真にカーソルを合わせると、[アカウント ID] を表示できます。 |
パブリックインスタンスと Enterprise Edition インスタンスのエンドポイントの表示
-
[IoT Platform コンソール] にログインします。ページ左上隅で、ご利用のインスタンスが配置されているリージョンを選択します。
-
[概要] ページで、インスタンスのエイリアスまたは [ID] をクリックします。
-
[インスタンスの詳細] ページの右上隅にある [開発設定の表示] をクリックします。
-
[開発設定] パネルで、[MQTT]、[CoAP]、[AMQP]、またはその他のプロトコルタブをクリックして、エンドポイント情報を表示します。ドメイン名の横にある [コピー] をクリックして、エンドポイントアドレスをコピーします。ヘルプアイコン
をクリックしてポートを表示します。ポートの詳細については、「レガシーパブリックインスタンスのエンドポイントの表示」をご参照ください。重要-
Premium Enterprise Edition インスタンスの場合、MQTT エンドポイントを手動で作成する必要があります。「Premium Enterprise Edition インスタンス用の専用 MQTT エンドポイントの作成」をご参照ください。
-
HTTPS 経由のデバイス接続では、デバイスごとの個別証明書と、プロダクトごとの事前登録済み個別証明書の方式のみがサポートされています。これらの方式では、異なるエンドポイントを使用します。
-
デバイスごとの個別証明書方式を使用する場合、エンドポイントは [HTTP] タブに表示されます。
-
プロダクトごとの事前登録済み個別証明書方式は、中国 (上海) リージョンでのみサポートされています。エンドポイントは
iot-auth.cn-shanghai.aliyuncs.comです。
-
-
Enterprise Edition インスタンスの ID² 認証は、中国 (上海) および日本 (東京) リージョンでのみサポートされています。このため、[開発設定] パネルの [ID² の管理] タブに [ID² 認証アドレス] は表示されません。アドレス形式の詳細については、「レガシーパブリックインスタンスのエンドポイントの表示」をご参照ください。
[開発設定] パネルには、[パブリックエンドポイント] と [VPC ネットワークエンドポイント] の 2 つのセクションがあります。各セクションには、サポートされているプロトコル (MQTT、CoAP、HTTP、AMQP) のタブが含まれています。これらのタブでは、エンドポイントアドレス、接続ポート、および関連設定を確認できます。たとえば、[MQTT] タブには、エンドポイントアドレス、接続ポート、および [固定 IP] のバインド状態が表示されます。
-
エンドポイントへの固定 IP のバインド
この機能は、中国 (上海)、中国 (北京)、および中国 (深セン) リージョンの Standard および Premium Enterprise Edition インスタンスでのみ利用可能です。
固定 IP は、IoT Platform が IP アドレスをスケーリングする際に、DNS 解決が安定していることを保証します。特定の IP アドレスに制限されたデータプランを持つ IoT SIM カードを使用し、キャリアがドメイン名設定をサポートしていない場合は、固定 IP をキャリアの IP 許可リストに追加します。
キャリアのデータセンター移転などの場合、IP アドレスが変更されることがあります。デバイスがエンドポイントではなく固定 IP を使用して接続している場合、クラウドからデバイスへのコマンドまたは OTA アップデートを介して新しい IP をデバイスにプッシュする必要があります。そうしないと、デバイスは IoT Platform に接続できません。
デバイス接続にはエンドポイントを使用することを推奨します。IoT Platform は、IP アドレスの変更を事前に通知します。
インスタンスのパブリック MQTT エンドポイントに固定 IP をバインドするには、次の手順を実行します。
-
パブリックインスタンスの場合、MQTT 接続用に 2 つの固定 IP を割り当てることができます。
-
パブリックインスタンスの [インスタンスの詳細] ページの右上隅にある [開発設定の表示] をクリックします。
-
[開発設定] パネルの [MQTT] タブで、[固定 IP] の横にある [設定] をクリックします。
-
表示されるダイアログボックスで [OK] をクリックして、2 つの固定 IP を取得します。
MQTT 接続に固定 IP が不要になった場合は、[バインド解除] をクリックします。
-
-
Premium Enterprise Edition インスタンスの場合、パブリック MQTT エンドポイントを手動で作成すると、固定 IP が自動的に割り当てられます。バインド解除はサポートされていません。
Premium Enterprise Edition インスタンス用の専用 MQTT エンドポイントの作成
Premium Enterprise Edition インスタンスの MQTT エンドポイントを作成するには、次の手順を実行します。
-
Premium Enterprise Edition インスタンスの [インスタンスの詳細] ページの右上隅にある [開発設定の表示] をクリックします。
-
[開発設定] パネルの [MQTT] タブで、[作成] をクリックします。
-
[エンドポイントの作成] ダイアログボックスで、エンドポイント情報を設定します。
パラメーター
説明
カスタムポート
MQTT 接続のポート番号。デフォルトのポートは 1883 です。
VPC の有効化
-
はい：VPC 接続を有効にします。VPC、vSwitch ゾーン、vSwitch、およびセキュリティグループを設定します。
これにより、パブリックと VPC の両方の MQTT エンドポイントが作成されます。
重要VPC 経由で MQTT エンドポイントを有効にするには、PrivateLink サービスをアクティブ化します。PrivateLink がアクティブ化されていない場合は、[有効化] をクリックして VPC コンソールに移動し、アクティブ化します。
-
いいえ (デフォルト)：VPC 接続を無効にします。
これにより、パブリック MQTT エンドポイントのみが作成されます。
重要[いいえ] を選択した場合、後でこのエンドポイントの VPC 接続を有効にすることはできません。
認可
VPC 接続を有効にする場合は、認可を付与します。
[認可] をクリックします。システムは、デバイスが VPC 経由で IoT Platform に接続できるようにするためのロールと認可ポリシーを作成します。「サービスにリンクされたロール」をご参照ください。
VPC
VPC 接続を有効にして認可を付与した後、これらのパラメーターを設定します。
既存の VPC と vSwitch を選択します。
[VPC の作成] または [vSwitch の作成] をクリックして、新しいものを作成できます。「VPC の作成」および「vSwitch の作成」をご参照ください。
vSwitch ゾーン
vSwitch
セキュリティグループ
VPC 接続を有効にして認可を付与した後、このパラメーターを設定します。
既存のセキュリティグループを選択します。
[セキュリティグループの作成] をクリックして作成できます。「セキュリティグループの作成」をご参照ください。
-
-
[OK] をクリックします。
エンドポイントが作成されると、新しいエンドポイントが [MQTT デバイス接続] の下に表示されます。
Premium Enterprise Edition インスタンス用の MQTT 証明書のカスタマイズ
Premium Enterprise Edition インスタンスへの MQTT 接続用の証明書とドメイン名をカスタマイズするには、次の手順を実行します。
パブリックエンドポイントと VPC エンドポイントの両方で同じカスタム証明書が使用されます。
-
Premium Enterprise Edition インスタンスの [インスタンスの詳細] ページの右上隅にある [開発設定の表示] をクリックします。
-
[開発設定] パネルの [MQTT] タブで、[カスタム証明書] の下にある [設定] をクリックします。
-
[カスタム証明書] ダイアログボックスで、[カスタム設定] の [オン] をクリックします。
説明[カスタム設定] がすでに有効になっている場合は、この手順をスキップしてください。
-
認証局 (CA) から取得した PEM 形式の証明書の内容と秘密鍵を入力し、[OK] をクリックします。
警告初期設定後に証明書の内容や秘密鍵を更新すると、証明書の検証に失敗し、デバイスが IoT Platform から切断され、サービスが中断される可能性があります。慎重に進めてください。
ページには、証明書から解析されたカスタムドメイン名が表示されます。このドメイン名を MQTT デバイス接続に使用します。
重要ドメインプロバイダーで CNAME レコードを設定して、カスタムドメイン名をインスタンスのデフォルトの MQTT エンドポイントに解決します。