Menerapkan AWS. DiscoverDevices operasi

Pelanggan memulai proses penemuan perangkat atas nama pengguna akhir.

Integrasi terkelola untuk AWS IoT Device Management menghasilkan pengenal referensi yang dipanggil deviceDiscoveryId untuk permintaan penemuan perangkat yang dihasilkan oleh Pelanggan. AWS

Integrasi terkelola untuk AWS IoT Device Management mengirimkan permintaan penemuan perangkat ke konektor C2C menggunakan antarmuka AWS.DiscoverDevices operasi, termasuk pengguna OAuth accessToken akhir yang valid dan juga. deviceDiscoveryId

Konektor Anda menyimpan deviceDiscoveryId untuk dimasukkan dalam DEVICE_DISCOVERY acara tersebut. Acara ini juga akan berisi daftar perangkat pengguna akhir yang ditemukan, dan harus dikirim ke integrasi terkelola untuk AWS IoT Device Management dengan SendConnectorEvent API sebagai DEVICE_DISCOVERY acara.

Konektor C2C Anda harus memanggil server sumber daya untuk mengambil semua perangkat yang dimiliki oleh pengguna akhir.

Konektor C2C Anda Lambda merespons pemanggilan Lambda invokeFunction () dengan respons ACK kembali ke integrasi terkelola untuk AWS IoT Device Management, yang bertindak sebagai respons awal untuk operasi. AWS.DiscoverDevices Integrasi terkelola memberi tahu pelanggan dengan ACK ke proses penemuan perangkat yang dimulai.

Server sumber daya Anda mengirimi Anda daftar perangkat yang dimiliki dan dioperasikan oleh pengguna akhir.

Konektor Anda mengonversi setiap perangkat pengguna akhir menjadi integrasi terkelola untuk format perangkat yang diperlukan AWS IoT Device Management, termasukConnectorDeviceId, ConnectorDeviceName dan laporan Kemampuan untuk setiap perangkat.

Konektor C2C juga menyediakan UserId pemilik perangkat yang ditemukan. Ini dapat diambil dari server sumber daya Anda baik sebagai bagian dari daftar perangkat atau dalam panggilan terpisah tergantung pada implementasi server sumber daya Anda.

Selanjutnya, konektor C2C Anda akan memanggil integrasi terkelola untuk AWS IoT Device Management APISendConnectorEvent, melalui SigV4 Akun AWS menggunakan kredensil dan dengan parameter operasi ditetapkan sebagai “DEVICE_DISCOVERY”. Setiap perangkat dalam daftar perangkat yang dikirim ke integrasi terkelola untuk AWS IoT Device Management akan diwakili oleh parameter khusus perangkat seperticonnectorDeviceId,, dan file. connectorDeviceName capabilityReport

1. Berdasarkan respons server sumber daya Anda, Anda perlu memberi tahu integrasi terkelola untuk AWS IoT Device Management.

   Misalnya, jika server sumber daya Anda memiliki respons paginasi ke daftar perangkat yang ditemukan untuk pengguna akhir, maka untuk setiap jajak pendapat Anda dapat mengirim peristiwa DEVICE_DISCOVERY operasi individual, dengan statusCode parameter. 3xx Jika penemuan perangkat Anda masih dalam proses, ulangi langkah 5, 6, dan 7.

Integrasi terkelola untuk AWS IoT Device Management mengirimkan pemberitahuan kepada pelanggan tentang menemukan perangkat pengguna akhir.

Jika konektor C2C Anda mengirimkan peristiwa DEVICE_DISCOVERY operasi dengan statusCode parameter diperbarui dengan nilai 200, maka integrasi terkelola akan memberi tahu pelanggan tentang penyelesaian alur kerja penemuan perangkat.

Integrasi terkelola memicu penemuan perangkat:

1. Kirim permintaan POST ke DiscoverDevices dengan muatan JSON berikut:

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

Konektor mengakui penemuan:

1. Konektor mengirimkan pengakuan dengan respons JSON berikut:

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

Konektor mengirimkan Acara Penemuan Perangkat:

1. Kirim permintaan POST ke /connector-event/{your_connector_id} dengan muatan JSON berikut:

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