實作 AWS.DiscoverDevices 操作

客戶代表最終使用者啟動裝置探索程序。

的受管整合會deviceDiscoveryId針對客戶產生的裝置探索請求 AWS IoT Device Management 產生名為 的 AWS 參考識別符。

的受管整合會使用 AWS.DiscoverDevices操作介面將裝置探索請求 AWS IoT Device Management 傳送至 C2C 連接器，包括accessToken最終使用者的有效 OAuth 以及 deviceDiscoveryId。

您的連接器存放deviceDiscoveryId區要包含在DEVICE_DISCOVERY事件中。此事件也會包含探索到的最終使用者裝置清單，而且必須傳送至 AWS IoT Device Management 的受管整合，並將 SendConnectorEvent API 做為DEVICE_DISCOVERY事件。

您的 C2C 連接器應呼叫資源伺服器，以擷取最終使用者擁有的所有裝置。

您的 C2C 連接器 Lambda 會使用 ACK 回應來回應 Lambda 呼叫 (invokeFunction)，以傳回 AWS IoT Device Management 的受管整合，做為AWS.DiscoverDevices操作的初始回應。受管整合會通知客戶其已啟動裝置探索程序的 ACK。

您的資源伺服器會將最終使用者擁有和操作的裝置清單傳送給您。

連接器會將每個最終使用者裝置轉換為 AWS IoT Device Management 所需裝置格式的受管整合，包括 ConnectorDeviceIdConnectorDeviceName和每個裝置的功能報告。

C2C 連接器也UserId提供探索到的裝置擁有者。視您的資源伺服器實作而定，它可能會在裝置清單或個別呼叫中從您的資源伺服器擷取。

接著，您的 C2C 連接器將使用 AWS 帳戶 登入資料和操作參數設定為 "DEVICE_DISCOVERY"SendConnectorEvent，透過 SigV4 呼叫 AWS IoT Device Management API 的受管整合 。傳送至 AWS IoT Device Management 受管整合之裝置清單中的每個裝置都會以裝置特定參數表示connectorDeviceName，例如 connectorDeviceId、 和 capabilityReport。

1. 根據您的資源伺服器回應，您需要相應地通知 AWS IoT Device Management 的受管整合。

   例如，如果您的資源伺服器對最終使用者探索的裝置清單具有分頁回應，則對於每個輪詢，您可以使用 statusCode 參數 傳送個別DEVICE_DISCOVERY操作事件3xx。如果您的裝置探索仍在進行中，請重複步驟 5、6 和 7。

的受管整合 AWS IoT Device Management 會將發現最終使用者裝置的通知傳送給客戶。

如果您的 C2C 連接器傳送DEVICE_DISCOVERY操作事件，並將 statusCode 參數更新為 200，則受管整合會通知客戶裝置探索工作流程完成。

受管整合會觸發裝置探索：

1. DiscoverDevices 使用下列 JSON 承載將 POST 請求傳送至 ：

   /DiscoverDevices
   {
      "header": {
           "auth": {                 
               "token": "ashriu32yr97feqy7afsaf",  
               "type": "OAuth2.0"
           }
      },
      "payload": {
           "operationName": "AWS.DiscoverDevices",
           "operationVersion": "1.0",
           "connectorId": "Your-Connector-Id",
           "deviceDiscoveryId": "12345678"
      }
   }
   

連接器認可探索：

1. 連接器會傳送包含下列 JSON 回應的確認：

   {
        "header": {
             "responseCode":200
        },
        "payload": {
             "responseMessage": "Discovering devices for discovery-job-id '12345678' with connector-id `Your-Connector-Id`"
        }
   }
   

連接器會傳送裝置探索事件：

1. /connector-event/{your_connector_id} 使用下列 JSON 承載將 POST 請求傳送至 ：

   AWS API - /SendConnectorEvent
   URI – POST /connector-event/{your_connector_id}
   {
      "UserId": "6109342",
      "Operation": "DEVICE_DISCOVERY",
      "OperationVersion": "1.0",
      "StatusCode": 200,
      "DeviceDiscoveryId": "12345678",
      "ConnectorId": "Your_connector_Id",
      "Message": "Device discovery for discovery-job-id '12345678' successful",
      "Devices": [
           {
               "ConnectorDeviceId": "Your_Device_Id_1",
               "ConnectorDeviceName": "Your-Device-Name",
               "CapabilityReport": {
    	      		"nodeId":"1",
    			"version":"1.0.0", 
     			"endpoints":[{
    				"id":"1",
    				"deviceTypes":["Camera"],
    				"clusters":[{
    					"id":"0x0006",
    					"revision":1, 
    					"attributes":[{
    						"id":"0x0000",
    					}],
    					"commands":["0x00","0x01"],
    					"events":["0x00"]
    				}]
    			}]
    		} 
           }
       ]
   }