warp_change_events

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

Overview

Name	warp_change_events
Type	Resource
Id	cloudflare.zero_trust.warp_change_events

Fields

The following fields are returned by SELECT queries:

list

success response

Name	Datatype	Description
device_id	string	API Resource UUID tag. (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415)
registration_id	string	API Resource UUID tag. (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415)
account_name	string	The account name.
account_tag	string	The public account identifier.
device_registration	string	API Resource UUID tag. (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415)
from	object
hostname	string	The hostname of the machine the event is from
serial_number	string	The serial number of the machine the event is from
timestamp	string	Timestamp in ISO format (example: 2023-10-11T00:00:00Z)
to	object
toggle	string	The state of the WARP toggle. (on, off)
user_email	string	Email tied to the device

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	account_id	page, per_page, from, to, type, toggle, config_name, account_name, sort_order	List WARP configuration and enablement toggle change events by device.

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.
account_name	string	Filter events by account name.
config_name	string	Filter events by WARP configuration name changed from or to. Applicable to type='config' events only.
from	string	Start time for the query in ISO (RFC3339 - ISO 8601) format
page	number	Page number of paginated results
per_page	number	Number of items per page
sort_order	string	Sort response by event timestamp.
to	string	End time for the query in ISO (RFC3339 - ISO 8601) format
toggle	string	Filter events by type toggle value. Applicable to type='toggle' events only.
type	string	Filter events by type 'config' or 'toggle'

SELECT examples

list

List WARP configuration and enablement toggle change events by device.

SELECT
device_id,
registration_id,
account_name,
account_tag,
device_registration,
from,
hostname,
serial_number,
timestamp,
to,
toggle,
user_email
FROM cloudflare.zero_trust.warp_change_events
WHERE account_id = '{{ account_id }}' -- required
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
AND from = '{{ from }}'
AND to = '{{ to }}'
AND type = '{{ type }}'
AND toggle = '{{ toggle }}'
AND config_name = '{{ config_name }}'
AND account_name = '{{ account_name }}'
AND sort_order = '{{ sort_order }}'
;