# AWS IoT Wireless 入門
透過註冊 AWS 帳戶 並按照步驟建立 IAM 使用者，即可開始使用 AWS IoT Wireless。註冊完成後，您就可以使用 AWS 管理主控台、AWS IoT Wireless API 或 AWS CLI 加入 Sidewalk 和 LoRaWAN 裝置及閘道。加入裝置時，請考慮如何描述和標記資源，以協助您更輕鬆地識別這些資源。
下列主題說明如何開始使用 AWS IoT Wireless。
**Topics**
+ [設定 AWS IoT Wireless](setting-up-iotwireless.md)
+ [描述您的 AWS IoT Wireless 資源](iotwireless-describe-resources.md)
# 設定 AWS IoT Wireless
註冊 AWS 時，您的 AWS 帳戶 帳戶會自動註冊 AWS 中的所有服務，包括 AWS IoT Wireless。您只需支付實際使用服務的費用。
請執行下節中的步驟來設定 AWS IoT Wireless：
**Topics**
+ [設定您的 AWS 帳戶](#iotwireless-setup-account)
+ [安裝 Python 和 AWS CLI](#wireless-onboard-prereq)
## 設定您的 AWS 帳戶
首次使用 AWS IoT Core for LoRaWAN 或適用於 Amazon Sidewalk 的 AWS IoT Core 之前，請先完成下列任務來設定您的 AWS 帳戶：
**Topics**
+ [註冊 AWS 帳戶。](#aws-sign-up-iotwireless)
+ [建立 IAM 使用者](#create-iam-user-iotwireless)
+ [以 IAM 使用者身分登入](#sign-in-iam-user-iotwireless)
### 註冊 AWS 帳戶。
如果您還沒有 AWS 帳戶，請完成以下步驟建立新帳戶。
**註冊 AWS 帳戶**
1. 開啟 [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)。
1. 請遵循線上指示進行。
部分註冊程序需接收來電，並在電話鍵盤輸入驗證碼。
註冊 AWS 帳戶時，會建立 *AWS 帳戶根使用者*。根使用者有權存取該帳戶中的所有 AWS 服務和資源。作為最佳安全實務，[將管理存取權指派給管理使用者](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)，並且僅使用根使用者來執行[需要根使用者存取權的任務](https://docs.aws.amazon.com/accounts/latest/reference/root-user-tasks.html)。
### 建立 IAM 使用者
若要建立管理員使用者，請選擇下列其中一個選項。
****
| 選擇一種管理管理員的方式 | 到 | By | 您也可以 |
| --- | --- | --- | --- |
| 在 IAM Identity Center (建議) | 使用短期憑證存取 AWS。這與安全性最佳實務一致。有關最佳實務的資訊，請參閱 *IAM 使用者指南*中的 [IAM 安全最佳實務](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)。 | 請遵循 AWS IAM Identity Center 使用者指南的[入門](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)中的說明。 | 請參閱 AWS Command Line Interface 使用者指南中的[設定 AWS CLI 以使用 AWS IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) 設定程式設計存取。 |
| 在 IAM 中 (不建議使用) | 使用長期憑證存取 AWS。 | 請遵循 IAM 使用者指南中[建立您的第一個 IAM 管理員使用者和使用者群組](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html)的說明。 | 請參閱 [IAM 使用者指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)中的管理 IAM 使用者的存取金鑰，設定程式設計存取。 |
### 以 IAM 使用者身分登入
建立 IAM 使用者後，您可以使用 IAM 使用者名稱和密碼登入 AWS。
以 IAM 使用者身分登入之前，您可以在 IAM 主控台中驗證 IAM 使用者的登入連結。在 IAM 儀表板的「IAM 使用者登入連結」下，您可以看到 AWS 帳戶 的登入連結。您登入連結的 URL 包含 AWS 帳戶 ID，不含破折號 (-)。
如果您不希望登入連結的 URL 包含 AWS 帳戶 ID，則可以建立帳戶別名。如需詳細資訊，請參閱*《IAM 使用者指南》*中的[建立、刪除和列出 AWS 帳戶 別名](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#CreateAccountAlias)。
**以 IAM 使用者身分登入**
1. 登出 AWS 管理主控台。
1. 輸入您的登入連結，包括您的 AWS 帳戶 ID (但不包括破折號) 或您的 AWS 帳戶 別名。
```
https://aws_account_id_or_alias.signin.aws.amazon.com/console
```
1. 輸入您剛才建立的 IAM 使用者名稱和密碼。
登入時，導覽列會顯示*「your\$1user\$1name @ your\$1aws\$1account\$1id」*。
## 安裝 Python 和 AWS CLI
在您連線 LoRaWAN 或 Sidewalk 終端裝置之前，必須先安裝 Python 並設定 AWS CLI。
**重要**
若要執行佈建和註冊 Sidewalk 終端裝置的完整加入工作流程，您還必須設定 Sidewalk 閘道和 HDK。如需指示，請參閱《Amazon Sidewalk 文件》**中的[設定硬體開發套件 (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) 和[設定 Sidewalk 閘道](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html)。
**Topics**
+ [安裝 Python 和 Python3-pip](#wireless-prereq-python)
+ [設定 AWS CLI](#wireless-prereq-cli)
### 安裝 Python 和 Python3-pip
若要如下一節所述使用 AWS CLI 和 boto3，您必須使用 Python 3.6 或更新版本。如果您想使用 AWS IoT 主控台加入終端裝置，您可以略過本節並繼續設定 AWS 帳戶。要檢查您是否已經安裝了 Python 和 Python3-pip，請執行以下命令。如果執行這些命令傳回版本，這表示已正確安裝 Python 和 Python3-pip。
```
python3 -V
pip3 --version
```
如果此命令傳回錯誤，原因可能是沒有安裝 Python，或您的作業系統呼叫 Python v3.x 可執行檔作為 Python3。在這種情況下，在執行命令時請以 `python3` 取代 `python` 的所有執行個體。如果仍然產生錯誤，請下載並執行 [Python 安裝程式](https://www.python.org/downloads/)，或根據您的作業系統安裝 Python，如下所述。
------
#### [ Windows ]
在您的 Windows 電腦上，從 [Python 網站](https://www.python.org/downloads/windows/)下載 Python 然後執行安裝程式，在您的電腦上安裝 Python。
------
#### [ Linux ]
在 Ubuntu 機器上，執行下列 `sudo` 命令來安裝 Python。
```
sudo apt install python3
sudo apt install python3-pip
```
------
#### [ macOS ]
在你的 Mac 機器上，使用 Homebrew 來安裝 Python。Homebrew 也會安裝 pip，然後指向已安裝的 Python3 版本。
```
$ brew install python
```
------
### 設定 AWS CLI
以下步驟說明如何設定 AWS CLI 和 boto3 (適用於 Python 的 AWS SDK)。您必須先註冊 AWS 帳戶 並建立管理使用者，然後再依照這些步驟進行。如需指示，請參閱 [設定 AWS IoT Wireless](#setting-up-iotwireless)。
1.
**安裝及設定 AWS CLI**
您可以使用 AWS CLI，以程式設計方式將您的 Sidewalk 終端裝置加入適用於 Amazon Sidewalk 的 AWS IoT Core。如果您想使用 AWS IoT 主控台來加入裝置，可以跳過本節。開啟 [AWS IoT Core 主控台](https://console.aws.amazon.com/iot/home#/)，然後繼續下一節，開始將裝置連接到適用於 Amazon Sidewalk 的 AWS IoT Core。如需有關設定 AWS CLI 的指示，請參閱[安裝和設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。
1.
**安裝 boto3 (適用於 Python 的 AWS 開發套件)**
下列命令顯示如何安裝 boto3 (適用於 Python 的 AWS 開發套件) 和 AWS CLI。您也會安裝 botocore，這是執行 boto3 所需的。如需詳細說明，請參閱《Boto3 文件指南》**中的[安裝 Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation)。
**注意**
`awscli` 版本 `1.26.6` 需要 3.10 或更高版本的 PyYAML 版本，但不得高於 5.5。
```
python3 -m pip install botocore-version-py3-none-any.whl
python3 -m pip install boto3-version-py3-none-any.whl
```
1.
**設定您的憑證和預設區域**
在 `~/.aws/credentials` 和 `~/.aws/config` 檔案中設定您的憑證和預設區域。boto3 程式庫使用這些憑證來識別您的 AWS 帳戶 並授權 API 呼叫。如需組態指示，請參閱：
+ 《Boto3 文件指南》**中的[組態](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration)
+ 《AWS CLI 文件指南》**中的[組態和憑證檔案設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
# 描述您的 AWS IoT Wireless 資源
在您開始加入 LoRaWAN 或 Sidewalk 裝置之前，請考慮裝置、閘道和目的地的命名慣例。AWS IoT Wireless 會提供數個選項來協助您識別您建立的資源。如果在建立 AWS IoT Wireless 資源時給與唯一 ID，則此 ID 不具描述性，也不能在建立資源之後加以變更。您也可以指派名稱、新增描述，以及將標籤和標籤值連接至大部分的 AWS IoT Wireless 資源，讓您更方便選取、識別和管理您的資源。
+
**[資源名稱和描述](#wireless-describe-resource-names)**
對於裝置、閘道和設定檔，資源名稱是選用欄位，您可以在建立資源之後變更此欄位。名稱會出現在資源中樞頁面上顯示的清單中。
對於目的地，您會提供在 AWS 帳戶和 AWS 區域 中唯一的名稱。在建立目的地資源之後，您無法修改目的地名稱。
雖然名稱最多可有 256 個字元，但資源中樞中的顯示空間是有限的。如果可能，請確定名稱的區別部分出現在前 20 到 30 個字元中。
+
**[資源標籤](#wireless-describe-resource-tags)**
標籤是可以附加至 AWS 資源的中繼資料的鍵值對。您可以同時選擇標籤鍵及其對應值。
閘道、目的地和設定檔最多可有 50 個標籤附加至其中。裝置不支援標籤。
## 資源名稱和描述
**名稱的 AWS IoT Wireless 資源支援**
| 資源 | 名稱欄位支援 |
| --- | --- |
| 目的地 | 名稱是資源的唯一 ID，無法變更。 |
| 無線裝置 | 名稱是資源的選用描述項，可以變更。 |
| LoRaWAN 閘道 | 名稱是資源的選用描述項，可以變更。 |
| 設定檔 | 名稱是資源的選用描述項，可以變更。 |
名稱欄位會出現在資源中樞清單中；不過，空間有限，因此只能看見名稱的前 15-30 個字元。選取資源的名稱時，請考慮您想要它們如何識別資源，以及它們在主控台中的顯示方式。
**描述**
目的地、裝置和閘道資源也支援描述欄位，此欄位最多可接受 2,048 個字元。描述欄位只會出現在個別資源的詳細資料頁面中。儘管描述欄位可以保存大量資訊，但因為它只會出現在資源的詳細資料頁面中，所以在多個資源的內容中進行掃描並不方便。
## 資源標籤
**AWS 標籤的 AWS IoT Wireless 資源支援**
| 資源 | AWS 標籤支援 |
| --- | --- |
| 目的地 | 最多 50 個 AWS 標籤可以新增至資源。 |
| 無線裝置 | 此資源不支援 AWS 標籤。 |
| LoRaWAN 閘道 | 最多 50 個 AWS 標籤可以新增至資源。 |
| 設定檔 | 最多 50 個 AWS 標籤可以新增至資源。 |
標籤是充當中繼資料的字組或詞組，您可以用來辨識和組織 AWS 資源。您可以將標籤鍵視為資訊類別，並將標籤值視為該類別中的特定值。例如，您可能有一個標籤值 *color*，然後為一些資源提供該標籤值 *blue*，以及為其他資源提供標籤值 *red*。透過此方式，您可以使用 AWS 主控台中的[標籤編輯器](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)，來尋找 *color* 標籤值為 *blue* 的資源。
如需 AWS IoT Wireless 中進行標記的相關資訊，請參閱 [標記您的 AWS IoT Wireless 資源](tagging-iotwireless.md)。
如需關於標記和標記策略的詳細資訊，請參閱[標籤編輯器](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)。