AWS.DiscoverDevices オペレーションを実装する

お客様は、エンドユーザーに代わってデバイス検出プロセスを開始します。

のマネージド統合は、お客様が生成 AWS したデバイス検出リクエストdeviceDiscoveryIdに という参照識別子 AWS IoT Device Management を生成します。

のマネージド統合は、エンドユーザーaccessTokenの有効な OAuth と を含む AWS.DiscoverDevicesオペレーションインターフェイスを使用して、C2C コネクタにデバイス検出リクエスト AWS IoT Device Management を送信しますdeviceDiscoveryId。

コネクタは、 DEVICE_DISCOVERY イベントに含まれる deviceDiscoveryId を保存します。このイベントには、検出されたエンドユーザーのデバイスのリストも含まれ、DEVICE_DISCOVERYイベントとして SendConnectorEvent API を使用して AWS IoT Device Management のマネージド統合に送信する必要があります。

C2C コネクタはリソースサーバーを呼び出して、エンドユーザーが所有するすべてのデバイスを取得します。

C2C コネクタ Lambda は Lambda 呼び出し (invokeFunction) に応答し、ACK 応答を AWS IoT Device Management のマネージド統合に返し、AWS.DiscoverDevicesオペレーションの初期応答として機能します。マネージド統合は、開始されたデバイス検出プロセスに ACK で顧客に通知します。

リソースサーバーは、エンドユーザーが所有および運用するデバイスのリストを送信します。

コネクタは、各エンドユーザーデバイスを、 を含む AWS IoT Device Management に必要なデバイス形式のマネージド統合ConnectorDeviceId、ConnectorDeviceNameおよび各デバイスの機能レポートに変換します。

C2C コネクタは、検出されたデバイスの所有者もUserId提供します。デバイスリストの一部として、またはリソースサーバーの実装に応じて別の呼び出しで、リソースサーバーから取得できます。

次に、C2C コネクタは認証情報を使用し、オペレーションパラメータを「DEVICE_DISCOVERY」に設定 AWS アカウント してSendConnectorEvent、SigV4 経由で AWS IoT Device Management API のマネージド統合 を呼び出します。AWS IoT Device Management のマネージド統合に送信されるデバイスのリスト内の各デバイスは、connectorDeviceId、connectorDeviceName、 などのデバイス固有のパラメータで表されますcapabilityReport。

1. リソースサーバーのレスポンスに基づいて、AWS IoT Device Management のマネージド統合を適宜通知する必要があります。

   たとえば、リソースサーバーがエンドユーザーの検出されたデバイスのリストにページ分割されたレスポンスを持っている場合、ポーリングごとに statusCodeパラメータを にして、個々のDEVICE_DISCOVERYオペレーションイベントを送信できます3xx。デバイス検出がまだ進行中の場合は、ステップ 5、6、7 を繰り返します。

のマネージド統合は、 がエンドユーザーのデバイスを検出したことに関する通知を顧客 AWS IoT Device Management に送信します。

C2C コネクタが値 200 で更新された statusCodeパラメータでDEVICE_DISCOVERYオペレーションイベントを送信すると、マネージド統合はデバイス検出ワークフローの完了をお客様に通知します。

マネージド統合は、デバイス検出をトリガーします。

1. 次の JSON ペイロードDiscoverDevicesを使用して POST リクエストを に送信します。

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

Connector は検出を承認します。

1. コネクタは、次の JSON レスポンスを含む確認を送信します。

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

コネクタは Device Discovery Event を送信します。

1. 次の JSON ペイロード/connector-event/{your_connector_id}を使用して 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"]
    				}]
    			}]
    		} 
           }
       ]
   }