# 开始使用 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 账户
首次使用 适用于 LoRaWAN 的 AWS IoT Core 或适用于 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 用户
要创建管理员用户，请选择以下选项之一。
****
| 选择一种方法来管理您的管理员 | 目的 | 方式 | 您也可以 |
| --- | --- | --- | --- |
| 在 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 用户指南》中的[管理 IAM 用户的访问密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)，配置编程式访问。 |
### 作为 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。在这种情况下，请在运行命令时将 `python` 的所有实例替换为 `python3`。如果仍然出现错误，请下载并运行 [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（AWS SDK for Python）。在执行这些步骤之前，您必须先注册 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 SDK）**
以下命令向您展示如何安装 boto3（适用于 Python 的 AWS SDK）和 AWS CLI。您还安装 botocore，这是运行 boto3 所必需的。有关详细说明，请参阅《Boto3 文档指南》[https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation)中的*安装 Boto3*。
**注意**
`awscli` 版本 `1.26.6` 要求 PyYAML 版本为 3.10 或更高版本，但不得高于 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 个字符。为资源选择名称时，请考虑您希望它们如何识别资源以及如何在控制台中显示。
**描述**
目标、设备和网关资源还支持描述字段，该字段最多可接受 2048 个字符。描述字段仅显示在单个资源的详细信息页面中。虽然描述字段可以保存大量信息，但由于它只显示在资源的详细信息页面中，因此在多个资源的上下文中扫描并不方便。
## 资源标签
**对 AWS 标签的 AWS IoT Wireless 资源支持**
| 资源 | AWS 标签支持 |
| --- | --- |
| 目标 | 可向资源中最多添加 50 个 AWS 标签。 |
| 无线设备 | 此资源不支持 AWS 标签。 |
| LoRaWAN 网关 | 可向资源中最多添加 50 个 AWS 标签。 |
| 配置文件 | 可向资源中最多添加 50 个 AWS 标签。 |
标签是可作为元数据标识和组织 AWS 资源的词或短语。您可以将标签键视为信息类别，将标签值视为该类别中的特定值。例如，您的标记值可能为 *color*，然后对于一些资源的这个标签，您可以给予 *blue* 值，对于其他资源，则给予 *red* 值。有了这个，您可以使用AWS控制台中的 [Tag Editor](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)。