Fortinet black logo

Administration Guide

Profiled devices

Copy Link
Copy Doc ID 8bec453a-b242-11e9-a989-00505692583a:170465
Download PDF

Profiled devices

Retrieve profiled devices.

https://<servername>:8443/api/deviceprofiler/profiled

Return value

Type

Description

deviceType

String

The type of the device determined by the profiling rule.

id

Long

The record ID

ipAddress

String

Primary IP address

ipAddresses

String

Alternate IP addresses

location

String

Location

macAddress

String

MAC address

name

String

Host name

role

String

Role

rule

Matched Device Profiling Rule

Example request

curl -k -u 'username:password' -H "accept: application/xml" -X GET https://localhost:8443/api/deviceprofiler/profiled?macAddress=08:00:27:2F:27:00

Example XML format

<profiledDevicesSearchResult>

<status>success</status>

<limit>25</limit>

<nextOffset>1</nextOffset>

<offset>0</offset>

<total>1</total>

<profiledDevices>

<profiledDevice>

<deviceType>Registered Host</deviceType>

<id>3602</id>

<ipAddress>192.168.35.55</ipAddress>

<ipAddresses>192.168.35.55 (IPv4)</ipAddresses>

<location>Dell-3324 Port 15</location>

<macAddress>08:00:27:2F:27:00</macAddress>

<name>Win7QA</name>

<role>NAC-Default</role>

<rule>

<id>2</id>

<name>Windows (DHCP)</name>

</rule>

</profiledDevice>

</profiledDevices>

</profiledDevicesSearchResult>

Profiled devices

Retrieve profiled devices.

https://<servername>:8443/api/deviceprofiler/profiled

Return value

Type

Description

deviceType

String

The type of the device determined by the profiling rule.

id

Long

The record ID

ipAddress

String

Primary IP address

ipAddresses

String

Alternate IP addresses

location

String

Location

macAddress

String

MAC address

name

String

Host name

role

String

Role

rule

Matched Device Profiling Rule

Example request

curl -k -u 'username:password' -H "accept: application/xml" -X GET https://localhost:8443/api/deviceprofiler/profiled?macAddress=08:00:27:2F:27:00

Example XML format

<profiledDevicesSearchResult>

<status>success</status>

<limit>25</limit>

<nextOffset>1</nextOffset>

<offset>0</offset>

<total>1</total>

<profiledDevices>

<profiledDevice>

<deviceType>Registered Host</deviceType>

<id>3602</id>

<ipAddress>192.168.35.55</ipAddress>

<ipAddresses>192.168.35.55 (IPv4)</ipAddresses>

<location>Dell-3324 Port 15</location>

<macAddress>08:00:27:2F:27:00</macAddress>

<name>Win7QA</name>

<role>NAC-Default</role>

<rule>

<id>2</id>

<name>Windows (DHCP)</name>

</rule>

</profiledDevice>

</profiledDevices>

</profiledDevicesSearchResult>