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

# デバイスのオンボードと運用のための簡単なセットアップ
<a name="managedintegrations-sdk-v2-cookbook-ss"></a>

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

## 前提条件
<a name="managedintegrations-sdk-v2-cookbook-ss-prereq"></a>

デバイスのオンボードを試みる前に、以下の手順を実行します。
+ ハブデバイスをマネージド統合ハブにオンボードします。
+ Managed Integrations コマンドリファレンス AWS CLI から最新バージョンの をインストールする [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)
+ [DEVICE\$1Life\$1CYCLE](managedintegrations-notifications.md#managedintegrations-notification-setup) イベント通知をサブスクライブします。

**Topics**
+ [前提条件](#managedintegrations-sdk-v2-cookbook-ss-prereq)
+ [ステップ 1: 認証情報ロッカーを作成する](#managedintegrations-sdk-v2-cookbook-credential-locker)
+ [ステップ 2: 認証情報ロッカーをハブに追加する](#managedintegrations-sdk-v2-cookbook-add-to-hub)
+ [ステップ 3: 認証情報を使用してマネージド型モノを作成する。](#managedintegrations-sdk-v2-cookbook-ss-create-managed-thing)
+ [ステップ 4: デバイスをプラグインし、そのステータスを確認します。](#managedintegrations-sdk-v2-cookbook-ss-check-device-status)
+ [ステップ 5: デバイス機能を取得する](#managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities)
+ [ステップ 6: マネージドモノにコマンドを送信する](#managedintegrations-sdk-v2-cookbook-ss-control-device)
+ [ステップ 7: ハブからマネージド型モノを削除する](#managedintegrations-sdk-v2-cookbook-clean-up)

## ステップ 1: 認証情報ロッカーを作成する
<a name="managedintegrations-sdk-v2-cookbook-credential-locker"></a>

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

**認証情報ロッカーを作成するには**
+ `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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-credential-locker.html) コマンド AWS CLI 」を参照してください。 **

## ステップ 2: 認証情報ロッカーをハブに追加する
<a name="managedintegrations-sdk-v2-cookbook-add-to-hub"></a>

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

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

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

## ステップ 3: 認証情報を使用してマネージド型モノを作成する。
<a name="managedintegrations-sdk-v2-cookbook-ss-create-managed-thing"></a>

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

**マネージド型モノを作成するには**
+ `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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html) *コマンド* AWS CLI 」を参照してください。

## ステップ 4: デバイスをプラグインし、そのステータスを確認します。
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-status"></a>

**デバイスをプラグインし、そのステータスを確認します。**
+ `get-managed-thing` コマンドを使用して、デバイスのステータスを確認します。マネージドモノの ProvisioningStatus はアクティブである必要があります。ProvisioningStatus の詳細については、[「デバイスプロビジョニング](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html)」を参照してください。

  **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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html) *コマンド* AWS CLI 」を参照してください。

## ステップ 5: デバイス機能を取得する
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities"></a>

`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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html) AWS CLI 」コマンドを参照してください。 **

## ステップ 6: マネージドモノにコマンドを送信する
<a name="managedintegrations-sdk-v2-cookbook-ss-control-device"></a>

`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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/send-managed-thing-command.html) AWS CLI 」コマンドを参照してください。 **

## ステップ 7: ハブからマネージド型モノを削除する
<a name="managedintegrations-sdk-v2-cookbook-clean-up"></a>

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

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

  **delete-managed-thing 例**

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

  詳細については、「 マネージド統合コマンドリファレンス」の[delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html) コマンド AWS CLI 」を参照してください。 **
**注記**  
デバイスが `DELETE_IN_PROGRESS` 状態でスタックしている場合は、 `--force`フラグを に追加します`delete-managed-thing command`。
**注記**  
Z 波デバイスの場合は、 コマンドの実行後にデバイスをペアリングモードにする必要があります。