# 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 IoT Wireless を含めた AWS 内のすべてのサービスに自動的にサインアップされます。料金は、使用するサービスの料金のみが請求されます。
AWS IoT Wireless をセットアップするには、次のセクションのステップを実行します。
**Topics**
+ [AWS アカウントのセットアップ](#iotwireless-setup-account)
+ [Python および AWS CLI のインストール](#wireless-onboard-prereq)
## AWS アカウントのセットアップ
Amazon Sidewalk に AWS IoT Core for LoRaWAN または 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 ユーザーの作成
管理者ユーザーを作成するには、以下のいずれかのオプションを選択します。
****
| 管理者を管理する方法を 1 つ選択します | 目的 | 方法 | 以下の操作も可能 |
| --- | --- | --- | --- |
| IAM Identity Center 内 (推奨) | 短期の認証情報を使用して AWS にアクセスします。これはセキュリティのベストプラクティスと一致しています。ベストプラクティスの詳細については、IAM ユーザーガイドの「[IAM でのセキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)」を参照してください。 | 「AWS IAM アイデンティティセンター ユーザーガイド」の「[開始方法](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)」の手順に従います。 | 「AWS Command Line Interface ユーザーガイド」の「[AWS IAM アイデンティティセンター を使用するための AWS CLI の設定](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 ドキュメント」の「[Hardware Development Kit (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 もインストールされます。その後、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 エンドデバイスを AWS IoT Core for Amazon Sidewalk にプログラム的にオンボードできます。AWS IoT コンソールを使用してデバイスをオンボードする場合は、このセクションを省略できます。[AWS IoT Core コンソール](https://console.aws.amazon.com/iot/home#/)を開いて次のセクションに進み、デバイスの AWS IoT Core for Amazon Sidewalk への接続を開始してください。AWS CLI の設定方法については、「[AWS CLI のインストールと設定](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。
1.
**boto3 (AWS SDK for Python) のインストール**
次のコマンドは、boto3 (AWS SDK for Python) と AWS CLI のインストール方法を示しています。boto3 を実行するために必要な botocore もインストールする必要があります。詳細な手順については、「Boto3 ドキュメントガイド」の「[Boto3 のインストール](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation)」を参照してください。
**注記**
`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 コールを承認します。設定手順については、以下を参照してください。
+ 「[設定](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration)」(Boto3 ドキュメントガイド)
+ 「[設定ファイルと認証情報ファイルの設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)」(AWS CLI ドキュメントガイド)
# 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 リソースの名前のサポート**
| リソース | 名前フィールドのサポート |
| --- | --- |
| 送信先 | Name はリソースの一意の ID であり、変更できません。 |
| ワイヤレスデバイス | Name はオプションのリソースの記述子であり、変更できます。 |
| LoRaWAN ゲートウェイ | Name はオプションのリソースの記述子であり、変更できます。 |
| プロフィール | Name はオプションのリソースの記述子であり、変更できます。 |
名前フィールドは、リソースのリソースハブリストに表示されます。ただし、スペースは限られているため、名前の最初の 15～30 文字しか表示されない場合があります。リソースの名前を選択するときは、それらがどのようにリソースを識別するようにしたいか、コンソールでどのように表示されるかを考慮します。
**説明**
送信先、デバイス、およびゲートウェイの各リソースは、最大 2,048 文字を入力できる説明フィールドもサポートします。説明フィールドは、個々のリソースの詳細ページにのみ表示されます。説明フィールドはリソースの詳細ページにのみ表示されるため、多くの情報を保持できますが、複数のリソースのコンテキストでスキャンするには不便です。
## リソースタグ
**AWS IoT Wireless リソースの AWS タグのサポート**
| リソース | AWS タグのサポート |
| --- | --- |
| 送信先 | 最大 50 個の AWS タグをリソースに追加できます。 |
| ワイヤレスデバイス | このリソースは AWS タグをサポートしていません。 |
| LoRaWAN ゲートウェイ | 最大 50 個の AWS タグをリソースに追加できます。 |
| プロフィール | 最大 50 個の AWS タグをリソースに追加できます。 |
タグは、AWS リソースを特定し、整理するのに使用できる単語または語句であり、メタデータとして機能します。タグキーは情報のカテゴリと考えることができ、タグ値はそのカテゴリの特定の値と考えることができます。例えば、*色*のタグ値があり、一部のリソースにそのタグ用に*青*の値を与え、他のリソースに*赤*の値を与えることができます。これで、AWS コンソールの[タグエディタ](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)を使用して、*青*の*色*タグ値を持つリソースを見つけることができます。
AWS IoT Wireless でのタグ付けの詳細については、「[AWS IoT Wireless リソースのタグ付け](tagging-iotwireless.md)」を参照してください。
タグ付けおよびタグ付け戦略の詳細については、[タグエディタ](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)を参照してください。