本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連線至 AWS IoT Core 服務端點
<a name="iot-connect-service"></a>

您可以使用 AWS CLI、您偏好語言的 AWS SDK，或直接呼叫 REST API 來存取**AWS IoT Core - 控制 平面**的功能。我們建議您使用 AWS CLI 或 AWS 開發套件與 互動， AWS IoT Core 因為它們包含呼叫 AWS 服務的最佳實務。直接呼叫 REST API 是一個選項，但您必須提供[必要的安全憑證](https://docs.aws.amazon.com//general/latest/gr/signing_aws_api_requests.html)以便存取 API。

**注意**  
IoT 裝置應使用 [AWS IoT 裝置 SDKs](iot-connect-devices.md#iot-connect-device-sdks)。裝置 SDKs 已針對在裝置上使用進行最佳化、支援與 的 MQTT 通訊 AWS IoT，以及支援裝置最常使用的 AWS IoT APIs。如需裝置軟體開發套件及其提供之功能的詳細資訊，請參閱 [AWS IoT 裝置 SDKs](iot-connect-devices.md#iot-connect-device-sdks)。  
行動裝置應使用 [AWS 行動SDKs](#iot-connect-mobile-sdks)。Mobile SDKs 支援 AWS IoT APIs、MQTT 裝置通訊，以及 AWS 行動裝置上其他服務APIs。如需 Mobile 軟體開發套件及其提供之功能的詳細資訊，請參閱 [AWS 行動SDKs](#iot-connect-mobile-sdks)。

您可以在 Web 和行動應用程式中使用 AWS Amplify 工具和資源，以便更輕鬆地連線 AWS IoT Core。如需使用 Amplify AWS IoT Core 連線至 的詳細資訊，請參閱 Amplify 文件中的 [PubSub](https://docs.amplify.aws/react/build-a-backend/add-aws-services/pubsub/)。

下列各節說明您可以用來開發和與 AWS IoT 和其他 AWS 服務互動SDKs。如需可用於建置和管理應用程式之 AWS 工具和開發套件的完整清單 AWS，請參閱[建置工具 AWS](https://aws.amazon.com/tools/)。

## AWS CLI 適用於 的 AWS IoT Core
<a name="iot-connect-cli"></a>

 AWS CLI 提供 API AWS APIs命令列存取。
+ 

**安裝**  
如需如何安裝 的資訊 AWS CLI，請參閱[安裝 AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/cli-chap-install.html)。
+ 

**身分驗證**  
 AWS CLI 使用來自 的登入資料 AWS 帳戶。
+ 

**參考資料**  
如需 AWS IoT Core 這些服務 AWS CLI 命令的相關資訊，請參閱：
  + [AWS CLI IoT 的命令參考](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html)
  + [AWS CLI IoT 資料的命令參考](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/index.html)
  + [AWS CLI IoT 任務資料的命令參考](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/index.html)
  + [AWS CLI IoT 安全通道的命令參考](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsecuretunneling/index.html)

如需在 PowerShell 指令碼環境中管理 AWS 服務和資源的工具，請參閱 [AWS Tools for PowerShell](https://aws.amazon.com/powershell/)。

## AWS SDKs
<a name="iot-service-sdks"></a>

透過 AWS SDKs，您的應用程式和相容裝置可以呼叫 AWS IoT APIs和其他 APIs。 AWS 本節提供 AWS IoT Core 服務 API 的 AWS SDKs和 APIs 參考文件的連結。

**AWS SDKs 支援這些 AWS IoT Core APIs**
+ [AWS IoT](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT 資料平面](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT 任務資料平面](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT 安全通道](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT 無線](https://docs.aws.amazon.com/iot-wireless/latest/apireference/welcome.html)

------
#### [ C\$1\$1 ]

**若要安裝 [適用於 C\$1\$1 的 AWS SDK](https://aws.amazon.com/sdk-for-cpp/) 並使用它來連接至 AWS IoT：**

1. 遵循[適用於 C\$1\$1 的 AWS 開發套件入門](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started.html)中的指示

   這些指示說明如何：
   + 從來源檔案安裝和建置軟體開發套件
   + 提供憑證以搭配您的 AWS 帳戶使用軟體開發套件
   + 在您的應用程式或服務中初始化和關閉軟體開發套件
   + 建立一個 CMake 專案來建置應用程式或服務

1. 建立並執行範例應用程式。如需使用適用於 C\$1\$1 的 AWS SDK 的範例應用程式，請參閱 [適用於 C\$1\$1 的 AWS SDK 程式碼範例](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/programming-services.html)。

**適用於 C\$1\$1 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [AWS::IoTClient" 參考文件](https://sdk.amazonaws.com/cpp/api/LATEST/root/html/index.html)
+ [Aws::IoTDataPlane::IoTDataPlaneClient 參考文件](http://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_io_t_data_plane_1_1_io_t_data_plane_client.html)
+ [Aws::IoTJobsDataPlane::IoTJobsDataPlaneClient 參考文件](http://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_io_t_jobs_data_plane_1_1_io_t_jobs_data_plane_client.html)
+ [Aws::IoTSecureTunneling::IoTSecureTunnelingClient 參考文件](http://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_io_t_secure_tunneling_1_1_io_t_secure_tunneling_client.html)

------
#### [ Go ]

**若要安裝 [適用於 Go 的 AWS SDK](https://aws.amazon.com/sdk-for-go/) 並使用它來連接至 AWS IoT：**

1. 遵循 [入門 適用於 Go 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/setting-up.html)中的指示

   這些指示說明如何：
   + 安裝 適用於 Go 的 AWS SDK
   + 取得軟體開發套件的存取金鑰以存取您的 AWS 帳戶
   + 將套件匯入我們應用程式或服務的原始程式碼

1. 建立並執行範例應用程式。如需使用 適用於 Go 的 AWS SDK的範例應用程式，請參閱 [適用於 Go 的 AWS SDK 程式碼範例](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/common-examples.html)。

**適用於 Go 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [物聯網參考文件](https://docs.aws.amazon.com/sdk-for-go/api/service/iot/)
+ [IoTDataPlane 參考文件](https://docs.aws.amazon.com/sdk-for-go/api/service/iotdataplane/)
+ [IoTJobsDataPlane 參考文件](https://docs.aws.amazon.com/sdk-for-go/api/service/iotjobsdataplane/)
+ [IoTSecureTunneling 參考文件](https://docs.aws.amazon.com/sdk-for-go/api/service/iotsecuretunneling/)

------
#### [ Java ]

**若要安裝 [適用於 Java 的 AWS SDK](https://aws.amazon.com/sdk-for-java/) 並使用它來連接至 AWS IoT：**

1. 遵循 [入門 AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/getting-started.html)中的指示

   這些指示說明如何：
   + 註冊 AWS 並建立 IAM 使用者
   + 下載軟體開發套件 
   + 設定 AWS 登入資料和區域 
   + 使用軟體開發套件搭配 Apache Maven 
   + 使用軟體開發套件搭配 Gradle 

1. 使用其中一個 [AWS SDK for Java 2.x 程式碼範例](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/advanced-topics.html)來建立和執行範例應用程式。

1. 檢閱[軟體開發套件 API 參考文件](https://sdk.amazonaws.com/java/api/latest/)

**適用於 Java 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [IotClient 參考文件](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iot/IotClient.html)
+ [IotDataPlaneClient 參考文件](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iotdataplane/IotDataPlaneClient.html)
+ [IotJobsDataPlaneClient 參考文件](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iotjobsdataplane/IotJobsDataPlaneClient.html)
+ [IoTSecureTunnelingClient 參考文件](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iotsecuretunneling/IoTSecureTunnelingClient.html)

------
#### [ JavaScript ]

**若要安裝 適用於 JavaScript 的 AWS SDK 並使用它來連線至 AWS IoT：**

1. 遵循[設定 適用於 JavaScript 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-up.html) 中的指示。這些指示適用於在瀏覽器 適用於 JavaScript 的 AWS SDK 中使用 和搭配 Node.JS 使用 。請確定您遵循適用於安裝的指示。

   這些指示說明如何：
   + 查看先決條件
   + 安裝適用於 JavaScript 的軟體開發套件
   + 載入適用於 JavaScript 的軟體開發套件

1. 建立並執行範例應用程式，以開始使用軟體開發套件，如您環境的入門選項所描述。
   + 開始使用[瀏覽器中適用於 JavaScript 的AWS SDK](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/getting-started-browser.html)，或
   + 開始使用 [Node.js 中適用於 JavaScript 的AWS SDK](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/getting-started-nodejs.html)

**適用於 JavaScript 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Iot.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Iot.html)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IotData.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IotData.html)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTJobsDataPlane.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTJobsDataPlane.html)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTSecureTunneling.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTSecureTunneling.html)

------
#### [ .NET ]

**若要安裝 [適用於 .NET 的 AWS SDK](https://aws.amazon.com/sdk-for-net/) 並使用它來連接至 AWS IoT：**

1. 遵循[設定 適用於 .NET 的 AWS SDK 環境](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html)中的指示

1. 遵循[設定 適用於 .NET 的 AWS SDK 專案](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-config.html)中的指示

   這些指示說明如何：
   + 啟動新的專案
   + 取得和設定 AWS 登入資料
   + 安裝 AWS SDK 套件

1. 在[適用於 .NET 的 AWS SDK 中使用 AWS 服務](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/tutorials-examples.html)中建立並執行其中一個範例程式

1. 檢閱[軟體開發套件 API 參考文件](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html)

**適用於 .NET 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [Amazon.IoT.Model 參考文件](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/NIoTModel.html)
+ [Amazon.IotData.Model 參考文件](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IotData/NIotDataModel.html)
+ [Amazon.IoTJobsDataPlane.Model 參考文件](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoTJobsDataPlane/NIoTJobsDataPlaneModel.html)
+ [Amazon.IoTSecureTunneling.Model 參考文件](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoTSecureTunneling/NIoTSecureTunnelingModel.html)

------
#### [ PHP ]

**若要安裝 [適用於 PHP 的 AWS SDK](https://aws.amazon.com/sdk-for-php/) 並使用它來連接至 AWS IoT：**

1. 遵循 [第 3 適用於 PHP 的 AWS SDK 版入門](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/getting-started_index.html)中的指示

   這些指示說明如何：
   + 查看先決條件
   + 安裝軟體開發套件
   + 將軟體開發套件套用於 PHP 指令碼

1. 使用其中一個[適用於 PHP 的 AWS SDK 第 3 版程式碼範例](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/examples_index.html)來建立和執行範例應用程式

**適用於 PHP 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [IoTClient 參考文件](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.Iot.IotClient.html)
+ [IoTDataPlaneClient 參考文件](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.IotDataPlane.IotDataPlaneClient.html)
+ [IoTJobsDataPlaneClient 參考文件](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.IoTJobsDataPlane.IoTJobsDataPlaneClient.html)
+ [IoTSecureTunnelingClient 參考文件](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.IoTSecureTunneling.IoTSecureTunnelingClient.html)

------
#### [ Python ]

**若要安裝 [適用於 Python (Boto3) 的 AWS SDK](https://aws.amazon.com/sdk-for-python/) 並使用它來連接至 AWS IoT：**

1. 按照[適用於 Python (Boto3) 的 AWS SDK 快速入門](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html)中的指示操作

   這些指示說明如何：
   + 安裝軟體開發套件
   + 設定軟體開發套件
   + 在您的程式碼中使用軟體開發套件

1. 建立並執行使用 適用於 Python (Boto3) 的 AWS 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 記錄](configure-logging.md)。

**適用於 Python (Boto3) 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [物聯網參考文件](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iot.html)
+ [IoTDataPlane 參考文件](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iot-data.html)
+ [IoTJobsDataPlane 參考文件](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iot-jobs-data.html)
+ [IoTSecureTunneling 參考文件](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iotsecuretunneling.html)

------
#### [ Ruby ]

**若要安裝 [適用於 Ruby 的 AWS SDK](https://aws.amazon.com/sdk-for-ruby/) 並使用它來連接至 AWS IoT：**
+ 遵循 [入門 適用於 Ruby 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/getting-started.html)中的指示

  這些指示說明如何：
  + 安裝軟體開發套件
  + 設定軟體開發套件
+ 建立和執行 [Hello World 教學課程](https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/hello.html)

**適用於 Ruby 的 AWS SDK 支援的 AWS IoT Core 服務文件**
+ [Aws::IoT::Client 參考文件](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoT/Client.html)
+ [Aws::IoTDataPlane::Client 參考文件](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTDataPlane/Client.html)
+ [Aws::IoTJobsDataPlane::Client 參考文件](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTJobsDataPlane/Client.html)
+ [Aws::IoTSecureTunneling::Client 參考文件](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTSecureTunneling/Client.html)

------

## AWS 行動SDKs
<a name="iot-connect-mobile-sdks"></a>

 AWS Mobile SDKs 為行動應用程式開發人員平台特定的 AWS IoT Core 服務 APIs、使用 MQTT 的 IoT 裝置通訊，以及其他 AWS 服務的 APIs 提供支援。

------
#### [ Android ]

**適用於 Android 的 AWS Mobile SDK**

 適用於 Android 的 AWS Mobile SDK 包含程式庫、範例和文件，供開發人員使用 建置連線的行動應用程式 AWS。此 SDK 也包含對 MQTT 裝置通訊和呼叫 AWS IoT Core 服務的 APIs的支援。如需詳細資訊，請參閱下列內容：
+ [GitHub 上適用於 Android 的AWS Mobile SDK](https://github.com/aws/aws-sdk-android)
+ [AWS 適用於 Android 的 Mobile SDK 讀我檔案](https://github.com/aws-amplify/aws-sdk-android/blob/main/README.md#aws-sdk-for-android)
+ [AWS 適用於 Android 的 Mobile SDK 範例](https://github.com/awslabs/aws-sdk-android-samples#aws-sdk-for-android-samples)
+ [AWS 適用於 Android 的 SDK API 參考](https://aws-amplify.github.io/aws-sdk-android/docs/reference/)
+ [AWSIoTClient 類別參考文件](https://aws-amplify.github.io/aws-sdk-android/docs/reference/com/amazonaws/services/iot/AWSIotClient.html)

------
#### [ iOS ]

**AWS Mobile SDK for iOS**

 AWS Mobile SDK for iOS 是開放原始碼軟體開發套件，根據 Apache Open Source 授權分佈。適用於 iOS 的 SDK 提供程式庫、程式碼範例和文件，協助開發人員使用 建置連線的行動應用程式 AWS。此 SDK 也包含對 MQTT 裝置通訊和呼叫 AWS IoT Core 服務的 APIs的支援。如需詳細資訊，請參閱下列內容：
+ [AWS Mobile SDK for iOS 在 GitHub 上](https://github.com/aws/aws-sdk-ios)
+ [AWS 適用於 iOS 的 SDK 讀我檔案](https://github.com/aws-amplify/aws-sdk-ios/blob/main/README.md#aws-sdk-for-ios)
+ [AWS 適用於 iOS 的 SDK 範例](https://github.com/awslabs/aws-sdk-ios-samples#the-aws-sdk-for-ios-samples)
+ [AWS IoT 適用於 iOS 的 AWS SDK 中的類別參考文件](https://aws-amplify.github.io/aws-sdk-ios/docs/reference/AWSIoT/index.html)

------

## AWS IoT Core 服務的 REST APIs
<a name="iot-connect-rest"></a>

您可以使用 HTTP 請求直接呼叫 AWS IoT Core 服務的 REST APIs。
+ 

**端點 URL**  
公開 AWS IoT Core 服務之 REST API 的服務端點會因區域而有所不同，並列於 [AWS IoT Core 端點和配額](https://docs.aws.amazon.com//general/latest/gr/iot-core.html)中。您必須針對具有您要存取之 AWS IoT 資源的區域使用端點，因為 AWS IoT 資源是區域特定的。
+ 

**身分驗證**  
 AWS IoT Core 服務的 REST APIs 使用 AWS IAM 登入資料進行身分驗證。如需詳細資訊，請參閱《 AWS 一般參考》中的[簽署 AWS API 請求](https://docs.aws.amazon.com//general/latest/gr/signing_aws_api_requests.html)。
+ 

**API 參考**  
如需 AWS IoT Core 服務 REST APIs 提供的特定函數的相關資訊，請參閱：
  + [適用於 IoT 的 API 參考](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT.html)。
  + [適用於 IoT 資料的 API 參考](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT_Data_Plane.html)。
  + [適用於 IoT 任務資料的 API 參考](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT_Jobs_Data_Plane.html)。
  + [適用於 IoT 安全通道的 API 參考](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT_Secure_Tunneling.html)。