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

實作 AWS.DiscoverDevices 操作

裝置探索會將最終使用者擁有的實體裝置清單與 Managed Integrations 中維護的那些最終使用者裝置的數位表示法保持一致 AWS IoT Device Management。它由 AWS 客戶在最終使用者擁有的裝置上執行。對於 OAuth 2.0，這會在帳戶連結完成後發生。對於一般授權，這可能會在建立帳戶關聯之後發生。

裝置探索是一種非同步程序，其中 的 AWS IoT Device Management 受管整合會呼叫連接器來啟動裝置探索請求。C2C 連接器會傳回受管整合針對 產生的參考識別符 （稱為 deviceDiscoveryId)，以非同步方式傳回探索到的最終使用者裝置清單 AWS IoT Device Management。

AWS.DiscoverDevices 工作流程

下圖說明最終使用者與 受管整合之間的裝置探索工作流程 AWS IoT Device Management：

工作流程步驟

裝置探索的 C2C 連接器需求

下列清單概述 C2C 連接器的要求，以促進裝置探索成功：

裝置探索程序

步驟 1：受管整合觸發裝置探索

根據授權類型，DiscoverDevices使用下列其中一個 JSON 承載將 POST 請求傳送至 ：

OAuth 2.0 請求：

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

一般授權請求：

/DiscoverDevices
{
   "header": {
        "auth": {
            "secretsManager": {
                "arn": "string",
                "versionId": "string"
            },
            "type": "GeneralAuthorization"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

一般授權請求：

/DiscoverDevices
{
   "header": {
        "auth": {
            "secretsManager": {
                "arn": "string",
                "versionId": "string"
            },
            "type": "GeneralAuthorization"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

步驟 2：連接器確認探索

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

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

步驟 3：連接器傳送裝置探索事件

/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"]
 				}]
 			}]
 		}
        }
    ]
}

為探索的裝置填入品牌和模型

您的 C2C 連接器可以選擇性地在DEVICE_DISCOVERY事件中包含每個裝置的DeviceMetadata物件，以報告裝置的品牌和模型。這些值接著會在 ListDiscoveredDevices 和 ListManagedThings 回應中傳回。

在每個裝置項目和映射中包含DeviceMetadata物件：

下列範例顯示DeviceMetadata包含 的裝置項目：

{
    "ConnectorDeviceId": "Your_Device_Id_1",
    "ConnectorDeviceName": "Your-Device-Name",
    "CapabilityReport": { ... },
    "DeviceMetadata": {
        "Brand": "ExampleBrand",
        "Model": "ExampleModel-X1"
    }
}

這兩個索引鍵都是區分大小寫的字串。如果您省略 DeviceMetadata、省略個別索引鍵，或提供非字串值，則擷取裝置時無法使用對應的欄位。

為 DISCOVER_DEVICES 事件建構CapabilityReport

如上述定義的事件結構所示，做為 AWS.DiscoverDevices操作回應的 DISCOVER_DEVICES 事件中所報告的每個裝置，都需要 CapbilityReport 來描述對應的裝置功能。`CapabilityReport` 會以符合事項的格式告知 AWS IoT Device Management 裝置功能的受管整合。

CapabilityReport 中的必要欄位

如需支援的 功能及其對應AWS 實作的最新清單，請參閱 Data Model 文件的最新版本。