fleet_status_devices

Creates, updates, deletes, gets or lists a fleet_status_devices resource.

Overview

Name	fleet_status_devices
Type	Resource
Id	cloudflare.zero_trust.fleet_status_devices

Fields

The following fields are returned by SELECT queries:

list

List devices response

Name	Datatype	Description
alwaysOn	boolean
batteryCharging	boolean
batteryCycles	integer (int64)
batteryPct	number (float)
colo	string	Cloudflare colo (example: SJC)
connectionType	string
cpuPct	number (float)
cpuPctByApp	array
deviceId	string	Device identifier (UUID v4)
deviceIpv4	object
deviceIpv6	object
deviceName	string	Device identifier (human readable)
diskReadBps	integer (int64)
diskUsagePct	number (float)
diskWriteBps	integer (int64)
dohSubdomain	string
estimatedLossPct	number (float)
firewallEnabled	boolean
gatewayIpv4	object
gatewayIpv6	object
handshakeLatencyMs	number (int64)
ispIpv4	object
ispIpv6	object
metal	string
mode	string	The mode under which the WARP client is run (example: proxy)
networkRcvdBps	integer (int64)
networkSentBps	integer (int64)
networkSsid	string
personEmail	string	User contact email address
platform	string	Operating system (example: windows)
ramAvailableKb	integer (int64)
ramUsedPct	number (float)
ramUsedPctByApp	array
registrationId	string	Device registration identifier (UUID v4). On multi-user devices, this uniquely identifies a user's registration on the device.
status	string	Network status (example: connected)
switchLocked	boolean
timestamp	string	Timestamp in ISO format (example: 2023-10-11T00:00:00Z)
version	string	WARP client version (example: 1.0.0)
wifiStrengthDbm	integer (int64)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	account_id	to, from, page, per_page, sort_by, colo, device_id, mode, status, platform, version, source	List details for devices using WARP

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
colo	string	Cloudflare colo
device_id	string	Device-specific ID, given as UUID v4
from	string	Time range beginning in ISO format
mode	string	The mode under which the WARP client is run
page	number	Page number
per_page	number	Number of results per page
platform	string	Operating system
sort_by	string	Dimension to sort results by
source	string	Source: * hourly - device details aggregated hourly, up to 7 days prior * last_seen - device details, up to 60 minutes prior. Time windows exceeding 60 minutes will be rejected from June 1st, 2026. Please use 'hourly' or 'raw' instead for longer time ranges. * raw - device details, up to 7 days prior
status	string	Network status
to	string	Time range end in ISO format
version	string	WARP client version

SELECT examples

list

List details for devices using WARP

SELECT
alwaysOn,
batteryCharging,
batteryCycles,
batteryPct,
colo,
connectionType,
cpuPct,
cpuPctByApp,
deviceId,
deviceIpv4,
deviceIpv6,
deviceName,
diskReadBps,
diskUsagePct,
diskWriteBps,
dohSubdomain,
estimatedLossPct,
firewallEnabled,
gatewayIpv4,
gatewayIpv6,
handshakeLatencyMs,
ispIpv4,
ispIpv6,
metal,
mode,
networkRcvdBps,
networkSentBps,
networkSsid,
personEmail,
platform,
ramAvailableKb,
ramUsedPct,
ramUsedPctByApp,
registrationId,
status,
switchLocked,
timestamp,
version,
wifiStrengthDbm
FROM cloudflare.zero_trust.fleet_status_devices
WHERE account_id = '{{ account_id }}' -- required
AND to = '{{ to }}'
AND from = '{{ from }}'
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
AND sort_by = '{{ sort_by }}'
AND colo = '{{ colo }}'
AND device_id = '{{ device_id }}'
AND mode = '{{ mode }}'
AND status = '{{ status }}'
AND platform = '{{ platform }}'
AND version = '{{ version }}'
AND source = '{{ source }}'
;