デバイスのオンボードと運用のための簡単なセットアップ - のマネージド統合 AWS IoT Device Management
前提条件

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

デバイスのオンボードと運用のための簡単なセットアップ

マネージド型モノを作成してハブに接続することで、マネージド型統合ハブにデバイスをオンボードするようにセットアップします。このセクションでは、シンプルなセットアップを使用してデバイスのオンボーディングプロセスを完了する手順について説明します。

前提条件

デバイスのオンボードを試みる前に、以下の手順を実行します。

  • ハブデバイスをマネージド統合ハブにオンボードします。

  • Managed Integrations コマンドリファレンス AWS CLI から最新バージョンの をインストールする AWS CLI

  • DEVICE_Life_CYCLE イベント通知をサブスクライブします。

ステップ 1: 認証情報ロッカーを作成する

デバイスの認証情報ロッカーを作成します。

認証情報ロッカーを作成するには

  • create-credential-locker コマンドを使用します。このコマンドを実行すると、Wi-Fi セットアップキーペアとデバイス証明書を含むすべての製造リソースの作成がトリガーされます。

    create-credential-locker 例

    aws iot-managed-integrations create-credential-locker \
  --name "DEVICE_NAME"

    レスポンス:

    {    
  "Id": "LOCKER_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:credential-locker/LOCKER_ID
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    詳細については、「 マネージド統合コマンドリファレンス」のcreate-credential-locker コマンド AWS CLI 」を参照してください。

ステップ 2: 認証情報ロッカーをハブに追加する

認証情報ロッカーをハブに追加します。

認証情報ロッカーをハブに追加するには

  • 次のコマンドを使用して、認証情報ロッカーをハブに追加します。

    aws iotmi --region AWS_REGION --endpoint AWS_ENDPOINT update-managed-thing \
--identifier "HUB_MANAGED_THING_ID" --credential-locker-id "LOCKER_ID"

ステップ 3: 認証情報を使用してマネージド型モノを作成する。

デバイスの認証情報を使用してマネージド型モノを作成します。各デバイスには、独自のマネージド型モノが必要です。

マネージド型モノを作成するには

  • create-managed-thing コマンドを使用して、デバイスのマネージド型モノを作成します。

    create-managed-thing 例

    #ZWAVE: 
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material '900137947003133...' \ #auth material from zwave qr code
--authentication-material-type ZWAVE_QR_BAR_CODE \
--credential-locker-id ${locker_id}

#ZIGBEE:
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code
--authentication-material-type ZIGBEE_QR_BAR_CODE \
--credential-locker-id ${locker_id}
    注記

    Z ウェーブデバイスと Zigbee デバイスには個別のコマンドがあります。

    レスポンス:

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/DEVICE_MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    詳細については、create-managed-thing コマンド AWS CLI 」を参照してください。

ステップ 4: デバイスをプラグインし、そのステータスを確認します。

デバイスをプラグインし、そのステータスを確認します。

  • get-managed-thing コマンドを使用して、デバイスのステータスを確認します。

    get-managed-thing 例

    #KINESIS NOTIFICATION:
{
    "version": "1.0.0",
    "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx",
    "messageType": "DEVICE_LIFE_CYCLE",
    "source": "aws.iotmanagedintegrations",
    "customerAccountId": "12345678901",
    "timestamp": "2025-06-10T05:30:59.852659650Z",
    "region": "us-east-1",
    "resources": ["XXX"],
    "payload": {
        "deviceDetails": {
            "id": "1e84f61fa79a41219534b6fd57052XXX",
            "arn": "XXX",
            "createdAt": "2025-06-09T06:24:34.336120179Z",
            "updatedAt": "2025-06-10T05:30:59.784157019Z"
        },
        "status": "ACTIVATED"
    }
}
aws iot-managed-integrations get-managed-thing \
--identifier :"DEVICE_MANAGED_THING_ID"

    レスポンス:

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    詳細については、get-managed-thing コマンド AWS CLI 」を参照してください。

ステップ 5: デバイス機能を取得する

get-managed-thing-capabilities コマンドを使用してエンドポイント ID を取得し、デバイスに対して可能なアクションのリストを表示します。

デバイスの機能を取得するには

  • get-managed-thing-capabilities コマンドを使用して、エンドポイント ID を書き留めます。

    get-managed-thing-capabilties 例

    aws iotmi get-managed-thing-capabilities \
--identifier "DEVICE_MANAGED_THING_ID"

    レスポンス:

    {    
    "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc",
    "CapabilityReport": {
        "version": "1.0.0",
        "nodeId": "zw.FCB10009+06",
        "endpoints": [
            {
                "id": "ENDPOINT_ID"
                "deviceTypes": [
                    "On/Off Switch"
                ],
                "capabilities": [
                    {
                        "id": "matter.OnOff@1.4",
                        "name": "On/Off",
                        "version": "6",
                        "properties": [
                            "OnOff"
                        ],
                        "actions": [
                            "Off",
                            "On"
                        ],
                        "events": []
                    }
                    ...
}

    詳細については、「 マネージド統合コマンドリファレンス」のget-managed-thing-capabilities AWS CLI 」コマンドを参照してください。

ステップ 6: マネージドモノにコマンドを送信する

send-managed-thing-command コマンドを使用して、管理対象モノにトグルアクションコマンドを送信します。

マネージドモノにコマンドを送信するには

  • send-managed-thing-command コマンドを使用して、マネージドモノにコマンドを送信します。

    send-managed-thing-command 例

    json=$(jq -cr '.|@json') <<EOF
[
  {
    "endpointId": "1",
    "capabilities": [
      {
        "id": "matter.OnOff@1.4",
        "name": "On/Off",
        "version": "1",
        "actions": [
          {
            "name": "Toggle",
            "parameters": {}
          }
        ]
      }
    ]
  }
]
EOF
aws iot-managed-integrations send-managed-thing-command \
--managed-thing-id "DEVICE_MANAGED_THING_ID" --endpoints "ENDPOINT_ID"
    注記

    この例では、jq cli を に使用しますが、endpointId文字列全体を渡すこともできます。

    レスポンス:

    {    
"TraceId": "TRACE_ID"
}

    詳細については、「 マネージド統合コマンドリファレンス」のsend-managed-thing-command AWS CLI 」コマンドを参照してください。

ステップ 7: ハブからマネージド型モノを削除する

マネージドモノを削除してハブをクリーンアップします。

マネージドモノを削除するには

  • delete-managed-thing コマンドを使用して、デバイスハブからマネージドモノを削除します。

    delete-managed-thing 例

    aws iot-managed-integrations delete-managed-thing \
--identifier "DEVICE_MANAGED_THING_ID"

    詳細については、「 マネージド統合コマンドリファレンス」のdelete-managed-thing コマンド AWS CLI 」を参照してください。

    注記

    デバイスが DELETE_IN_PROGRESS 状態でスタックしている場合は、 --forceフラグを に追加しますdelete-managed-thing command。

    注記

    Z 波デバイスの場合は、 コマンドの実行後にデバイスをペアリングモードにする必要があります。