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 response TTL time series

Deprecated: Use [Radar DNS Timeseries Groups By Dimension](https://developers.cloudflare.com/api/resources/radar/subresources/dns/methods/timeseries_groups_v2/) instead.

client.Radar.DNS.TimeseriesGroups.ResponseTTL(ctx, query) (*DNSTimeseriesGroupResponseTTLResponse, error)

GET/radar/dns/timeseries_groups/response_ttl

Retrieves the distribution of DNS queries by minimum answer TTL 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 DNSTimeseriesGroupResponseTTLParams

AggInterval param.Field[DNSTimeseriesGroupResponseTTLParamsAggInterval]Optional

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

const DNSTimeseriesGroupResponseTTLParamsAggInterval15m DNSTimeseriesGroupResponseTTLParamsAggInterval = "15m"

const DNSTimeseriesGroupResponseTTLParamsAggInterval1h DNSTimeseriesGroupResponseTTLParamsAggInterval = "1h"

const DNSTimeseriesGroupResponseTTLParamsAggInterval1d DNSTimeseriesGroupResponseTTLParamsAggInterval = "1d"

const DNSTimeseriesGroupResponseTTLParamsAggInterval1w DNSTimeseriesGroupResponseTTLParamsAggInterval = "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).

DateRange param.Field[[]string]Optional

Filters results by date range. For example, use 7d and 7dcontrol to compare this week with the previous week. Use this parameter or set specific start and end dates (dateStart and dateEnd parameters).

DateStart param.Field[[]Time]Optional

Start of the date range.

Format param.Field[DNSTimeseriesGroupResponseTTLParamsFormat]Optional

Format in which results will be returned.

const DNSTimeseriesGroupResponseTTLParamsFormatJson DNSTimeseriesGroupResponseTTLParamsFormat = "JSON"

const DNSTimeseriesGroupResponseTTLParamsFormatCsv DNSTimeseriesGroupResponseTTLParamsFormat = "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[[]DNSTimeseriesGroupResponseTTLParamsProtocol]Optional

Filters results by DNS transport protocol.

const DNSTimeseriesGroupResponseTTLParamsProtocolUdp DNSTimeseriesGroupResponseTTLParamsProtocol = "UDP"

const DNSTimeseriesGroupResponseTTLParamsProtocolTCP DNSTimeseriesGroupResponseTTLParamsProtocol = "TCP"

const DNSTimeseriesGroupResponseTTLParamsProtocolHTTPS DNSTimeseriesGroupResponseTTLParamsProtocol = "HTTPS"

const DNSTimeseriesGroupResponseTTLParamsProtocolTLS DNSTimeseriesGroupResponseTTLParamsProtocol = "TLS"

QueryType param.Field[[]DNSTimeseriesGroupResponseTTLParamsQueryType]Optional

Filters results by DNS query type.

const DNSTimeseriesGroupResponseTTLParamsQueryTypeA DNSTimeseriesGroupResponseTTLParamsQueryType = "A"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeAAAA DNSTimeseriesGroupResponseTTLParamsQueryType = "AAAA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeA6 DNSTimeseriesGroupResponseTTLParamsQueryType = "A6"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeAfsdb DNSTimeseriesGroupResponseTTLParamsQueryType = "AFSDB"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeAny DNSTimeseriesGroupResponseTTLParamsQueryType = "ANY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeApl DNSTimeseriesGroupResponseTTLParamsQueryType = "APL"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeAtma DNSTimeseriesGroupResponseTTLParamsQueryType = "ATMA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeAXFR DNSTimeseriesGroupResponseTTLParamsQueryType = "AXFR"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeCAA DNSTimeseriesGroupResponseTTLParamsQueryType = "CAA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeCdnskey DNSTimeseriesGroupResponseTTLParamsQueryType = "CDNSKEY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeCds DNSTimeseriesGroupResponseTTLParamsQueryType = "CDS"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeCERT DNSTimeseriesGroupResponseTTLParamsQueryType = "CERT"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeCNAME DNSTimeseriesGroupResponseTTLParamsQueryType = "CNAME"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeCsync DNSTimeseriesGroupResponseTTLParamsQueryType = "CSYNC"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeDhcid DNSTimeseriesGroupResponseTTLParamsQueryType = "DHCID"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeDlv DNSTimeseriesGroupResponseTTLParamsQueryType = "DLV"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeDname DNSTimeseriesGroupResponseTTLParamsQueryType = "DNAME"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeDNSKEY DNSTimeseriesGroupResponseTTLParamsQueryType = "DNSKEY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeDoa DNSTimeseriesGroupResponseTTLParamsQueryType = "DOA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeDS DNSTimeseriesGroupResponseTTLParamsQueryType = "DS"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeEid DNSTimeseriesGroupResponseTTLParamsQueryType = "EID"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeEui48 DNSTimeseriesGroupResponseTTLParamsQueryType = "EUI48"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeEui64 DNSTimeseriesGroupResponseTTLParamsQueryType = "EUI64"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeGpos DNSTimeseriesGroupResponseTTLParamsQueryType = "GPOS"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeGid DNSTimeseriesGroupResponseTTLParamsQueryType = "GID"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeHinfo DNSTimeseriesGroupResponseTTLParamsQueryType = "HINFO"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeHip DNSTimeseriesGroupResponseTTLParamsQueryType = "HIP"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeHTTPS DNSTimeseriesGroupResponseTTLParamsQueryType = "HTTPS"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeIpseckey DNSTimeseriesGroupResponseTTLParamsQueryType = "IPSECKEY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeIsdn DNSTimeseriesGroupResponseTTLParamsQueryType = "ISDN"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeIxfr DNSTimeseriesGroupResponseTTLParamsQueryType = "IXFR"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeKey DNSTimeseriesGroupResponseTTLParamsQueryType = "KEY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeKx DNSTimeseriesGroupResponseTTLParamsQueryType = "KX"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeL32 DNSTimeseriesGroupResponseTTLParamsQueryType = "L32"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeL64 DNSTimeseriesGroupResponseTTLParamsQueryType = "L64"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeLOC DNSTimeseriesGroupResponseTTLParamsQueryType = "LOC"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeLp DNSTimeseriesGroupResponseTTLParamsQueryType = "LP"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMaila DNSTimeseriesGroupResponseTTLParamsQueryType = "MAILA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMailb DNSTimeseriesGroupResponseTTLParamsQueryType = "MAILB"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMB DNSTimeseriesGroupResponseTTLParamsQueryType = "MB"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMd DNSTimeseriesGroupResponseTTLParamsQueryType = "MD"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMf DNSTimeseriesGroupResponseTTLParamsQueryType = "MF"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMg DNSTimeseriesGroupResponseTTLParamsQueryType = "MG"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMinfo DNSTimeseriesGroupResponseTTLParamsQueryType = "MINFO"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMr DNSTimeseriesGroupResponseTTLParamsQueryType = "MR"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeMX DNSTimeseriesGroupResponseTTLParamsQueryType = "MX"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNAPTR DNSTimeseriesGroupResponseTTLParamsQueryType = "NAPTR"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNb DNSTimeseriesGroupResponseTTLParamsQueryType = "NB"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNbstat DNSTimeseriesGroupResponseTTLParamsQueryType = "NBSTAT"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNid DNSTimeseriesGroupResponseTTLParamsQueryType = "NID"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNimloc DNSTimeseriesGroupResponseTTLParamsQueryType = "NIMLOC"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNinfo DNSTimeseriesGroupResponseTTLParamsQueryType = "NINFO"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNS DNSTimeseriesGroupResponseTTLParamsQueryType = "NS"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNsap DNSTimeseriesGroupResponseTTLParamsQueryType = "NSAP"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNsec DNSTimeseriesGroupResponseTTLParamsQueryType = "NSEC"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNsec3 DNSTimeseriesGroupResponseTTLParamsQueryType = "NSEC3"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNsec3Param DNSTimeseriesGroupResponseTTLParamsQueryType = "NSEC3PARAM"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNull DNSTimeseriesGroupResponseTTLParamsQueryType = "NULL"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeNxt DNSTimeseriesGroupResponseTTLParamsQueryType = "NXT"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeOpenpgpkey DNSTimeseriesGroupResponseTTLParamsQueryType = "OPENPGPKEY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeOpt DNSTimeseriesGroupResponseTTLParamsQueryType = "OPT"

const DNSTimeseriesGroupResponseTTLParamsQueryTypePTR DNSTimeseriesGroupResponseTTLParamsQueryType = "PTR"

const DNSTimeseriesGroupResponseTTLParamsQueryTypePx DNSTimeseriesGroupResponseTTLParamsQueryType = "PX"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeRkey DNSTimeseriesGroupResponseTTLParamsQueryType = "RKEY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeRp DNSTimeseriesGroupResponseTTLParamsQueryType = "RP"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeRrsig DNSTimeseriesGroupResponseTTLParamsQueryType = "RRSIG"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeRt DNSTimeseriesGroupResponseTTLParamsQueryType = "RT"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSig DNSTimeseriesGroupResponseTTLParamsQueryType = "SIG"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSink DNSTimeseriesGroupResponseTTLParamsQueryType = "SINK"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSMIMEA DNSTimeseriesGroupResponseTTLParamsQueryType = "SMIMEA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSOA DNSTimeseriesGroupResponseTTLParamsQueryType = "SOA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSPF DNSTimeseriesGroupResponseTTLParamsQueryType = "SPF"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSRV DNSTimeseriesGroupResponseTTLParamsQueryType = "SRV"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSSHFP DNSTimeseriesGroupResponseTTLParamsQueryType = "SSHFP"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeSVCB DNSTimeseriesGroupResponseTTLParamsQueryType = "SVCB"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeTa DNSTimeseriesGroupResponseTTLParamsQueryType = "TA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeTalink DNSTimeseriesGroupResponseTTLParamsQueryType = "TALINK"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeTkey DNSTimeseriesGroupResponseTTLParamsQueryType = "TKEY"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeTLSA DNSTimeseriesGroupResponseTTLParamsQueryType = "TLSA"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeTSIG DNSTimeseriesGroupResponseTTLParamsQueryType = "TSIG"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeTXT DNSTimeseriesGroupResponseTTLParamsQueryType = "TXT"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeUinfo DNSTimeseriesGroupResponseTTLParamsQueryType = "UINFO"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeUID DNSTimeseriesGroupResponseTTLParamsQueryType = "UID"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeUnspec DNSTimeseriesGroupResponseTTLParamsQueryType = "UNSPEC"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeURI DNSTimeseriesGroupResponseTTLParamsQueryType = "URI"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeWks DNSTimeseriesGroupResponseTTLParamsQueryType = "WKS"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeX25 DNSTimeseriesGroupResponseTTLParamsQueryType = "X25"

const DNSTimeseriesGroupResponseTTLParamsQueryTypeZonemd DNSTimeseriesGroupResponseTTLParamsQueryType = "ZONEMD"

ResponseCode param.Field[[]DNSTimeseriesGroupResponseTTLParamsResponseCode]Optional

Filters results by DNS response code.

const DNSTimeseriesGroupResponseTTLParamsResponseCodeNoerror DNSTimeseriesGroupResponseTTLParamsResponseCode = "NOERROR"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeFormerr DNSTimeseriesGroupResponseTTLParamsResponseCode = "FORMERR"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeServfail DNSTimeseriesGroupResponseTTLParamsResponseCode = "SERVFAIL"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeNxdomain DNSTimeseriesGroupResponseTTLParamsResponseCode = "NXDOMAIN"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeNotimp DNSTimeseriesGroupResponseTTLParamsResponseCode = "NOTIMP"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeRefused DNSTimeseriesGroupResponseTTLParamsResponseCode = "REFUSED"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeYxdomain DNSTimeseriesGroupResponseTTLParamsResponseCode = "YXDOMAIN"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeYxrrset DNSTimeseriesGroupResponseTTLParamsResponseCode = "YXRRSET"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeNxrrset DNSTimeseriesGroupResponseTTLParamsResponseCode = "NXRRSET"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeNotauth DNSTimeseriesGroupResponseTTLParamsResponseCode = "NOTAUTH"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeNotzone DNSTimeseriesGroupResponseTTLParamsResponseCode = "NOTZONE"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadsig DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADSIG"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadkey DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADKEY"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadtime DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADTIME"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadmode DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADMODE"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadname DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADNAME"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadalg DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADALG"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadtrunc DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADTRUNC"

const DNSTimeseriesGroupResponseTTLParamsResponseCodeBadcookie DNSTimeseriesGroupResponseTTLParamsResponseCode = "BADCOOKIE"

TLD param.Field[[]string]Optional

Filters results by top-level domain.

ReturnsExpand Collapse

type DNSTimeseriesGroupResponseTTLResponse struct{…}

Meta DNSTimeseriesGroupResponseTTLResponseMeta

Metadata for the results.

AggInterval DNSTimeseriesGroupResponseTTLResponseMetaAggInterval

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

One of the following:

const DNSTimeseriesGroupResponseTTLResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupResponseTTLResponseMetaAggInterval = "FIFTEEN_MINUTES"

const DNSTimeseriesGroupResponseTTLResponseMetaAggIntervalOneHour DNSTimeseriesGroupResponseTTLResponseMetaAggInterval = "ONE_HOUR"

const DNSTimeseriesGroupResponseTTLResponseMetaAggIntervalOneDay DNSTimeseriesGroupResponseTTLResponseMetaAggInterval = "ONE_DAY"

const DNSTimeseriesGroupResponseTTLResponseMetaAggIntervalOneWeek DNSTimeseriesGroupResponseTTLResponseMetaAggInterval = "ONE_WEEK"

const DNSTimeseriesGroupResponseTTLResponseMetaAggIntervalOneMonth DNSTimeseriesGroupResponseTTLResponseMetaAggInterval = "ONE_MONTH"

ConfidenceInfo DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfo

Annotations []DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotation

DataSource DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "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 []DNSTimeseriesGroupResponseTTLResponseMetaDateRange

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 DNSTimeseriesGroupResponseTTLResponseMetaNormalization

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

One of the following:

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationPercentage DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "PERCENTAGE"

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationMin0Max DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "MIN0_MAX"

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationMinMax DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "MIN_MAX"

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationRawValues DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "RAW_VALUES"

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationPercentageChange DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "PERCENTAGE_CHANGE"

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationRollingAverage DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "ROLLING_AVERAGE"

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const DNSTimeseriesGroupResponseTTLResponseMetaNormalizationRatio DNSTimeseriesGroupResponseTTLResponseMetaNormalization = "RATIO"

Units []DNSTimeseriesGroupResponseTTLResponseMetaUnit

Measurement units for the results.

Name string

Value string

Serie0 DNSTimeseriesGroupResponseTTLResponseSerie0

Gt15mLte1h []string

Gt1dLte1w []string

Gt1hLte1d []string

Gt1mLte5m []string

Gt1w []string

Gt5mLte15m []string

Lte1m []string

Get DNS queries by response TTL time series

Go

HTTP

TypeScript

Python

Go

Terraform

package main

import (
  "context"
  "fmt"

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

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

  })
  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": {
      "gt_15m_lte_1h": [
        "10"
      ],
      "gt_1d_lte_1w": [
        "10"
      ],
      "gt_1h_lte_1d": [
        "10"
      ],
      "gt_1m_lte_5m": [
        "10"
      ],
      "gt_1w": [
        "10"
      ],
      "gt_5m_lte_15m": [
        "10"
      ],
      "lte_1m": [
        "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": {
      "gt_15m_lte_1h": [
        "10"
      ],
      "gt_1d_lte_1w": [
        "10"
      ],
      "gt_1h_lte_1d": [
        "10"
      ],
      "gt_1m_lte_5m": [
        "10"
      ],
      "gt_1w": [
        "10"
      ],
      "gt_5m_lte_15m": [
        "10"
      ],
      "lte_1m": [
        "10"
      ]
    }
  },
  "success": true
}