使用使用者引導式設定來加入和操作裝置

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

先決條件

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

將中樞裝置加入受管整合中樞。
AWS CLI 從 Managed Integrations AWS CLI 命令參考安裝最新版本的
訂閱 DEVICE_DISCOVERY-STATUS 事件通知。

使用者引導的設定步驟

先決條件：在 Z Wave 裝置上啟用配對模式
步驟 1：開始裝置探索
步驟 2：查詢探索任務 ID
步驟 3：為您的裝置建立受管物件
步驟 4：查詢受管物件
步驟 5：取得受管物件功能
步驟 6：將命令傳送至受管物件
步驟 7：檢查受管物件狀態
步驟 8：從您的中樞移除受管物件

先決條件：在 Z Wave 裝置上啟用配對模式

在 Z 波裝置上啟用配對模式。配對模式會因每個 Z-Wave 裝置而異，因此請參閱裝置的說明以正確設定配對模式。它通常是使用者必須按下的按鈕。

步驟 1：開始裝置探索

為您的中樞啟動裝置探索，以取得用於加入裝置的探索任務 ID。

啟動裝置探索

使用 start-device-discovery 命令來取得探索任務 ID。

start-device-discovery 範例


#For Zigbee
  aws iot-managed-integrations start-device-discovery --discovery-type ZIGBEE \
  --controller-identifier HUB_MANAGED_THING_ID
  
  #For Zwave
  aws iot-managed-integrations start-device-discovery --discovery-type ZWAVE \
  --controller-identifier HUB_MANAGED_THING \
  --authentication-material-type ZWAVE_INSTALL_CODE \
  --authentication-material 13333
  
  #For Cloud
  aws iot-managed-integrations start-device-discovery --discovery-type CLOUD \
  --account-association-id C2C_ASSOCIATION_ID \
  
  #For Custom
  aws iot-managed-thing start-device-discovery --discovery-type CUSTOM \
  --controller-identifier HUB_MANAGED_THING_ID \
  --custom-protocol-detail NAME : NON_EMPTY_STRING \

回應：


{
      "Id": DISCOVERY_JOB_ID,
      "StartedAt": "2025-06-03T14:43:12.726000-07:00"
  }

注意

Z-wave 和 Zigbee 裝置有不同的命令。

如需詳細資訊，請參閱受管 integrations AWS CLI Command Reference 中的 start-device-discovery API。

步驟 2：查詢探索任務 ID

使用 list-discovered-devices命令來取得裝置的身分驗證資料。

查詢您的探索任務 ID

使用探索任務 ID 搭配 list-discovered-devices 命令，以取得裝置的身分驗證資料。
```
aws iot-managed-integrations list-discovered-devices --identifier DISCOVERY_JOB_ID
```

回應：


"Items": [
    {
        "DeviceTypes": [],
        "DiscoveredAt": "2025-06-03T14:43:37.619000-07:00",
        "AuthenticationMaterial": AUTHENTICATION_MATERIAL
    }
]

步驟 3：為您的裝置建立受管物件

使用 create-managed-thing命令為您的裝置建立受管物件。每個裝置都需要自己的受管物件。

建立受管物件

使用 create-managed-thing命令為您的裝置建立受管物件。

create-managed-thing 範例


aws iot-managed-integrations create-managed-thing \
  --role  DEVICE --authentication-material-type DISCOVERED_DEVICE \
  --authentication-material "AUTHENTICATION_MATERIAL"

回應：


{    
    "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命令來檢查受管物件的佈建狀態是否設定為 ACTIVATED。

get-managed-thing 範例


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/DEVICE_MANAGED_THING_ID,
      "Role": "DEVICE",
      "ProvisioningStatus": "ACTIVATED",
      "MacAddress": "MAC_ADDRESS",
      "ParentControllerId": "PARENT_CONTROLLER_ID",
      "CreatedAt": "2025-06-03T14:46:35.149000-07:00",
      "UpdatedAt": "2025-06-03T14:46:37.500000-07:00",
      "Tags": {}
  }

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

步驟 5：取得受管物件功能

您可以使用檢視受管物件的可用動作清單get-managed-thing-capabiltiies。

取得裝置的功能

使用 get-managed-thing-capabilities命令來取得端點 ID。另請注意可能的動作清單。

get-managed-thing-capabilities 範例


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

回應：


{
      "ManagedThingId": "DEVICE_MANAGED_THING_ID",
      "CapabilityReport": {
          "version": "1.0.0",
          "nodeId": "zb.539D+4A1D",
          "endpoints": [
              {
                  "id": "1",
                  "deviceTypes": [
                      "Unknown Device"
                  ],
                  "capabilities": [
                      {
                          "id": "matter.OnOff@1.4",
                          "name": "On/Off",
                          "version": "6",
                          "properties": [
                              "OnOff",
                              "OnOff",
                              "OnTime",
                              "OffWaitTime"
                          ],
                          "actions": [
                              "Off",
                              "On",
                              "Toggle",
                              "OffWithEffect",
                              "OnWithRecallGlobalScene",
                              "OnWithTimedOff"
                          ],
                          ...
  }

如需詳細資訊，請參閱受管整合命令參考中的 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：檢查受管物件狀態

檢查受管物件的狀態，以驗證切換動作是否成功。

檢查受管物件的裝置狀態

使用 get-managed-thing-state命令來驗證切換動作是否成功。

get-managed-thing-state 範例



  aws iot-managed-integrations get-managed-thing-state --managed-thing-id DEVICE_MANAGED_THING_ID

回應：


{
      "Endpoints": [
          {
              "endpointId": "1",
              "capabilities": [
                  {
                      "id": "matter.OnOff@1.4",
                      "name": "On/Off",
                      "version": "1.4",
                      "properties": [
                          {
                              "name": "OnOff",
                              "value": {
                                  "propertyValue": true,
                                  "lastChangedAt": "2025-06-03T21:50:39.886Z"
                              }
                          }
                      ]
                  }
              ]
          }
      ]
  }

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

步驟 8：從您的中樞移除受管物件

移除受管物件以清除您的中樞。

刪除受管物件

使用 delete-managed-thing 命令移除受管物件。

delete-managed-thing 範例
```
aws iot-managed-integrations delete-managed-thing \
  --identifier MANAGED_THING_ID
```
如需詳細資訊，請參閱受管整合命令參考中的 delete-managed-thing AWS CLI 命令。

注意
如果裝置卡在 DELETE_IN_PROGRESS 狀態，請將 --force旗標附加至 delete-managed-thing命令。

注意
對於 Z-wave 裝置，您需要在執行命令之後，讓裝置進入配對模式。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

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

自訂憑證處理常式