/api/space/device-management/acknowledge-device-fingerprint

The following operation is supported on this resource:

• POST - Acknowledge Device Fingerprint Rest API

POST /acknowledge-device-fingerprint

Version 2

This API will perform the following operations:

1. Acknowledge the specified fingerprint value - Blindly accepted the fingerprint from the device on first connection or reconnection.
2. Resolve the fingerprint conflict - Mismatch between fingerprint stored in database and in device.

This API is only supported for device with authentication status of:

• Credentials Based – Unverified
• Key Based – Unverified
• Key Conflict – Unverified
• Fingerprint Conflict
.

Sample Usage

This API makes an asynchronous method call; so, you can optionally specify queue and schedule parameters:

POST /acknowledge-device-fingerprint?queue=<queue>&schedule=<schedule>




Note: The queue URL denoted by <queue> must have been created already.



• Parameters:
  

  Name	Type	URI Type	Description	Required
  queue	Queue URL	Query	A fully qualified queue URL, where job progress notifications will be sent (See Asynchronous API Usage)	N
  schedule	cron-like-expression	Query	Schedule this API in the future, by specifying a cron-like-expression (See Job Scheduling)	N

• Content-Type Headers:
  application/vnd.net.juniper.space.device-management.acknowledge-device-fingerprint-request+xml;version=2;charset=UTF-8
  application/vnd.net.juniper.space.device-management.acknowledge-device-fingerprint-request+json;version=2;charset=UTF-8


• Accept Headers:
  application/vnd.net.juniper.space.job-management.task+xml;version=1
  application/vnd.net.juniper.space.job-management.task+json;version=1


• XML
• JSON
Sample Input XML:
<acknowledge-device-fingerprint-request>
     <acknowledge-devices>
           <acknowledge-device>
               <device href="/api/space/device-management/devices/2228241"/>
               <fingerprint>15:88:53:a6:b1:97:85:68:4c:11:9d:b8:2a:8a:0f:b7</fingerprint>
           </acknowledge-device>
     </acknowledge-devices>
</acknowledge-device-fingerprint-request>


Sample Output XML:
<task href="/api/space/job-management/jobs/1081350">
  <id>1081350</id>
</task>



Sample Input JSON:
{
   "acknowledge-device-fingerprint-request" : {
     "acknowledge-devices" : [
       {
         "acknowledge-device" : {
           "device" : {
             "@href" : "/api/space/device-management/devices/2228241"
           } ,
           "fingerprint" : "15:88:53:a6:b1:97:85:68:4c:11:9d:b8:2a:8a:0f:b7"
         }
       }
     ]
   }
}


Sample Output JSON:
{
  "task":{
    "@href":"/api/space/job-management/jobs/1081350",
    "id":1081350
  }
}




Access Control

The following capabilities are required to access this API: AcknowledgeDeviceFingerprint