fleet_status
Creates, updates, deletes, gets or lists a fleet_status resource.
Overview
| Name | fleet_status |
| Type | Resource |
| Id | cloudflare.zero_trust.fleet_status |
Fields
The following fields are returned by SELECT queries:
- list
Get the live status of a latest device
| 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, device_id | since_minutes, time_now, colo | Get the live status of a latest device given device_id from the device_state table |
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. |
device_id | string | Unique identifier for device |
colo | string | List of data centers to filter results |
since_minutes | number | Number of minutes before current time |
time_now | string | Number of minutes before current time |
SELECT examples
- list
Get the live status of a latest device given device_id from the device_state table
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
WHERE account_id = '{{ account_id }}' -- required
AND device_id = '{{ device_id }}' -- required
AND since_minutes = '{{ since_minutes }}'
AND time_now = '{{ time_now }}'
AND colo = '{{ colo }}'
;