AWS IoT Core サービスエンドポイントへの接続

AWS IoT Core- コントロールプレーンの機能にアクセスするには AWS CLI、、任意の言語の AWS SDK を使用するか、 RESTAPIを直接呼び出します。 AWS CLI または AWS SDK を使用して とやり取りすることをお勧めします。これは、 AWS サービスを呼び出すためのベストプラクティスが組み込まれ AWS IoT Core ているためです。REST APIs を直接呼び出すことはオプションですが、 へのアクセスを可能にするために必要なセキュリティ認証情報を指定する必要がありますAPI。

注記

IoT デバイスは、AWS IoT デバイス SDKs を使用する必要があります。デバイスはSDKs、デバイスでの使用に最適化され、 とのMQTT通信をサポートし AWS IoT、デバイスで最もよく使用される をサポートします AWS IoT APIs。デバイスSDKsとそれらが提供する機能の詳細については、「」を参照してくださいAWS IoT デバイス SDKs。

モバイルデバイスは、AWS モバイル SDKs を使用する必要があります。Mobile SDKsは AWS IoT APIs、、MQTTデバイス通信、およびモバイルデバイス上のAPIs他の AWS サービスの をサポートします。Mobile SDKsとその機能の詳細については、「」を参照してくださいAWS モバイル SDKs。

ウェブアプリケーションやモバイルアプリケーションで AWS Amplify ツールやリソースを使用して、 により簡単に接続できます AWS IoT Core。Amplify AWS IoT Core を使用して に接続する方法の詳細については、Amplify ドキュメントの「Pub Sub Getting Started」を参照してください。

以下のセクションでは、 およびその他の AWS サービスの開発と操作SDKsに使用できるツール AWS IoT と について説明します。でアプリケーションを構築および管理するために使用できる AWS ツールと開発キットの完全なリストについては AWS、「 で構築するツール AWS」を参照してください。

AWS CLI の AWS IoT Core

AWS CLI は、 へのコマンドラインアクセスを提供します AWS APIs。

• インストール

  のインストール方法については AWS CLI、「 のインストール AWS CLI」を参照してください。

• 認証

  AWS CLI は の認証情報を使用します AWS アカウント。

• リファレンス

  これらの AWS IoT Core サービスの AWS CLI コマンドの詳細については、以下を参照してください。

  • AWS CLI IoT のコマンドリファレンス

  • AWS CLI IoT データのコマンドリファレンス

  • AWS CLI IoT ジョブデータのコマンドリファレンス

  • AWS CLI IoT セキュアトンネリングのコマンドリファレンス

PowerShell スクリプト環境で AWS サービスとリソースを管理するツールについては、AWS 「 Tools for PowerShell」を参照してください。

AWS SDKs

を使用すると AWS SDKs、アプリケーションと互換性のあるデバイスは、 およびその他の AWS サービスの APIs を呼び AWS IoT APIs出すことができます。このセクションでは、 へのリンクと、 AWS SDKs AWS IoT Core サービスの のAPIリファレンスドキュメントへのリンクAPIsを提供します。

は AWS SDKsこれらをサポートします。 AWS IoT Core APIs

• AWS IoT

• AWS IoT データプレーン

• AWS IoT ジョブデータプレーン

• AWS IoT セキュアトンネリング

• AWS IoT ワイヤレス

C++

AWS SDK for C++ をインストールし、それを使用して AWS IoTに接続するには以下のようにします。

1. for C++ の使用 AWS SDKを開始するの手順に従います。

   次の手順では、次の方法について説明します。

   • ソースファイルSDKから をインストールして構築する

   • SDK で を使用するための認証情報を指定する AWS アカウント

   • アプリまたはサービスSDKで を初期化およびシャットダウンする

   • アプリケーションまたはサービスを構築するためのCMakeプロジェクトを作成する

2. サンプルアプリケーションを作成して実行します。for C++ を使用するサンプルアプリケーションについては、AWS SDK for C++ 「コード例 AWS SDK」を参照してください。

がサポートする AWS IoT CoreAWS SDK for C++ サービスのドキュメント

• AWS::I oTClient" リファレンスドキュメント

• Aws::I oTDataPlane::I oTDataPlaneClient リファレンスドキュメント

• Aws::I oTJobsDataPlane::I oTJobsDataPlaneClient リファレンスドキュメント

• Aws::I oTSecureトンネリング::I oTSecureTunnelingClient リファレンスドキュメント

Go

AWS SDK for Go をインストールし、それを使用して AWS IoTに接続するには以下のようにします。

1. 「 の開始方法」の手順に従ってください。 AWS SDK for Go

   次の手順では、次の方法について説明します。

   • のインストール AWS SDK for Go

   • にアクセスSDKするための のアクセスキーを取得する AWS アカウント

   • アプリケーションまたはサービスのソースコードにパッケージをインポートする

2. サンプルアプリケーションを作成して実行します。 AWS SDK for Goを使用するサンプルアプリケーションについては、「AWS SDK for Go コード例」を参照してください。

がサポートする AWS IoT CoreAWS SDK for Go サービスのドキュメント

• IoT リファレンスドキュメント

• I oTDataPlane リファレンスドキュメント

• ドキュメントoTJobsDataPlane を参照する

• I oTSecureトンネリングリファレンスドキュメント

Java

AWS SDK for Java をインストールし、それを使用して AWS IoTに接続するには以下のようにします。

1. 「 の開始方法」の手順に従ってください。 AWS SDK for Java 2.x

   次の手順では、次の方法について説明します。

   • にサインアップ AWS してIAMユーザーを作成する

   • のダウンロード SDK

   • AWS 認証情報とリージョンの設定

   • Apache Maven SDKで を使用する

   • Gradle SDKで を使用する

2. AWS SDK for Java 2.x コード例のいずれかを使用してサンプルアプリケーションを作成して実行する

3. SDK API リファレンスドキュメントを確認する

がサポートする AWS IoT CoreAWS SDK for Java サービスのドキュメント

• IotClient リファレンスドキュメント

• IotDataPlaneClient リファレンスドキュメント

• IotJobsDataPlaneClient リファレンスドキュメント

• oTSecureTunnelingClient リファレンスドキュメント

JavaScript

をインストール AWS SDK for JavaScript し、それを使用して に接続するには AWS IoT：

1. 「AWS SDK for JavaScriptの設定」の指示に従います。これらの手順は、ブラウザ AWS SDK for JavaScript での の使用と Node.JS での使用に適用されます。インストールに適用される指示に従ってください。

   次の手順では、次の方法について説明します。

   • 前提条件を確認します。

   • SDK の をインストールする JavaScript

   • SDK の をロードする JavaScript

2. サンプルアプリケーションを作成して実行し、環境の入門オプションSDKの説明に従って の使用を開始します。

   • AWS SDK JavaScript ブラウザ で の の使用を開始する、または

   • AWS SDK JavaScript Node.js で の の使用を開始する

がサポートする AWS IoT CoreAWS SDK for JavaScript サービスのドキュメント

• AWS.Iot reference documentation

• AWS.IotData reference documentation

• AWS.IotJobsDataPlane reference documentation

• AWS.IotSecureTunneling reference documentation

.NET

AWS SDK for .NET をインストールし、それを使用して AWS IoTに接続するには以下のようにします。

1. AWS SDK for .NET 「環境のセットアップ」の指示に従ってください。

2. AWS SDK for .NET 「プロジェクトのセットアップ」の手順に従います。

   次の手順では、次の方法について説明します。

   • 新しいプロジェクトを開始する

   • AWS 認証情報の取得と設定

   • パッケージのインストール AWS SDK

3. のサンプルプログラムのいずれかを作成して実行します。「 の AWS サービスの使用 AWS SDK」を参照してください。NET

4. SDK API リファレンスドキュメントを確認する

がサポートする AWS IoT CoreAWS SDK for .NET サービスのドキュメント

• Amazon.IoT.Model リファレンスドキュメント

• AmazonIotDataモデルリファレンスドキュメント

• Amazon.I oTJobsDataPlane.Model リファレンスドキュメント

• Amazon.I oTSecureTunneling.Model リファレンスドキュメント

PHP

AWS SDK for PHP をインストールし、それを使用して AWS IoTに接続するには以下のようにします。

1. 「 AWS SDK for PHP バージョン 3 の開始方法」の手順に従ってください。

   次の手順では、次の方法について説明します。

   • 前提条件を確認します。

   • のインストール SDK

   • SDK をPHPスクリプトに適用する

2. AWS SDK for PHP Version 3 コード例のいずれかを使用してサンプルアプリケーションを作成して実行する

がサポートする AWS IoT CoreAWS SDK for PHP サービスのドキュメント

• ドキュメントoTClient を参照する

• ドキュメントoTDataPlaneClient を参照する

• ドキュメントoTJobsDataPlaneClient を参照する

• ドキュメントoTSecureTunnelingClient を参照する

Python

AWS SDK for Python (Boto3) をインストールし、それを使用して AWS IoTに接続するには以下のようにします。

1. 「AWS SDK for Python (Boto3) のクイックスタート」の指示に従います、

   次の手順では、次の方法について説明します。

   • のインストール SDK

   • を設定する SDK

   • コードSDKで を使用する

2. AWS SDK for Python (Boto3)を使用するサンプルプログラムを作成し、実行する

   このプログラムは、アカウントの現在設定されているログ記録オプションを表示します。をインストールSDKしてアカウント用に設定したら、このプログラムを実行できるようになります。

   import boto3
   import json
   
   # initialize client
   iot = boto3.client('iot')
   
   # get current logging levels, format them as JSON, and write them to stdout
   response = iot.get_v2_logging_options()
   print(json.dumps(response, indent=4))
   

   この例で使用されている機能の詳細については、AWS IoT ログ記録の設定 を参照してください。

がサポートする AWS IoT CoreAWS SDK for Python (Boto3) サービスのドキュメント

• IoT リファレンスドキュメント

• I oTDataPlane リファレンスドキュメント

• ドキュメントoTJobsDataPlane を参照する

• I oTSecureトンネリングリファレンスドキュメント

Ruby

AWS SDK for Ruby をインストールし、それを使用して AWS IoTに接続するには以下のようにします。

• 「 の開始方法」の手順に従ってください。 AWS SDK for Ruby

  次の手順では、次の方法について説明します。

  • のインストール SDK

  • を設定する SDK

• Hello World チュートリアルを作成して実行する

for Ruby が AWS SDKサポートする AWS IoT Core サービスのドキュメント

• Aws::IoT::Client リファレンスドキュメント

• Aws::I oTDataPlane::Client リファレンスドキュメント

• Aws::I oTJobsDataPlane::Client リファレンスドキュメント

• Aws::I oTSecureトンネリング::Client リファレンスドキュメント

AWS モバイル SDKs

Mobile SDKsは、 AWS APIs AWS IoT Core サービスの 、 を使用した IoT デバイス通信、APIsおよびその他の AWS サービスの に対するプラットフォーム固有のサポートをMQTTモバイルアプリデベロッパーに提供します。

Android

AWS Mobile SDK for Android

には、デベロッパーが を使用して接続されたモバイルアプリケーションを構築するためのライブラリ、サンプル、およびドキュメント AWS Mobile SDK for Android が含まれています AWS。これには、MQTTデバイス通信のサポートと、 AWS IoT Core サービスの APIsの呼び出しSDKも含まれます。詳細については、次を参照してください。

• AWS での Android SDK用モバイル GitHub

• AWS Mobile SDK for Android Readme

• AWS Mobile SDK for Android サンプル

• AWS SDK for Android APIリファレンス

• AWSIoTClient クラスリファレンスドキュメント

iOS

AWS Mobile SDK for iOS

AWS Mobile SDK for iOS はオープンソースのソフトウェア開発キットで、Apache オープンソースライセンスで配布されています。iOS SDK用 には、デベロッパーが を使用して接続されたモバイルアプリケーションを構築するのに役立つライブラリ、コードサンプル、ドキュメントが用意されています AWS。これには、MQTTデバイス通信のサポートと、 AWS IoT Core サービスの APIsの呼び出しSDKも含まれます。詳細については、次を参照してください。

• AWS Mobile SDK for iOS 上の GitHub

• AWS SDK for iOS Readme

• AWS SDK for iOS サンプル

• AWS IoT for iOS の AWS SDKクラスリファレンスドキュメント

REST APIs AWS IoT Core サービスの

REST APIs AWS IoT Core サービスの は、 HTTPリクエストを使用して直接呼び出すことができます。

• エンドポイント URL

  サービスの RESTAPIsを AWS IoT Core 公開するサービスエンドポイントはリージョンごとに異なり、AWS IoT Core 「エンドポイントとクォータ」にリストされています。 AWS IoT リソースはリージョン固有であるため、アクセスする AWS IoT リソースがあるリージョンのエンドポイントを使用する必要があります。

• 認証

  AWS IoT Core サービスの RESTAPIsは認証に認証情報を使用します AWS IAM。詳細については、 AWS 全般のリファレンスのAWS API「リクエストの署名」を参照してください。

• API リファレンス

  AWS IoT Core サービスの によって提供される特定の関数については、RESTAPIs以下を参照してください。

  • API IoT の リファレンス。

  • API IoT データ の リファレンス。

  • API IoT ジョブデータ の リファレンス。

  • API IoT セキュアトンネリング の リファレンス。