Implementa AWS. DiscoverDevices operazione

Il cliente avvia il processo di scoperta del dispositivo per conto dell'utente finale.

Le integrazioni gestite per la AWS IoT Device Management generazione di un identificatore di riferimento richiesto deviceDiscoveryId per la richiesta di rilevamento del dispositivo generata dal Cliente. AWS

Integrazioni gestite per l' AWS IoT Device Management invio di una richiesta di rilevamento del dispositivo al connettore C2C utilizzando l'interfaccia AWS.DiscoverDevices operativa, inclusa una richiesta valida per OAuth accessToken l'utente finale e la. deviceDiscoveryId

Gli archivi del connettore deviceDiscoveryId devono essere inclusi nell'evento. DEVICE_DISCOVERY Questo evento conterrà anche un elenco dei dispositivi degli utenti finali scoperti e dovrà essere inviato alle integrazioni gestite per AWS IoT Device Management con l'SendConnectorEventAPI come DEVICE_DISCOVERY evento.

Il connettore C2C chiamerà il server di risorse per recuperare tutti i dispositivi di proprietà dell'utente finale.

Il connettore C2C Lambda risponde all'invocazione Lambda invokeFunction () con la risposta ACK alle integrazioni gestite per AWS IoT Device Management, fungendo da risposta iniziale per l'operazione. AWS.DiscoverDevices Managed Integrations notifica al cliente con un ACK il processo di scoperta dei dispositivi avviato.

Il server di risorse ti invia un elenco di dispositivi posseduti e gestiti dall'utente finale.

Il connettore converte ogni dispositivo dell'utente finale nelle integrazioni gestite per il formato del dispositivo richiesto da AWS IoT Device ManagementConnectorDeviceId, ConnectorDeviceName incluso un report sulle capacità per ogni dispositivo.

Il connettore C2C fornisce anche informazioni sul proprietario UserId dei dispositivi rilevati. Può essere recuperato dal server di risorse come parte dell'elenco dei dispositivi o in una chiamata separata a seconda dell'implementazione del server di risorse.

Successivamente, il connettore C2C chiamerà le integrazioni gestite per l'API AWS IoT Device ManagementSendConnectorEvent, tramite SigV4 utilizzando Account AWS credenziali e con il parametro operativo impostato come «DEVICE_DISCOVERY». Ogni dispositivo nell'elenco dei dispositivi inviati alle integrazioni gestite per AWS IoT Device Management sarà rappresentato da parametri specifici del dispositivo comeconnectorDeviceId, connectorDeviceName e a. capabilityReport

1. In base alla risposta del tuo server di risorse, devi notificare di conseguenza le integrazioni gestite per AWS IoT Device Management.

   Ad esempio, se il tuo server di risorse riceve una risposta in pagine all'elenco dei dispositivi rilevati per un utente finale, per ogni sondaggio puoi inviare un singolo evento DEVICE_DISCOVERY operativo, con un parametro di. statusCode 3xx Se il rilevamento dei dispositivi è ancora in corso, ripeti i passaggi 5, 6 e 7.

Managed Integrations for AWS IoT Device Management invia una notifica al cliente in merito alla scoperta dei dispositivi dell'utente finale.

Se il connettore C2C invia un evento DEVICE_DISCOVERY operativo con il statusCode parametro aggiornato con un valore di 200, le integrazioni gestite notificheranno al cliente il completamento del flusso di lavoro di individuazione dei dispositivi.

Le integrazioni gestite attivano il rilevamento dei dispositivi:

1. Invia una richiesta POST a DiscoverDevices con il seguente payload JSON:

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

Il connettore conferma la scoperta:

1. Il connettore invia una conferma con la seguente risposta JSON:

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

Il connettore invia l'evento Device Discovery:

1. Invia una richiesta POST a /connector-event/{your_connector_id} con il seguente payload JSON:

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