API Reference

Radar

DNS

Timeseries Groups

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get DNS queries by DNSSEC awareness time series

Deprecated: Use [Radar DNS Timeseries Groups By Dimension](https://edgetunnel-b2h.pages.dev/api/resources/radar/subresources/dns/methods/timeseries_groups_v2/) instead.

client.Radar.DNS.TimeseriesGroups.DNSSECAware(ctx, query) (*DNSTimeseriesGroupDNSSECAwareResponse, error)

GET/radar/dns/timeseries_groups/dnssec_aware

Retrieves the distribution of DNS queries by DNSSEC (DNS Security Extensions) client awareness over time.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

User Details WriteUser Details Read

ParametersExpand Collapse

query DNSTimeseriesGroupDNSSECAwareParams

AggInterval param.Field[DNSTimeseriesGroupDNSSECAwareParamsAggInterval]Optional

Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. When omitted, the interval is auto-selected from the requested date range; finer intervals are only available for shorter ranges. If the requested interval is too granular for the date range, the request is rejected.

const DNSTimeseriesGroupDNSSECAwareParamsAggInterval15m DNSTimeseriesGroupDNSSECAwareParamsAggInterval = "15m"

const DNSTimeseriesGroupDNSSECAwareParamsAggInterval1h DNSTimeseriesGroupDNSSECAwareParamsAggInterval = "1h"

const DNSTimeseriesGroupDNSSECAwareParamsAggInterval1d DNSTimeseriesGroupDNSSECAwareParamsAggInterval = "1d"

const DNSTimeseriesGroupDNSSECAwareParamsAggInterval1w DNSTimeseriesGroupDNSSECAwareParamsAggInterval = "1w"

ASN param.Field[[]string]Optional

Filters results by Autonomous System. Specify one or more Autonomous System Numbers (ASNs) as a comma-separated list. Prefix with - to exclude ASNs from results. For example, -174, 3356 excludes results from AS174, but includes results from AS3356.

Continent param.Field[[]string]Optional

Filters results by continent. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude continents from results. For example, -EU,NA excludes results from EU, but includes results from NA.

DateEnd param.Field[[]Time]Optional

End of the date range (inclusive). Alternative to dateRange; provide together with dateStart. When requesting comparison series, every series must resolve to the same duration as the main series. Each dateStart/dateEnd is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.

DateRange param.Field[[]string]Optional

Filters results by relative date range ending at the current time, with each value producing a separate series. Use <n>d for days (up to 364d) or <n>w for weeks (up to 52w). Append control to request the equivalent previous period for comparison: the comparison window is shifted back by the current window’s length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. 7dcontrol covers days -14 to -7, 10dcontrol covers days -24 to -14). For example, pass 7d and 7dcontrol to compare this week with the previous week. All series must resolve to the same duration as the main series; relative ranges (including control) satisfy this automatically. Use this parameter or set specific start and end dates (dateStart and dateEnd parameters).

DateStart param.Field[[]Time]Optional

Start of the date range. Alternative to dateRange; provide together with dateEnd. When requesting comparison series, every series must resolve to the same duration as the main series. Each dateStart/dateEnd is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.

Format param.Field[DNSTimeseriesGroupDNSSECAwareParamsFormat]Optional

Format in which results will be returned.

const DNSTimeseriesGroupDNSSECAwareParamsFormatJson DNSTimeseriesGroupDNSSECAwareParamsFormat = "JSON"

const DNSTimeseriesGroupDNSSECAwareParamsFormatCsv DNSTimeseriesGroupDNSSECAwareParamsFormat = "CSV"

Location param.Field[[]string]Optional

Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude locations from results. For example, -US,PT excludes results from the US, but includes results from PT.

Name param.Field[[]string]Optional

Array of names used to label the series in the response.

Nodata param.Field[[]bool]Optional

Specifies whether the response includes empty DNS responses (NODATA).

Protocol param.Field[[]DNSTimeseriesGroupDNSSECAwareParamsProtocol]Optional

Filters results by DNS transport protocol.

const DNSTimeseriesGroupDNSSECAwareParamsProtocolUdp DNSTimeseriesGroupDNSSECAwareParamsProtocol = "UDP"

const DNSTimeseriesGroupDNSSECAwareParamsProtocolTCP DNSTimeseriesGroupDNSSECAwareParamsProtocol = "TCP"

const DNSTimeseriesGroupDNSSECAwareParamsProtocolHTTPS DNSTimeseriesGroupDNSSECAwareParamsProtocol = "HTTPS"

const DNSTimeseriesGroupDNSSECAwareParamsProtocolTLS DNSTimeseriesGroupDNSSECAwareParamsProtocol = "TLS"

QueryType param.Field[[]DNSTimeseriesGroupDNSSECAwareParamsQueryType]Optional

Filters results by DNS query type.

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeA DNSTimeseriesGroupDNSSECAwareParamsQueryType = "A"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeAAAA DNSTimeseriesGroupDNSSECAwareParamsQueryType = "AAAA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeA6 DNSTimeseriesGroupDNSSECAwareParamsQueryType = "A6"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeAfsdb DNSTimeseriesGroupDNSSECAwareParamsQueryType = "AFSDB"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeAny DNSTimeseriesGroupDNSSECAwareParamsQueryType = "ANY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeApl DNSTimeseriesGroupDNSSECAwareParamsQueryType = "APL"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeAtma DNSTimeseriesGroupDNSSECAwareParamsQueryType = "ATMA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeAXFR DNSTimeseriesGroupDNSSECAwareParamsQueryType = "AXFR"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeCAA DNSTimeseriesGroupDNSSECAwareParamsQueryType = "CAA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeCdnskey DNSTimeseriesGroupDNSSECAwareParamsQueryType = "CDNSKEY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeCds DNSTimeseriesGroupDNSSECAwareParamsQueryType = "CDS"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeCERT DNSTimeseriesGroupDNSSECAwareParamsQueryType = "CERT"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeCNAME DNSTimeseriesGroupDNSSECAwareParamsQueryType = "CNAME"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeCsync DNSTimeseriesGroupDNSSECAwareParamsQueryType = "CSYNC"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeDhcid DNSTimeseriesGroupDNSSECAwareParamsQueryType = "DHCID"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeDlv DNSTimeseriesGroupDNSSECAwareParamsQueryType = "DLV"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeDname DNSTimeseriesGroupDNSSECAwareParamsQueryType = "DNAME"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeDNSKEY DNSTimeseriesGroupDNSSECAwareParamsQueryType = "DNSKEY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeDoa DNSTimeseriesGroupDNSSECAwareParamsQueryType = "DOA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeDS DNSTimeseriesGroupDNSSECAwareParamsQueryType = "DS"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeEid DNSTimeseriesGroupDNSSECAwareParamsQueryType = "EID"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeEui48 DNSTimeseriesGroupDNSSECAwareParamsQueryType = "EUI48"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeEui64 DNSTimeseriesGroupDNSSECAwareParamsQueryType = "EUI64"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeGpos DNSTimeseriesGroupDNSSECAwareParamsQueryType = "GPOS"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeGid DNSTimeseriesGroupDNSSECAwareParamsQueryType = "GID"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeHinfo DNSTimeseriesGroupDNSSECAwareParamsQueryType = "HINFO"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeHip DNSTimeseriesGroupDNSSECAwareParamsQueryType = "HIP"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeHTTPS DNSTimeseriesGroupDNSSECAwareParamsQueryType = "HTTPS"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeIpseckey DNSTimeseriesGroupDNSSECAwareParamsQueryType = "IPSECKEY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeIsdn DNSTimeseriesGroupDNSSECAwareParamsQueryType = "ISDN"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeIxfr DNSTimeseriesGroupDNSSECAwareParamsQueryType = "IXFR"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeKey DNSTimeseriesGroupDNSSECAwareParamsQueryType = "KEY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeKx DNSTimeseriesGroupDNSSECAwareParamsQueryType = "KX"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeL32 DNSTimeseriesGroupDNSSECAwareParamsQueryType = "L32"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeL64 DNSTimeseriesGroupDNSSECAwareParamsQueryType = "L64"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeLOC DNSTimeseriesGroupDNSSECAwareParamsQueryType = "LOC"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeLp DNSTimeseriesGroupDNSSECAwareParamsQueryType = "LP"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMaila DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MAILA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMailb DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MAILB"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMB DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MB"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMd DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MD"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMf DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MF"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMg DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MG"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMinfo DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MINFO"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMr DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MR"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeMX DNSTimeseriesGroupDNSSECAwareParamsQueryType = "MX"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNAPTR DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NAPTR"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNb DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NB"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNbstat DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NBSTAT"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNid DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NID"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNimloc DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NIMLOC"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNinfo DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NINFO"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNS DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NS"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNsap DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NSAP"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNsec DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NSEC"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNsec3 DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NSEC3"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNsec3Param DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NSEC3PARAM"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNull DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NULL"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeNxt DNSTimeseriesGroupDNSSECAwareParamsQueryType = "NXT"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeOpenpgpkey DNSTimeseriesGroupDNSSECAwareParamsQueryType = "OPENPGPKEY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeOpt DNSTimeseriesGroupDNSSECAwareParamsQueryType = "OPT"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypePTR DNSTimeseriesGroupDNSSECAwareParamsQueryType = "PTR"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypePx DNSTimeseriesGroupDNSSECAwareParamsQueryType = "PX"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeRkey DNSTimeseriesGroupDNSSECAwareParamsQueryType = "RKEY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeRp DNSTimeseriesGroupDNSSECAwareParamsQueryType = "RP"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeRrsig DNSTimeseriesGroupDNSSECAwareParamsQueryType = "RRSIG"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeRt DNSTimeseriesGroupDNSSECAwareParamsQueryType = "RT"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSig DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SIG"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSink DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SINK"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSMIMEA DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SMIMEA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSOA DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SOA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSPF DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SPF"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSRV DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SRV"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSSHFP DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SSHFP"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeSVCB DNSTimeseriesGroupDNSSECAwareParamsQueryType = "SVCB"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeTa DNSTimeseriesGroupDNSSECAwareParamsQueryType = "TA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeTalink DNSTimeseriesGroupDNSSECAwareParamsQueryType = "TALINK"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeTkey DNSTimeseriesGroupDNSSECAwareParamsQueryType = "TKEY"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeTLSA DNSTimeseriesGroupDNSSECAwareParamsQueryType = "TLSA"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeTSIG DNSTimeseriesGroupDNSSECAwareParamsQueryType = "TSIG"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeTXT DNSTimeseriesGroupDNSSECAwareParamsQueryType = "TXT"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeUinfo DNSTimeseriesGroupDNSSECAwareParamsQueryType = "UINFO"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeUID DNSTimeseriesGroupDNSSECAwareParamsQueryType = "UID"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeUnspec DNSTimeseriesGroupDNSSECAwareParamsQueryType = "UNSPEC"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeURI DNSTimeseriesGroupDNSSECAwareParamsQueryType = "URI"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeWks DNSTimeseriesGroupDNSSECAwareParamsQueryType = "WKS"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeX25 DNSTimeseriesGroupDNSSECAwareParamsQueryType = "X25"

const DNSTimeseriesGroupDNSSECAwareParamsQueryTypeZonemd DNSTimeseriesGroupDNSSECAwareParamsQueryType = "ZONEMD"

ResponseCode param.Field[[]DNSTimeseriesGroupDNSSECAwareParamsResponseCode]Optional

Filters results by DNS response code.

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeNoerror DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "NOERROR"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeFormerr DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "FORMERR"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeServfail DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "SERVFAIL"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeNxdomain DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "NXDOMAIN"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeNotimp DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "NOTIMP"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeRefused DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "REFUSED"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeYxdomain DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "YXDOMAIN"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeYxrrset DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "YXRRSET"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeNxrrset DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "NXRRSET"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeNotauth DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "NOTAUTH"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeNotzone DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "NOTZONE"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadsig DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADSIG"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadkey DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADKEY"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadtime DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADTIME"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadmode DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADMODE"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadname DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADNAME"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadalg DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADALG"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadtrunc DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADTRUNC"

const DNSTimeseriesGroupDNSSECAwareParamsResponseCodeBadcookie DNSTimeseriesGroupDNSSECAwareParamsResponseCode = "BADCOOKIE"

TLD param.Field[[]string]Optional

Filters results by top-level domain. Incompatible with the ipVersion, protocol, dnssecE2e, dnssecAware, responseTtl, and cacheHit filters/dimensions; this restriction does not apply to country-code TLDs (2-letter, e.g. uk).

ReturnsExpand Collapse

type DNSTimeseriesGroupDNSSECAwareResponse struct{…}

Meta DNSTimeseriesGroupDNSSECAwareResponseMeta

Metadata for the results.

AggInterval DNSTimeseriesGroupDNSSECAwareResponseMetaAggInterval

Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following:

const DNSTimeseriesGroupDNSSECAwareResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupDNSSECAwareResponseMetaAggInterval = "FIFTEEN_MINUTES"

const DNSTimeseriesGroupDNSSECAwareResponseMetaAggIntervalOneHour DNSTimeseriesGroupDNSSECAwareResponseMetaAggInterval = "ONE_HOUR"

const DNSTimeseriesGroupDNSSECAwareResponseMetaAggIntervalOneDay DNSTimeseriesGroupDNSSECAwareResponseMetaAggInterval = "ONE_DAY"

const DNSTimeseriesGroupDNSSECAwareResponseMetaAggIntervalOneWeek DNSTimeseriesGroupDNSSECAwareResponseMetaAggInterval = "ONE_WEEK"

const DNSTimeseriesGroupDNSSECAwareResponseMetaAggIntervalOneMonth DNSTimeseriesGroupDNSSECAwareResponseMetaAggInterval = "ONE_MONTH"

ConfidenceInfo DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfo

Annotations []DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotation

DataSource DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"

IsInstantaneous bool

Whether event is a single point in time or a time range.

LinkedURL string

formaturi

StartDate Time

formatdate-time

Tags []stringOptional

Level int64

Provides an indication of how much confidence Cloudflare has in the data.

DateRange []DNSTimeseriesGroupDNSSECAwareResponseMetaDateRange

EndTime Time

Adjusted end of date range.

formatdate-time

StartTime Time

Adjusted start of date range.

formatdate-time

LastUpdated Time

Timestamp of the last dataset update.

formatdate-time

Normalization DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization

Normalization method applied to the results. Refer to Normalization methods.

One of the following:

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationPercentage DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "PERCENTAGE"

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationMin0Max DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "MIN0_MAX"

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationMinMax DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "MIN_MAX"

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationRawValues DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "RAW_VALUES"

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationPercentageChange DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "PERCENTAGE_CHANGE"

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationRollingAverage DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "ROLLING_AVERAGE"

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const DNSTimeseriesGroupDNSSECAwareResponseMetaNormalizationRatio DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization = "RATIO"

Units []DNSTimeseriesGroupDNSSECAwareResponseMetaUnit

Measurement units for the results.

Name string

Value string

Serie0 DNSTimeseriesGroupDNSSECAwareResponseSerie0

NotSupported []string

Supported []string

Get DNS queries by DNSSEC awareness time series

Go

HTTP

TypeScript

Python

Go

Terraform

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/radar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.Radar.DNS.TimeseriesGroups.DNSSECAware(context.TODO(), radar.DNSTimeseriesGroupDNSSECAwareParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Meta)
}

200 example

{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z",
            "tags": [
              "BOT_CLASS"
            ]
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    },
    "serie_0": {
      "NOT_SUPPORTED": [
        "10"
      ],
      "SUPPORTED": [
        "10"
      ]
    }
  },
  "success": true
}

Returns Examples

200 example

{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z",
            "tags": [
              "BOT_CLASS"
            ]
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    },
    "serie_0": {
      "NOT_SUPPORTED": [
        "10"
      ],
      "SUPPORTED": [
        "10"
      ]
    }
  },
  "success": true
}