本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 輕鬆設定以加入和操作裝置透過建立受管物件並將其連接到您的中樞，將裝置設定為加入受管整合中樞。本節說明使用簡單設定完成裝置加入程序的步驟。 ## 先決條件在嘗試加入裝置之前，請先完成以下步驟： + 將中樞裝置加入受管整合中樞。 + AWS CLI 從 [Managed Integrations AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)安裝最新版本的 + 訂閱 [DEVICE\_LIFE\_CYCLE](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：建立登入資料儲存庫為您的裝置建立登入資料儲存庫。 **建立登入資料儲存庫** + 使用 `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：將登入資料儲存庫新增至您的中樞將登入資料儲存貯體新增至您的中樞。 **將登入資料儲存貯體新增至您的中樞** + 使用下列命令將登入資料儲存庫新增至您的中樞。 ``` 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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html) AWS CLI 命令。 ** ## 步驟 4：插入裝置並檢查其狀態。 **插入裝置並檢查其狀態。** + 使用 `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：取得裝置功能使用 `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：將命令傳送至受管物件使用 `send-managed-thing-command`命令將切換動作命令傳送至您的受管物件。 **將命令傳送至受管物件** + 使用 `send-managed-thing-command`命令將命令傳送至您的受管物件。 **send-managed-thing-command 範例** ``` json=$(jq -cr '.|@json') < 移除受管物件以清除您的中樞。 **刪除受管物件** + 使用 `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-wave 裝置，您需要在執行命令之後，讓裝置進入配對模式。