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 cache status 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.CacheHit(ctx, query) (*DNSTimeseriesGroupCacheHitResponse, error)

GET/radar/dns/timeseries_groups/cache_hit

Retrieves the distribution of DNS queries by cache status 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 DNSTimeseriesGroupCacheHitParams

AggInterval param.Field[DNSTimeseriesGroupCacheHitParamsAggInterval]Optional

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

const DNSTimeseriesGroupCacheHitParamsAggInterval15m DNSTimeseriesGroupCacheHitParamsAggInterval = "15m"

const DNSTimeseriesGroupCacheHitParamsAggInterval1h DNSTimeseriesGroupCacheHitParamsAggInterval = "1h"

const DNSTimeseriesGroupCacheHitParamsAggInterval1d DNSTimeseriesGroupCacheHitParamsAggInterval = "1d"

const DNSTimeseriesGroupCacheHitParamsAggInterval1w DNSTimeseriesGroupCacheHitParamsAggInterval = "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[DNSTimeseriesGroupCacheHitParamsFormat]Optional

Format in which results will be returned.

const DNSTimeseriesGroupCacheHitParamsFormatJson DNSTimeseriesGroupCacheHitParamsFormat = "JSON"

const DNSTimeseriesGroupCacheHitParamsFormatCsv DNSTimeseriesGroupCacheHitParamsFormat = "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[[]DNSTimeseriesGroupCacheHitParamsProtocol]Optional

Filters results by DNS transport protocol.

const DNSTimeseriesGroupCacheHitParamsProtocolUdp DNSTimeseriesGroupCacheHitParamsProtocol = "UDP"

const DNSTimeseriesGroupCacheHitParamsProtocolTCP DNSTimeseriesGroupCacheHitParamsProtocol = "TCP"

const DNSTimeseriesGroupCacheHitParamsProtocolHTTPS DNSTimeseriesGroupCacheHitParamsProtocol = "HTTPS"

const DNSTimeseriesGroupCacheHitParamsProtocolTLS DNSTimeseriesGroupCacheHitParamsProtocol = "TLS"

QueryType param.Field[[]DNSTimeseriesGroupCacheHitParamsQueryType]Optional

Filters results by DNS query type.

const DNSTimeseriesGroupCacheHitParamsQueryTypeA DNSTimeseriesGroupCacheHitParamsQueryType = "A"

const DNSTimeseriesGroupCacheHitParamsQueryTypeAAAA DNSTimeseriesGroupCacheHitParamsQueryType = "AAAA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeA6 DNSTimeseriesGroupCacheHitParamsQueryType = "A6"

const DNSTimeseriesGroupCacheHitParamsQueryTypeAfsdb DNSTimeseriesGroupCacheHitParamsQueryType = "AFSDB"

const DNSTimeseriesGroupCacheHitParamsQueryTypeAny DNSTimeseriesGroupCacheHitParamsQueryType = "ANY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeApl DNSTimeseriesGroupCacheHitParamsQueryType = "APL"

const DNSTimeseriesGroupCacheHitParamsQueryTypeAtma DNSTimeseriesGroupCacheHitParamsQueryType = "ATMA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeAXFR DNSTimeseriesGroupCacheHitParamsQueryType = "AXFR"

const DNSTimeseriesGroupCacheHitParamsQueryTypeCAA DNSTimeseriesGroupCacheHitParamsQueryType = "CAA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeCdnskey DNSTimeseriesGroupCacheHitParamsQueryType = "CDNSKEY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeCds DNSTimeseriesGroupCacheHitParamsQueryType = "CDS"

const DNSTimeseriesGroupCacheHitParamsQueryTypeCERT DNSTimeseriesGroupCacheHitParamsQueryType = "CERT"

const DNSTimeseriesGroupCacheHitParamsQueryTypeCNAME DNSTimeseriesGroupCacheHitParamsQueryType = "CNAME"

const DNSTimeseriesGroupCacheHitParamsQueryTypeCsync DNSTimeseriesGroupCacheHitParamsQueryType = "CSYNC"

const DNSTimeseriesGroupCacheHitParamsQueryTypeDhcid DNSTimeseriesGroupCacheHitParamsQueryType = "DHCID"

const DNSTimeseriesGroupCacheHitParamsQueryTypeDlv DNSTimeseriesGroupCacheHitParamsQueryType = "DLV"

const DNSTimeseriesGroupCacheHitParamsQueryTypeDname DNSTimeseriesGroupCacheHitParamsQueryType = "DNAME"

const DNSTimeseriesGroupCacheHitParamsQueryTypeDNSKEY DNSTimeseriesGroupCacheHitParamsQueryType = "DNSKEY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeDoa DNSTimeseriesGroupCacheHitParamsQueryType = "DOA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeDS DNSTimeseriesGroupCacheHitParamsQueryType = "DS"

const DNSTimeseriesGroupCacheHitParamsQueryTypeEid DNSTimeseriesGroupCacheHitParamsQueryType = "EID"

const DNSTimeseriesGroupCacheHitParamsQueryTypeEui48 DNSTimeseriesGroupCacheHitParamsQueryType = "EUI48"

const DNSTimeseriesGroupCacheHitParamsQueryTypeEui64 DNSTimeseriesGroupCacheHitParamsQueryType = "EUI64"

const DNSTimeseriesGroupCacheHitParamsQueryTypeGpos DNSTimeseriesGroupCacheHitParamsQueryType = "GPOS"

const DNSTimeseriesGroupCacheHitParamsQueryTypeGid DNSTimeseriesGroupCacheHitParamsQueryType = "GID"

const DNSTimeseriesGroupCacheHitParamsQueryTypeHinfo DNSTimeseriesGroupCacheHitParamsQueryType = "HINFO"

const DNSTimeseriesGroupCacheHitParamsQueryTypeHip DNSTimeseriesGroupCacheHitParamsQueryType = "HIP"

const DNSTimeseriesGroupCacheHitParamsQueryTypeHTTPS DNSTimeseriesGroupCacheHitParamsQueryType = "HTTPS"

const DNSTimeseriesGroupCacheHitParamsQueryTypeIpseckey DNSTimeseriesGroupCacheHitParamsQueryType = "IPSECKEY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeIsdn DNSTimeseriesGroupCacheHitParamsQueryType = "ISDN"

const DNSTimeseriesGroupCacheHitParamsQueryTypeIxfr DNSTimeseriesGroupCacheHitParamsQueryType = "IXFR"

const DNSTimeseriesGroupCacheHitParamsQueryTypeKey DNSTimeseriesGroupCacheHitParamsQueryType = "KEY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeKx DNSTimeseriesGroupCacheHitParamsQueryType = "KX"

const DNSTimeseriesGroupCacheHitParamsQueryTypeL32 DNSTimeseriesGroupCacheHitParamsQueryType = "L32"

const DNSTimeseriesGroupCacheHitParamsQueryTypeL64 DNSTimeseriesGroupCacheHitParamsQueryType = "L64"

const DNSTimeseriesGroupCacheHitParamsQueryTypeLOC DNSTimeseriesGroupCacheHitParamsQueryType = "LOC"

const DNSTimeseriesGroupCacheHitParamsQueryTypeLp DNSTimeseriesGroupCacheHitParamsQueryType = "LP"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMaila DNSTimeseriesGroupCacheHitParamsQueryType = "MAILA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMailb DNSTimeseriesGroupCacheHitParamsQueryType = "MAILB"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMB DNSTimeseriesGroupCacheHitParamsQueryType = "MB"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMd DNSTimeseriesGroupCacheHitParamsQueryType = "MD"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMf DNSTimeseriesGroupCacheHitParamsQueryType = "MF"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMg DNSTimeseriesGroupCacheHitParamsQueryType = "MG"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMinfo DNSTimeseriesGroupCacheHitParamsQueryType = "MINFO"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMr DNSTimeseriesGroupCacheHitParamsQueryType = "MR"

const DNSTimeseriesGroupCacheHitParamsQueryTypeMX DNSTimeseriesGroupCacheHitParamsQueryType = "MX"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNAPTR DNSTimeseriesGroupCacheHitParamsQueryType = "NAPTR"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNb DNSTimeseriesGroupCacheHitParamsQueryType = "NB"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNbstat DNSTimeseriesGroupCacheHitParamsQueryType = "NBSTAT"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNid DNSTimeseriesGroupCacheHitParamsQueryType = "NID"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNimloc DNSTimeseriesGroupCacheHitParamsQueryType = "NIMLOC"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNinfo DNSTimeseriesGroupCacheHitParamsQueryType = "NINFO"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNS DNSTimeseriesGroupCacheHitParamsQueryType = "NS"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNsap DNSTimeseriesGroupCacheHitParamsQueryType = "NSAP"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNsec DNSTimeseriesGroupCacheHitParamsQueryType = "NSEC"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNsec3 DNSTimeseriesGroupCacheHitParamsQueryType = "NSEC3"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNsec3Param DNSTimeseriesGroupCacheHitParamsQueryType = "NSEC3PARAM"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNull DNSTimeseriesGroupCacheHitParamsQueryType = "NULL"

const DNSTimeseriesGroupCacheHitParamsQueryTypeNxt DNSTimeseriesGroupCacheHitParamsQueryType = "NXT"

const DNSTimeseriesGroupCacheHitParamsQueryTypeOpenpgpkey DNSTimeseriesGroupCacheHitParamsQueryType = "OPENPGPKEY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeOpt DNSTimeseriesGroupCacheHitParamsQueryType = "OPT"

const DNSTimeseriesGroupCacheHitParamsQueryTypePTR DNSTimeseriesGroupCacheHitParamsQueryType = "PTR"

const DNSTimeseriesGroupCacheHitParamsQueryTypePx DNSTimeseriesGroupCacheHitParamsQueryType = "PX"

const DNSTimeseriesGroupCacheHitParamsQueryTypeRkey DNSTimeseriesGroupCacheHitParamsQueryType = "RKEY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeRp DNSTimeseriesGroupCacheHitParamsQueryType = "RP"

const DNSTimeseriesGroupCacheHitParamsQueryTypeRrsig DNSTimeseriesGroupCacheHitParamsQueryType = "RRSIG"

const DNSTimeseriesGroupCacheHitParamsQueryTypeRt DNSTimeseriesGroupCacheHitParamsQueryType = "RT"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSig DNSTimeseriesGroupCacheHitParamsQueryType = "SIG"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSink DNSTimeseriesGroupCacheHitParamsQueryType = "SINK"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSMIMEA DNSTimeseriesGroupCacheHitParamsQueryType = "SMIMEA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSOA DNSTimeseriesGroupCacheHitParamsQueryType = "SOA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSPF DNSTimeseriesGroupCacheHitParamsQueryType = "SPF"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSRV DNSTimeseriesGroupCacheHitParamsQueryType = "SRV"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSSHFP DNSTimeseriesGroupCacheHitParamsQueryType = "SSHFP"

const DNSTimeseriesGroupCacheHitParamsQueryTypeSVCB DNSTimeseriesGroupCacheHitParamsQueryType = "SVCB"

const DNSTimeseriesGroupCacheHitParamsQueryTypeTa DNSTimeseriesGroupCacheHitParamsQueryType = "TA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeTalink DNSTimeseriesGroupCacheHitParamsQueryType = "TALINK"

const DNSTimeseriesGroupCacheHitParamsQueryTypeTkey DNSTimeseriesGroupCacheHitParamsQueryType = "TKEY"

const DNSTimeseriesGroupCacheHitParamsQueryTypeTLSA DNSTimeseriesGroupCacheHitParamsQueryType = "TLSA"

const DNSTimeseriesGroupCacheHitParamsQueryTypeTSIG DNSTimeseriesGroupCacheHitParamsQueryType = "TSIG"

const DNSTimeseriesGroupCacheHitParamsQueryTypeTXT DNSTimeseriesGroupCacheHitParamsQueryType = "TXT"

const DNSTimeseriesGroupCacheHitParamsQueryTypeUinfo DNSTimeseriesGroupCacheHitParamsQueryType = "UINFO"

const DNSTimeseriesGroupCacheHitParamsQueryTypeUID DNSTimeseriesGroupCacheHitParamsQueryType = "UID"

const DNSTimeseriesGroupCacheHitParamsQueryTypeUnspec DNSTimeseriesGroupCacheHitParamsQueryType = "UNSPEC"

const DNSTimeseriesGroupCacheHitParamsQueryTypeURI DNSTimeseriesGroupCacheHitParamsQueryType = "URI"

const DNSTimeseriesGroupCacheHitParamsQueryTypeWks DNSTimeseriesGroupCacheHitParamsQueryType = "WKS"

const DNSTimeseriesGroupCacheHitParamsQueryTypeX25 DNSTimeseriesGroupCacheHitParamsQueryType = "X25"

const DNSTimeseriesGroupCacheHitParamsQueryTypeZonemd DNSTimeseriesGroupCacheHitParamsQueryType = "ZONEMD"

ResponseCode param.Field[[]DNSTimeseriesGroupCacheHitParamsResponseCode]Optional

Filters results by DNS response code.

const DNSTimeseriesGroupCacheHitParamsResponseCodeNoerror DNSTimeseriesGroupCacheHitParamsResponseCode = "NOERROR"

const DNSTimeseriesGroupCacheHitParamsResponseCodeFormerr DNSTimeseriesGroupCacheHitParamsResponseCode = "FORMERR"

const DNSTimeseriesGroupCacheHitParamsResponseCodeServfail DNSTimeseriesGroupCacheHitParamsResponseCode = "SERVFAIL"

const DNSTimeseriesGroupCacheHitParamsResponseCodeNxdomain DNSTimeseriesGroupCacheHitParamsResponseCode = "NXDOMAIN"

const DNSTimeseriesGroupCacheHitParamsResponseCodeNotimp DNSTimeseriesGroupCacheHitParamsResponseCode = "NOTIMP"

const DNSTimeseriesGroupCacheHitParamsResponseCodeRefused DNSTimeseriesGroupCacheHitParamsResponseCode = "REFUSED"

const DNSTimeseriesGroupCacheHitParamsResponseCodeYxdomain DNSTimeseriesGroupCacheHitParamsResponseCode = "YXDOMAIN"

const DNSTimeseriesGroupCacheHitParamsResponseCodeYxrrset DNSTimeseriesGroupCacheHitParamsResponseCode = "YXRRSET"

const DNSTimeseriesGroupCacheHitParamsResponseCodeNxrrset DNSTimeseriesGroupCacheHitParamsResponseCode = "NXRRSET"

const DNSTimeseriesGroupCacheHitParamsResponseCodeNotauth DNSTimeseriesGroupCacheHitParamsResponseCode = "NOTAUTH"

const DNSTimeseriesGroupCacheHitParamsResponseCodeNotzone DNSTimeseriesGroupCacheHitParamsResponseCode = "NOTZONE"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadsig DNSTimeseriesGroupCacheHitParamsResponseCode = "BADSIG"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadkey DNSTimeseriesGroupCacheHitParamsResponseCode = "BADKEY"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadtime DNSTimeseriesGroupCacheHitParamsResponseCode = "BADTIME"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadmode DNSTimeseriesGroupCacheHitParamsResponseCode = "BADMODE"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadname DNSTimeseriesGroupCacheHitParamsResponseCode = "BADNAME"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadalg DNSTimeseriesGroupCacheHitParamsResponseCode = "BADALG"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadtrunc DNSTimeseriesGroupCacheHitParamsResponseCode = "BADTRUNC"

const DNSTimeseriesGroupCacheHitParamsResponseCodeBadcookie DNSTimeseriesGroupCacheHitParamsResponseCode = "BADCOOKIE"

TLD param.Field[[]string]Optional

Filters results by top-level domain.

ReturnsExpand Collapse

type DNSTimeseriesGroupCacheHitResponse struct{…}

Meta DNSTimeseriesGroupCacheHitResponseMeta

Metadata for the results.

AggInterval DNSTimeseriesGroupCacheHitResponseMetaAggInterval

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

One of the following:

const DNSTimeseriesGroupCacheHitResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupCacheHitResponseMetaAggInterval = "FIFTEEN_MINUTES"

const DNSTimeseriesGroupCacheHitResponseMetaAggIntervalOneHour DNSTimeseriesGroupCacheHitResponseMetaAggInterval = "ONE_HOUR"

const DNSTimeseriesGroupCacheHitResponseMetaAggIntervalOneDay DNSTimeseriesGroupCacheHitResponseMetaAggInterval = "ONE_DAY"

const DNSTimeseriesGroupCacheHitResponseMetaAggIntervalOneWeek DNSTimeseriesGroupCacheHitResponseMetaAggInterval = "ONE_WEEK"

const DNSTimeseriesGroupCacheHitResponseMetaAggIntervalOneMonth DNSTimeseriesGroupCacheHitResponseMetaAggInterval = "ONE_MONTH"

ConfidenceInfo DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfo

Annotations []DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotation

DataSource DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "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 []DNSTimeseriesGroupCacheHitResponseMetaDateRange

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 DNSTimeseriesGroupCacheHitResponseMetaNormalization

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

One of the following:

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationPercentage DNSTimeseriesGroupCacheHitResponseMetaNormalization = "PERCENTAGE"

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationMin0Max DNSTimeseriesGroupCacheHitResponseMetaNormalization = "MIN0_MAX"

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationMinMax DNSTimeseriesGroupCacheHitResponseMetaNormalization = "MIN_MAX"

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationRawValues DNSTimeseriesGroupCacheHitResponseMetaNormalization = "RAW_VALUES"

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationPercentageChange DNSTimeseriesGroupCacheHitResponseMetaNormalization = "PERCENTAGE_CHANGE"

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationRollingAverage DNSTimeseriesGroupCacheHitResponseMetaNormalization = "ROLLING_AVERAGE"

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupCacheHitResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const DNSTimeseriesGroupCacheHitResponseMetaNormalizationRatio DNSTimeseriesGroupCacheHitResponseMetaNormalization = "RATIO"

Units []DNSTimeseriesGroupCacheHitResponseMetaUnit

Measurement units for the results.

Name string

Value string

Serie0 DNSTimeseriesGroupCacheHitResponseSerie0

Negative []string

Positive []string

Get DNS queries by cache status 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.CacheHit(context.TODO(), radar.DNSTimeseriesGroupCacheHitParams{

  })
  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": {
      "NEGATIVE": [
        "10"
      ],
      "POSITIVE": [
        "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": {
      "NEGATIVE": [
        "10"
      ],
      "POSITIVE": [
        "10"
      ]
    }
  },
  "success": true
}