roas
Creates, updates, deletes, gets or lists a roas resource.
Overview
| Name | roas |
| Type | Resource |
| Id | cloudflare.radar.roas |
Fields
The following fields are returned by SELECT queries:
- list
Successful response.
| Name | Datatype | Description |
|---|---|---|
meta | object | |
serie_0 | object |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | dateStart, dateEnd, metric, asn, location, name, format | Retrieves RPKI ROA (Route Origin Authorization) validation ratios over time. Returns the selected metric as a time series. Supports filtering by ASN or location (country code) — multiple values of the same filter type produce one series per value. If no ASN or location is specified, returns the global aggregate. |
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 |
|---|---|---|
asn | array | Filters results by Autonomous System Number. Specify one or more ASNs. Multiple values generate one series per ASN. |
dateEnd | string (date-time) | End of the date range (inclusive). |
dateStart | string (date-time) | Start of the date range (inclusive). |
format | string | Format in which results will be returned. |
location | array | Filters results by location. Specify a comma-separated list of alpha-2 location codes. |
metric | string | Which RPKI ROA validation metric to return. validPfxsRatio = ratio of RPKI-valid prefixes (IPv4+IPv6 combined). validPfxsV4Ratio / validPfxsV6Ratio = same, split by IP version. validIpsRatio = ratio of RPKI-valid address space (IPv4 /24s + IPv6 /48s). validIpsV4Ratio / validIpsV6Ratio = same, split by IP version. |
name | array | Array of names used to label the series in the response. |
SELECT examples
- list
Retrieves RPKI ROA (Route Origin Authorization) validation ratios over time. Returns the selected metric as a time series. Supports filtering by ASN or location (country code) — multiple values of the same filter type produce one series per value. If no ASN or location is specified, returns the global aggregate.
SELECT
meta,
serie_0
FROM cloudflare.radar.roas
WHERE dateStart = '{{ dateStart }}'
AND dateEnd = '{{ dateEnd }}'
AND metric = '{{ metric }}'
AND asn = '{{ asn }}'
AND location = '{{ location }}'
AND name = '{{ name }}'
AND format = '{{ format }}'
;