前提条件
IoTへの権限
AWS IoTに対してフル権限があること。
AWS CLI
以下のバージョンで動作確認済
- AWS CLI 1.11.14
コマンド
aws --version
結果(例)
aws-cli/1.11.14 Python/2.7.10 Darwin/15.6.0 botocore/1.4.71
バージョンが古い場合は最新版に更新しましょう。
コマンド
sudo -H pip install -U awscli
- 準備
=======
0.1. リージョンの決定
変数の設定
export AWS_DEFAULT_REGION='ap-northeast-1'
0.2. 変数の確認
プロファイルが想定のものになっていることを確認します。
変数の確認
aws configure list
結果(例)
Name Value Type Location
---- ----- ---- --------
profile iotFull-handson-mbpr13 env AWS_DEFAULT_PROFILE
access_key ****************XXXX shared-credentials-file
secret_key ****************XXXX shared-credentials-file
region ap-northeast-1 env AWS_DEFAULT_REGION
- 事前作業
===========
1.1. モノ名の決定
変数の設定
IOT_THING_NAME="handson-thing-$( date '+%Y%m%d' )" \
&& echo ${IOT_THING_NAME}
同名のモノの不存在確認
コマンド
aws iot describe-thing \
--thing-name ${IOT_THING_NAME}
結果(例)
An error occurred (ResourceNotFoundException) when calling the DescribeThing operation: Failed to describe thing handson-thing-20161117 because it does not exist in our ecosystem for your account
- モノの作成
=============
変数の確認
cat << ETX
IOT_THING_NAME: ${IOT_THING_NAME}
ETX
コマンド
aws iot create-thing \
--thing-name ${IOT_THING_NAME}
結果(例)
{
"thingArn": "arn:aws:iot:ap-northeast-1:XXXXXXXXXXXX:thing/handson-thing-20161117",
"thingName": "handson-thing-20161117"
}
- 事後作業
===========
3.1. モノの確認
コマンド
aws iot describe-thing \
--thing-name ${IOT_THING_NAME}
結果(例)
{
"attributes": {},
"version": 1,
"thingName": "handson-thing-20161117",
"defaultClientId": "handson-thing-20161117"
}
3.2. エンドポイントの確認
コマンド
IOT_ENDPOINT=$( \
aws iot describe-endpoint \
--query 'endpointAddress' \
--output text \
) \
&& echo ${IOT_ENDPOINT}
結果(例)
xxxxxxxxxxxxxx.iot.ap-northeast-1.amazonaws.com
エンドポイント情報は後で使用するのでメモしておいてください。