Skip to main content

annotations

Creates, updates, deletes, gets or lists an annotations resource.

Overview

Nameannotations
TypeResource
Idcloudflare.radar.annotations

Fields

The following fields are returned by SELECT queries:

Successful response.

NameDatatypeDescription
idstring
asnsarray
asnsDetailsarray
dataSourcestring
descriptionstring
endDatestring
eventTypestring
linkedUrlstring
locationsarray
locationsDetailsarray
originsarray
originsDetailsarray
outageobject
scopestring
startDatestring

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectlimit, offset, dateRange, dateStart, dateEnd, dataSource, eventType, asn, location, origin, formatRetrieves the latest annotations.

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.

NameDatatypeDescription
asnintegerFilters results by Autonomous System. Specify a single Autonomous System Number (ASN) as integer.
dataSourcestringFilters results by data source.
dateEndstring (date-time)End of the date range (inclusive).
dateRangestringFilters results by date range.
dateStartstring (date-time)Start of the date range (inclusive).
eventTypestringFilters results by event type.
formatstringFormat in which results will be returned.
limitintegerLimits the number of objects returned in the response.
locationstringFilters results by location. Specify an alpha-2 location code.
offsetintegerSkips the specified number of objects before fetching the results.
originstringFilters results by origin.

SELECT examples

Retrieves the latest annotations.

SELECT
id,
asns,
asnsDetails,
dataSource,
description,
endDate,
eventType,
linkedUrl,
locations,
locationsDetails,
origins,
originsDetails,
outage,
scope,
startDate
FROM cloudflare.radar.annotations
WHERE limit = '{{ limit }}'
AND offset = '{{ offset }}'
AND dateRange = '{{ dateRange }}'
AND dateStart = '{{ dateStart }}'
AND dateEnd = '{{ dateEnd }}'
AND dataSource = '{{ dataSource }}'
AND eventType = '{{ eventType }}'
AND asn = '{{ asn }}'
AND location = '{{ location }}'
AND origin = '{{ origin }}'
AND format = '{{ format }}'
;