Retrieves a Device by its graph object id: an unmanaged device, such as a printer, camera, phone, or IoT appliance, that managed endpoints see on the network. Devices are discovered from neighbor tables, mDNS, SSDP, DHCP, and port scans, then fingerprinted by type, manufacturer, and model. A device links to the networks it was seen on, its open ports and services, and the positions where it was observed. An Endpoint lists the devices it reached through devicesSeen; find them across the organization with graphSearch on the DEVICE object type. Returns a not-found error when no object has the id, and an error when the id belongs to another object type.
Response
Returns a DevicePayload!
Arguments
| Name | Description |
|---|---|
id - ID!
|
The Device identifier. |
mockOptions - MockDataInput
|
Options for mock data generation. Options supported: none. |
Example
Query
query device(
$id: ID!,
$mockOptions: MockDataInput
) {
device(
id: $id,
mockOptions: $mockOptions
) {
node {
id
orgId
objectType
objectTypeLabel
displayName
firstSeen
lastSeen
seen {
...SeenOnlineFragment
}
createdAt
updatedAt
snapshotInfo {
...GraphObjectSnapshotInfoFragment
}
mac
ipNetworks {
...DeviceIpNetworkFragment
}
natIps {
...DeviceNatIpFragment
}
ip {
...IpAddressFragment
}
ips {
...IpAddressFragment
}
hostname
allHostnames {
...DeviceHostnameFragment
}
isGateway
type
fingerprints {
...DeviceFingerprintFragment
}
portsSummary {
...DeviceOpenPortsFragment
}
arpTableEntries {
...ArpTableEntryConnectionFragment
}
endpoints {
...EndpointConnectionFragment
}
gatewayForNetworks {
...NetworkConnectionFragment
}
lastPosition {
...PositionSeenFragment
}
manufacturer {
...DeviceManufacturerFragment
}
model {
...DeviceModelFragment
}
networks {
...NetworkConnectionFragment
}
ports {
...OpenPortConnectionFragment
}
positions {
...PositionSeenConnectionFragment
}
primaryPosition {
...PositionSeenFragment
}
seenNetworkPrefixes {
...NetworkPrefixConnectionFragment
}
services {
...ServiceConnectionFragment
}
sensorRequestIds
sensorRequests {
...SensorRequestFragment
}
sensorRequestRunIds
sensorRequestRuns {
...SensorRequestRunFragment
}
findings {
...FindingsPayloadFragment
}
issues {
...IssuesPayloadFragment
}
issuesSummary {
...IssuesSummaryFragment
}
}
}
}
Variables
{"id": 4, "mockOptions": MockDataInput}
Response
{"data": {"device": {"node": Device}}}