使用簡單的設定來加入和操作裝置 - 的受管整合 AWS IoT Device Management
先決條件

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用簡單的設定來加入和操作裝置

透過建立受管物件並將其連接到您的中樞，將裝置設定為加入受管整合中樞。本節說明使用簡單設定完成裝置加入程序的步驟。

先決條件

在嘗試加入裝置之前，請完成以下步驟：

步驟 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-wave 和 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"
}

    如需詳細資訊，請參閱 受管整合 AWS CLI 命令參考中的 send-managed-thing-command 命令。

步驟 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-wave 裝置，您需要在執行 命令之後，讓裝置進入配對模式。