Networks, devices, and sensors · GraphQL type

SensorRequest type

A standing request to run one Sensor against one Device IP address, optionally on a specific protocol and port, in the SAE or PUBLIC zone. LAN-zone sensors run on endpoints directly and never create requests. The system creates requests automatically when it sees a device, an open port, or a network service that an enabled SensorScope allows a sensor to probe; org admins can also submit or reset one with sensorRequestSubmit or sensorRequestReSubmit, which bypass scopes. Its id is derived from the sensor, zone, device, IP, protocol, port, and args, so the same target always maps to the same request. Each attempt is recorded as a SensorRequestRun; state tracks expiration, completion, and which endpoints completed or were suppressed. Reach requests through Device.sensorRequests, Service.sensorRequests, or sensorRequest.

Fields

Field Name Description
id - ID! A string uniquely identifying this SensorRequest.
device - Device! The Device this sensor request run is found on.
sensor - Sensor! The Sensor this request is for.
zone - SensorZone! The zone this request is for.
ip - IpAddress! The target IP address for this request.
protocol - IpProtocol The IP protocol this request is for.
port - Int The IP port this request is for, an unsigned 16-bit integer.
args - SensorRequestArgs Optional list of key/value arguments to use for the SensorRequest.
created - Time! The time this SensorRequest was created.
state - SensorRequestState! The current state of this SensorRequest.
runIds - [ID!] List of unique identifiers for recent runs of this SensorRequest.

Arguments

count - Int

Maximum number of run IDs to return.
runs - [SensorRequestRun!] List of recent runs of this SensorRequest.

Arguments

count - Int

Maximum number of runs to return.

Returned by

  • sensorRequest query: Retrieves a SensorRequest: a standing request to run one Sensor against one device IP address, and optionally one port, with its expiration and…

Used by

  • Device type: A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as…
  • SensorRequestRun type: The record of one attempt to run a SensorRequest: when it ran, which sensor version ran it, which Endpoint ran it (none for PUBLIC-zone runs, which…
  • Service type: A network service identified on a discovered Device: one protocol (such as HTTP, TLS, SSH, SMB, DNS, SNMP, IPP, mDNS, or UPnP) acting as a client or…
  • SensorRequestPayload type: Payload wrapper for a single SensorRequest result.
  • SensorRequestReRunPayload type: Payload wrapper for a re-run SensorRequest result.
  • SensorRequestSubmitForServicePayload type: Payload wrapper for sensor requests submitted for a service.
  • SensorRequestSubmitPayload type: Payload wrapper for a submitted SensorRequest result.

Related types

  • Device A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as…
  • SensorRequestRun The record of one attempt to run a SensorRequest: when it ran, which sensor version ran it, which Endpoint ran it (none for PUBLIC-zone runs, which…

Example

Example

{
  "id": 4,
  "device": Device,
  "sensor": Sensor,
  "zone": "LAN",
  "ip": IpAddress,
  "protocol": "TCP",
  "port": 987,
  "args": SensorRequestArgs,
  "created": "2021-10-07T18:23:25.829Z",
  "state": SensorRequestState,
  "runIds": ["4"],
  "runs": [SensorRequestRun]
}