# DNS ## Get DNS summary by dimension `client.Radar.DNS.SummaryV2(ctx, dimension, query) (*DNSSummaryV2Response, error)` **get** `/radar/dns/summary/{dimension}` Retrieves the distribution of DNS queries by the specified dimension. ### Parameters - `dimension DNSSummaryV2ParamsDimension` Specifies the attribute by which to group the results. Grouping by `TLD_DNS_MAGNITUDE` does not support sub-daily aggregation intervals; `15m` and `1h` are raised to `1d`. - `const DNSSummaryV2ParamsDimensionAs DNSSummaryV2ParamsDimension = "AS"` - `const DNSSummaryV2ParamsDimensionCacheHit DNSSummaryV2ParamsDimension = "CACHE_HIT"` - `const DNSSummaryV2ParamsDimensionDNSSEC DNSSummaryV2ParamsDimension = "DNSSEC"` - `const DNSSummaryV2ParamsDimensionDNSSECAware DNSSummaryV2ParamsDimension = "DNSSEC_AWARE"` - `const DNSSummaryV2ParamsDimensionDNSSECE2E DNSSummaryV2ParamsDimension = "DNSSEC_E2E"` - `const DNSSummaryV2ParamsDimensionIPVersion DNSSummaryV2ParamsDimension = "IP_VERSION"` - `const DNSSummaryV2ParamsDimensionLocation DNSSummaryV2ParamsDimension = "LOCATION"` - `const DNSSummaryV2ParamsDimensionMatchingAnswer DNSSummaryV2ParamsDimension = "MATCHING_ANSWER"` - `const DNSSummaryV2ParamsDimensionProtocol DNSSummaryV2ParamsDimension = "PROTOCOL"` - `const DNSSummaryV2ParamsDimensionQueryType DNSSummaryV2ParamsDimension = "QUERY_TYPE"` - `const DNSSummaryV2ParamsDimensionResponseCode DNSSummaryV2ParamsDimension = "RESPONSE_CODE"` - `const DNSSummaryV2ParamsDimensionResponseTTL DNSSummaryV2ParamsDimension = "RESPONSE_TTL"` - `const DNSSummaryV2ParamsDimensionTLD DNSSummaryV2ParamsDimension = "TLD"` - `const DNSSummaryV2ParamsDimensionTLDDNSMagnitude DNSSummaryV2ParamsDimension = "TLD_DNS_MAGNITUDE"` - `query DNSSummaryV2Params` - `ASN param.Field[[]string]` 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. - `CacheHit param.Field[[]bool]` Filters results based on cache status. - `Continent param.Field[[]string]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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. - `DNSSEC param.Field[[]DNSSummaryV2ParamsDNSSEC]` Filters results based on DNSSEC (DNS Security Extensions) support. - `const DNSSummaryV2ParamsDNSSECInvalid DNSSummaryV2ParamsDNSSEC = "INVALID"` - `const DNSSummaryV2ParamsDNSSECInsecure DNSSummaryV2ParamsDNSSEC = "INSECURE"` - `const DNSSummaryV2ParamsDNSSECSecure DNSSummaryV2ParamsDNSSEC = "SECURE"` - `const DNSSummaryV2ParamsDNSSECOther DNSSummaryV2ParamsDNSSEC = "OTHER"` - `DNSSECAware param.Field[[]DNSSummaryV2ParamsDNSSECAware]` Filters results based on DNSSEC (DNS Security Extensions) client awareness. - `const DNSSummaryV2ParamsDNSSECAwareSupported DNSSummaryV2ParamsDNSSECAware = "SUPPORTED"` - `const DNSSummaryV2ParamsDNSSECAwareNotSupported DNSSummaryV2ParamsDNSSECAware = "NOT_SUPPORTED"` - `DNSSECE2E param.Field[[]bool]` Filters results based on DNSSEC-validated answers by end-to-end security status. - `Format param.Field[DNSSummaryV2ParamsFormat]` Format in which results will be returned. - `const DNSSummaryV2ParamsFormatJson DNSSummaryV2ParamsFormat = "JSON"` - `const DNSSummaryV2ParamsFormatCsv DNSSummaryV2ParamsFormat = "CSV"` - `IPVersion param.Field[[]DNSSummaryV2ParamsIPVersion]` Filters results by IP version (Ipv4 vs. IPv6). - `const DNSSummaryV2ParamsIPVersionIPv4 DNSSummaryV2ParamsIPVersion = "IPv4"` - `const DNSSummaryV2ParamsIPVersionIPv6 DNSSummaryV2ParamsIPVersion = "IPv6"` - `LimitPerGroup param.Field[int64]` Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category. Only supported on high-cardinality dimensions; otherwise the request is rejected. Minimum value is 2. - `Location param.Field[[]string]` 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. - `MatchingAnswer param.Field[[]bool]` Filters results based on whether the queries have a matching answer. - `Name param.Field[[]string]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryV2ParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryV2ParamsProtocolUdp DNSSummaryV2ParamsProtocol = "UDP"` - `const DNSSummaryV2ParamsProtocolTCP DNSSummaryV2ParamsProtocol = "TCP"` - `const DNSSummaryV2ParamsProtocolHTTPS DNSSummaryV2ParamsProtocol = "HTTPS"` - `const DNSSummaryV2ParamsProtocolTLS DNSSummaryV2ParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryV2ParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryV2ParamsQueryTypeA DNSSummaryV2ParamsQueryType = "A"` - `const DNSSummaryV2ParamsQueryTypeAAAA DNSSummaryV2ParamsQueryType = "AAAA"` - `const DNSSummaryV2ParamsQueryTypeA6 DNSSummaryV2ParamsQueryType = "A6"` - `const DNSSummaryV2ParamsQueryTypeAfsdb DNSSummaryV2ParamsQueryType = "AFSDB"` - `const DNSSummaryV2ParamsQueryTypeAny DNSSummaryV2ParamsQueryType = "ANY"` - `const DNSSummaryV2ParamsQueryTypeApl DNSSummaryV2ParamsQueryType = "APL"` - `const DNSSummaryV2ParamsQueryTypeAtma DNSSummaryV2ParamsQueryType = "ATMA"` - `const DNSSummaryV2ParamsQueryTypeAXFR DNSSummaryV2ParamsQueryType = "AXFR"` - `const DNSSummaryV2ParamsQueryTypeCAA DNSSummaryV2ParamsQueryType = "CAA"` - `const DNSSummaryV2ParamsQueryTypeCdnskey DNSSummaryV2ParamsQueryType = "CDNSKEY"` - `const DNSSummaryV2ParamsQueryTypeCds DNSSummaryV2ParamsQueryType = "CDS"` - `const DNSSummaryV2ParamsQueryTypeCERT DNSSummaryV2ParamsQueryType = "CERT"` - `const DNSSummaryV2ParamsQueryTypeCNAME DNSSummaryV2ParamsQueryType = "CNAME"` - `const DNSSummaryV2ParamsQueryTypeCsync DNSSummaryV2ParamsQueryType = "CSYNC"` - `const DNSSummaryV2ParamsQueryTypeDhcid DNSSummaryV2ParamsQueryType = "DHCID"` - `const DNSSummaryV2ParamsQueryTypeDlv DNSSummaryV2ParamsQueryType = "DLV"` - `const DNSSummaryV2ParamsQueryTypeDname DNSSummaryV2ParamsQueryType = "DNAME"` - `const DNSSummaryV2ParamsQueryTypeDNSKEY DNSSummaryV2ParamsQueryType = "DNSKEY"` - `const DNSSummaryV2ParamsQueryTypeDoa DNSSummaryV2ParamsQueryType = "DOA"` - `const DNSSummaryV2ParamsQueryTypeDS DNSSummaryV2ParamsQueryType = "DS"` - `const DNSSummaryV2ParamsQueryTypeEid DNSSummaryV2ParamsQueryType = "EID"` - `const DNSSummaryV2ParamsQueryTypeEui48 DNSSummaryV2ParamsQueryType = "EUI48"` - `const DNSSummaryV2ParamsQueryTypeEui64 DNSSummaryV2ParamsQueryType = "EUI64"` - `const DNSSummaryV2ParamsQueryTypeGpos DNSSummaryV2ParamsQueryType = "GPOS"` - `const DNSSummaryV2ParamsQueryTypeGid DNSSummaryV2ParamsQueryType = "GID"` - `const DNSSummaryV2ParamsQueryTypeHinfo DNSSummaryV2ParamsQueryType = "HINFO"` - `const DNSSummaryV2ParamsQueryTypeHip DNSSummaryV2ParamsQueryType = "HIP"` - `const DNSSummaryV2ParamsQueryTypeHTTPS DNSSummaryV2ParamsQueryType = "HTTPS"` - `const DNSSummaryV2ParamsQueryTypeIpseckey DNSSummaryV2ParamsQueryType = "IPSECKEY"` - `const DNSSummaryV2ParamsQueryTypeIsdn DNSSummaryV2ParamsQueryType = "ISDN"` - `const DNSSummaryV2ParamsQueryTypeIxfr DNSSummaryV2ParamsQueryType = "IXFR"` - `const DNSSummaryV2ParamsQueryTypeKey DNSSummaryV2ParamsQueryType = "KEY"` - `const DNSSummaryV2ParamsQueryTypeKx DNSSummaryV2ParamsQueryType = "KX"` - `const DNSSummaryV2ParamsQueryTypeL32 DNSSummaryV2ParamsQueryType = "L32"` - `const DNSSummaryV2ParamsQueryTypeL64 DNSSummaryV2ParamsQueryType = "L64"` - `const DNSSummaryV2ParamsQueryTypeLOC DNSSummaryV2ParamsQueryType = "LOC"` - `const DNSSummaryV2ParamsQueryTypeLp DNSSummaryV2ParamsQueryType = "LP"` - `const DNSSummaryV2ParamsQueryTypeMaila DNSSummaryV2ParamsQueryType = "MAILA"` - `const DNSSummaryV2ParamsQueryTypeMailb DNSSummaryV2ParamsQueryType = "MAILB"` - `const DNSSummaryV2ParamsQueryTypeMB DNSSummaryV2ParamsQueryType = "MB"` - `const DNSSummaryV2ParamsQueryTypeMd DNSSummaryV2ParamsQueryType = "MD"` - `const DNSSummaryV2ParamsQueryTypeMf DNSSummaryV2ParamsQueryType = "MF"` - `const DNSSummaryV2ParamsQueryTypeMg DNSSummaryV2ParamsQueryType = "MG"` - `const DNSSummaryV2ParamsQueryTypeMinfo DNSSummaryV2ParamsQueryType = "MINFO"` - `const DNSSummaryV2ParamsQueryTypeMr DNSSummaryV2ParamsQueryType = "MR"` - `const DNSSummaryV2ParamsQueryTypeMX DNSSummaryV2ParamsQueryType = "MX"` - `const DNSSummaryV2ParamsQueryTypeNAPTR DNSSummaryV2ParamsQueryType = "NAPTR"` - `const DNSSummaryV2ParamsQueryTypeNb DNSSummaryV2ParamsQueryType = "NB"` - `const DNSSummaryV2ParamsQueryTypeNbstat DNSSummaryV2ParamsQueryType = "NBSTAT"` - `const DNSSummaryV2ParamsQueryTypeNid DNSSummaryV2ParamsQueryType = "NID"` - `const DNSSummaryV2ParamsQueryTypeNimloc DNSSummaryV2ParamsQueryType = "NIMLOC"` - `const DNSSummaryV2ParamsQueryTypeNinfo DNSSummaryV2ParamsQueryType = "NINFO"` - `const DNSSummaryV2ParamsQueryTypeNS DNSSummaryV2ParamsQueryType = "NS"` - `const DNSSummaryV2ParamsQueryTypeNsap DNSSummaryV2ParamsQueryType = "NSAP"` - `const DNSSummaryV2ParamsQueryTypeNsec DNSSummaryV2ParamsQueryType = "NSEC"` - `const DNSSummaryV2ParamsQueryTypeNsec3 DNSSummaryV2ParamsQueryType = "NSEC3"` - `const DNSSummaryV2ParamsQueryTypeNsec3Param DNSSummaryV2ParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryV2ParamsQueryTypeNull DNSSummaryV2ParamsQueryType = "NULL"` - `const DNSSummaryV2ParamsQueryTypeNxt DNSSummaryV2ParamsQueryType = "NXT"` - `const DNSSummaryV2ParamsQueryTypeOpenpgpkey DNSSummaryV2ParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryV2ParamsQueryTypeOpt DNSSummaryV2ParamsQueryType = "OPT"` - `const DNSSummaryV2ParamsQueryTypePTR DNSSummaryV2ParamsQueryType = "PTR"` - `const DNSSummaryV2ParamsQueryTypePx DNSSummaryV2ParamsQueryType = "PX"` - `const DNSSummaryV2ParamsQueryTypeRkey DNSSummaryV2ParamsQueryType = "RKEY"` - `const DNSSummaryV2ParamsQueryTypeRp DNSSummaryV2ParamsQueryType = "RP"` - `const DNSSummaryV2ParamsQueryTypeRrsig DNSSummaryV2ParamsQueryType = "RRSIG"` - `const DNSSummaryV2ParamsQueryTypeRt DNSSummaryV2ParamsQueryType = "RT"` - `const DNSSummaryV2ParamsQueryTypeSig DNSSummaryV2ParamsQueryType = "SIG"` - `const DNSSummaryV2ParamsQueryTypeSink DNSSummaryV2ParamsQueryType = "SINK"` - `const DNSSummaryV2ParamsQueryTypeSMIMEA DNSSummaryV2ParamsQueryType = "SMIMEA"` - `const DNSSummaryV2ParamsQueryTypeSOA DNSSummaryV2ParamsQueryType = "SOA"` - `const DNSSummaryV2ParamsQueryTypeSPF DNSSummaryV2ParamsQueryType = "SPF"` - `const DNSSummaryV2ParamsQueryTypeSRV DNSSummaryV2ParamsQueryType = "SRV"` - `const DNSSummaryV2ParamsQueryTypeSSHFP DNSSummaryV2ParamsQueryType = "SSHFP"` - `const DNSSummaryV2ParamsQueryTypeSVCB DNSSummaryV2ParamsQueryType = "SVCB"` - `const DNSSummaryV2ParamsQueryTypeTa DNSSummaryV2ParamsQueryType = "TA"` - `const DNSSummaryV2ParamsQueryTypeTalink DNSSummaryV2ParamsQueryType = "TALINK"` - `const DNSSummaryV2ParamsQueryTypeTkey DNSSummaryV2ParamsQueryType = "TKEY"` - `const DNSSummaryV2ParamsQueryTypeTLSA DNSSummaryV2ParamsQueryType = "TLSA"` - `const DNSSummaryV2ParamsQueryTypeTSIG DNSSummaryV2ParamsQueryType = "TSIG"` - `const DNSSummaryV2ParamsQueryTypeTXT DNSSummaryV2ParamsQueryType = "TXT"` - `const DNSSummaryV2ParamsQueryTypeUinfo DNSSummaryV2ParamsQueryType = "UINFO"` - `const DNSSummaryV2ParamsQueryTypeUID DNSSummaryV2ParamsQueryType = "UID"` - `const DNSSummaryV2ParamsQueryTypeUnspec DNSSummaryV2ParamsQueryType = "UNSPEC"` - `const DNSSummaryV2ParamsQueryTypeURI DNSSummaryV2ParamsQueryType = "URI"` - `const DNSSummaryV2ParamsQueryTypeWks DNSSummaryV2ParamsQueryType = "WKS"` - `const DNSSummaryV2ParamsQueryTypeX25 DNSSummaryV2ParamsQueryType = "X25"` - `const DNSSummaryV2ParamsQueryTypeZonemd DNSSummaryV2ParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryV2ParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryV2ParamsResponseCodeNoerror DNSSummaryV2ParamsResponseCode = "NOERROR"` - `const DNSSummaryV2ParamsResponseCodeFormerr DNSSummaryV2ParamsResponseCode = "FORMERR"` - `const DNSSummaryV2ParamsResponseCodeServfail DNSSummaryV2ParamsResponseCode = "SERVFAIL"` - `const DNSSummaryV2ParamsResponseCodeNxdomain DNSSummaryV2ParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryV2ParamsResponseCodeNotimp DNSSummaryV2ParamsResponseCode = "NOTIMP"` - `const DNSSummaryV2ParamsResponseCodeRefused DNSSummaryV2ParamsResponseCode = "REFUSED"` - `const DNSSummaryV2ParamsResponseCodeYxdomain DNSSummaryV2ParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryV2ParamsResponseCodeYxrrset DNSSummaryV2ParamsResponseCode = "YXRRSET"` - `const DNSSummaryV2ParamsResponseCodeNxrrset DNSSummaryV2ParamsResponseCode = "NXRRSET"` - `const DNSSummaryV2ParamsResponseCodeNotauth DNSSummaryV2ParamsResponseCode = "NOTAUTH"` - `const DNSSummaryV2ParamsResponseCodeNotzone DNSSummaryV2ParamsResponseCode = "NOTZONE"` - `const DNSSummaryV2ParamsResponseCodeBadsig DNSSummaryV2ParamsResponseCode = "BADSIG"` - `const DNSSummaryV2ParamsResponseCodeBadkey DNSSummaryV2ParamsResponseCode = "BADKEY"` - `const DNSSummaryV2ParamsResponseCodeBadtime DNSSummaryV2ParamsResponseCode = "BADTIME"` - `const DNSSummaryV2ParamsResponseCodeBadmode DNSSummaryV2ParamsResponseCode = "BADMODE"` - `const DNSSummaryV2ParamsResponseCodeBadname DNSSummaryV2ParamsResponseCode = "BADNAME"` - `const DNSSummaryV2ParamsResponseCodeBadalg DNSSummaryV2ParamsResponseCode = "BADALG"` - `const DNSSummaryV2ParamsResponseCodeBadtrunc DNSSummaryV2ParamsResponseCode = "BADTRUNC"` - `const DNSSummaryV2ParamsResponseCodeBadcookie DNSSummaryV2ParamsResponseCode = "BADCOOKIE"` - `ResponseTTL param.Field[[]DNSSummaryV2ParamsResponseTTL]` Filters results by DNS response TTL. - `const DNSSummaryV2ParamsResponseTTLLte1M DNSSummaryV2ParamsResponseTTL = "LTE_1M"` - `const DNSSummaryV2ParamsResponseTTLGt1MLte5M DNSSummaryV2ParamsResponseTTL = "GT_1M_LTE_5M"` - `const DNSSummaryV2ParamsResponseTTLGt5MLte15M DNSSummaryV2ParamsResponseTTL = "GT_5M_LTE_15M"` - `const DNSSummaryV2ParamsResponseTTLGt15MLte1H DNSSummaryV2ParamsResponseTTL = "GT_15M_LTE_1H"` - `const DNSSummaryV2ParamsResponseTTLGt1HLte1D DNSSummaryV2ParamsResponseTTL = "GT_1H_LTE_1D"` - `const DNSSummaryV2ParamsResponseTTLGt1DLte1W DNSSummaryV2ParamsResponseTTL = "GT_1D_LTE_1W"` - `const DNSSummaryV2ParamsResponseTTLGt1W DNSSummaryV2ParamsResponseTTL = "GT_1W"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryV2Response struct{…}` - `Meta DNSSummaryV2ResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryV2ResponseMetaConfidenceInfo` - `Annotations []DNSSummaryV2ResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryV2ResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryV2ResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryV2ResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryV2ResponseMetaNormalizationPercentage DNSSummaryV2ResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryV2ResponseMetaNormalizationMin0Max DNSSummaryV2ResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryV2ResponseMetaNormalizationMinMax DNSSummaryV2ResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryV2ResponseMetaNormalizationRawValues DNSSummaryV2ResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryV2ResponseMetaNormalizationPercentageChange DNSSummaryV2ResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryV2ResponseMetaNormalizationRollingAverage DNSSummaryV2ResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryV2ResponseMetaNormalizationOverlappedPercentage DNSSummaryV2ResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryV2ResponseMetaNormalizationRatio DNSSummaryV2ResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryV2ResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 map[string, string]` ### Example ```go 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.SummaryV2( context.TODO(), radar.DNSSummaryV2ParamsDimensionAs, radar.DNSSummaryV2Params{ }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "IPv4": "50.168733", "IPv6": "25.084366" } }, "success": true } ``` ## Get DNS queries time series `client.Radar.DNS.Timeseries(ctx, query) (*DNSTimeseriesResponse, error)` **get** `/radar/dns/timeseries` Retrieves normalized query volume to the 1.1.1.1 DNS resolver over time. ### Parameters - `query DNSTimeseriesParams` - `AggInterval param.Field[DNSTimeseriesParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesParamsAggInterval15m DNSTimeseriesParamsAggInterval = "15m"` - `const DNSTimeseriesParamsAggInterval1h DNSTimeseriesParamsAggInterval = "1h"` - `const DNSTimeseriesParamsAggInterval1d DNSTimeseriesParamsAggInterval = "1d"` - `const DNSTimeseriesParamsAggInterval1w DNSTimeseriesParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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. - `CacheHit param.Field[[]bool]` Filters results based on cache status. - `Continent param.Field[[]string]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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. - `DNSSEC param.Field[[]DNSTimeseriesParamsDNSSEC]` Filters results based on DNSSEC (DNS Security Extensions) support. - `const DNSTimeseriesParamsDNSSECInvalid DNSTimeseriesParamsDNSSEC = "INVALID"` - `const DNSTimeseriesParamsDNSSECInsecure DNSTimeseriesParamsDNSSEC = "INSECURE"` - `const DNSTimeseriesParamsDNSSECSecure DNSTimeseriesParamsDNSSEC = "SECURE"` - `const DNSTimeseriesParamsDNSSECOther DNSTimeseriesParamsDNSSEC = "OTHER"` - `DNSSECAware param.Field[[]DNSTimeseriesParamsDNSSECAware]` Filters results based on DNSSEC (DNS Security Extensions) client awareness. - `const DNSTimeseriesParamsDNSSECAwareSupported DNSTimeseriesParamsDNSSECAware = "SUPPORTED"` - `const DNSTimeseriesParamsDNSSECAwareNotSupported DNSTimeseriesParamsDNSSECAware = "NOT_SUPPORTED"` - `DNSSECE2E param.Field[[]bool]` Filters results based on DNSSEC-validated answers by end-to-end security status. - `Format param.Field[DNSTimeseriesParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesParamsFormatJson DNSTimeseriesParamsFormat = "JSON"` - `const DNSTimeseriesParamsFormatCsv DNSTimeseriesParamsFormat = "CSV"` - `IPVersion param.Field[[]DNSTimeseriesParamsIPVersion]` Filters results by IP version (Ipv4 vs. IPv6). - `const DNSTimeseriesParamsIPVersionIPv4 DNSTimeseriesParamsIPVersion = "IPv4"` - `const DNSTimeseriesParamsIPVersionIPv6 DNSTimeseriesParamsIPVersion = "IPv6"` - `Location param.Field[[]string]` 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. - `MatchingAnswer param.Field[[]bool]` Filters results based on whether the queries have a matching answer. - `Name param.Field[[]string]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesParamsProtocolUdp DNSTimeseriesParamsProtocol = "UDP"` - `const DNSTimeseriesParamsProtocolTCP DNSTimeseriesParamsProtocol = "TCP"` - `const DNSTimeseriesParamsProtocolHTTPS DNSTimeseriesParamsProtocol = "HTTPS"` - `const DNSTimeseriesParamsProtocolTLS DNSTimeseriesParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesParamsQueryTypeA DNSTimeseriesParamsQueryType = "A"` - `const DNSTimeseriesParamsQueryTypeAAAA DNSTimeseriesParamsQueryType = "AAAA"` - `const DNSTimeseriesParamsQueryTypeA6 DNSTimeseriesParamsQueryType = "A6"` - `const DNSTimeseriesParamsQueryTypeAfsdb DNSTimeseriesParamsQueryType = "AFSDB"` - `const DNSTimeseriesParamsQueryTypeAny DNSTimeseriesParamsQueryType = "ANY"` - `const DNSTimeseriesParamsQueryTypeApl DNSTimeseriesParamsQueryType = "APL"` - `const DNSTimeseriesParamsQueryTypeAtma DNSTimeseriesParamsQueryType = "ATMA"` - `const DNSTimeseriesParamsQueryTypeAXFR DNSTimeseriesParamsQueryType = "AXFR"` - `const DNSTimeseriesParamsQueryTypeCAA DNSTimeseriesParamsQueryType = "CAA"` - `const DNSTimeseriesParamsQueryTypeCdnskey DNSTimeseriesParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesParamsQueryTypeCds DNSTimeseriesParamsQueryType = "CDS"` - `const DNSTimeseriesParamsQueryTypeCERT DNSTimeseriesParamsQueryType = "CERT"` - `const DNSTimeseriesParamsQueryTypeCNAME DNSTimeseriesParamsQueryType = "CNAME"` - `const DNSTimeseriesParamsQueryTypeCsync DNSTimeseriesParamsQueryType = "CSYNC"` - `const DNSTimeseriesParamsQueryTypeDhcid DNSTimeseriesParamsQueryType = "DHCID"` - `const DNSTimeseriesParamsQueryTypeDlv DNSTimeseriesParamsQueryType = "DLV"` - `const DNSTimeseriesParamsQueryTypeDname DNSTimeseriesParamsQueryType = "DNAME"` - `const DNSTimeseriesParamsQueryTypeDNSKEY DNSTimeseriesParamsQueryType = "DNSKEY"` - `const DNSTimeseriesParamsQueryTypeDoa DNSTimeseriesParamsQueryType = "DOA"` - `const DNSTimeseriesParamsQueryTypeDS DNSTimeseriesParamsQueryType = "DS"` - `const DNSTimeseriesParamsQueryTypeEid DNSTimeseriesParamsQueryType = "EID"` - `const DNSTimeseriesParamsQueryTypeEui48 DNSTimeseriesParamsQueryType = "EUI48"` - `const DNSTimeseriesParamsQueryTypeEui64 DNSTimeseriesParamsQueryType = "EUI64"` - `const DNSTimeseriesParamsQueryTypeGpos DNSTimeseriesParamsQueryType = "GPOS"` - `const DNSTimeseriesParamsQueryTypeGid DNSTimeseriesParamsQueryType = "GID"` - `const DNSTimeseriesParamsQueryTypeHinfo DNSTimeseriesParamsQueryType = "HINFO"` - `const DNSTimeseriesParamsQueryTypeHip DNSTimeseriesParamsQueryType = "HIP"` - `const DNSTimeseriesParamsQueryTypeHTTPS DNSTimeseriesParamsQueryType = "HTTPS"` - `const DNSTimeseriesParamsQueryTypeIpseckey DNSTimeseriesParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesParamsQueryTypeIsdn DNSTimeseriesParamsQueryType = "ISDN"` - `const DNSTimeseriesParamsQueryTypeIxfr DNSTimeseriesParamsQueryType = "IXFR"` - `const DNSTimeseriesParamsQueryTypeKey DNSTimeseriesParamsQueryType = "KEY"` - `const DNSTimeseriesParamsQueryTypeKx DNSTimeseriesParamsQueryType = "KX"` - `const DNSTimeseriesParamsQueryTypeL32 DNSTimeseriesParamsQueryType = "L32"` - `const DNSTimeseriesParamsQueryTypeL64 DNSTimeseriesParamsQueryType = "L64"` - `const DNSTimeseriesParamsQueryTypeLOC DNSTimeseriesParamsQueryType = "LOC"` - `const DNSTimeseriesParamsQueryTypeLp DNSTimeseriesParamsQueryType = "LP"` - `const DNSTimeseriesParamsQueryTypeMaila DNSTimeseriesParamsQueryType = "MAILA"` - `const DNSTimeseriesParamsQueryTypeMailb DNSTimeseriesParamsQueryType = "MAILB"` - `const DNSTimeseriesParamsQueryTypeMB DNSTimeseriesParamsQueryType = "MB"` - `const DNSTimeseriesParamsQueryTypeMd DNSTimeseriesParamsQueryType = "MD"` - `const DNSTimeseriesParamsQueryTypeMf DNSTimeseriesParamsQueryType = "MF"` - `const DNSTimeseriesParamsQueryTypeMg DNSTimeseriesParamsQueryType = "MG"` - `const DNSTimeseriesParamsQueryTypeMinfo DNSTimeseriesParamsQueryType = "MINFO"` - `const DNSTimeseriesParamsQueryTypeMr DNSTimeseriesParamsQueryType = "MR"` - `const DNSTimeseriesParamsQueryTypeMX DNSTimeseriesParamsQueryType = "MX"` - `const DNSTimeseriesParamsQueryTypeNAPTR DNSTimeseriesParamsQueryType = "NAPTR"` - `const DNSTimeseriesParamsQueryTypeNb DNSTimeseriesParamsQueryType = "NB"` - `const DNSTimeseriesParamsQueryTypeNbstat DNSTimeseriesParamsQueryType = "NBSTAT"` - `const DNSTimeseriesParamsQueryTypeNid DNSTimeseriesParamsQueryType = "NID"` - `const DNSTimeseriesParamsQueryTypeNimloc DNSTimeseriesParamsQueryType = "NIMLOC"` - `const DNSTimeseriesParamsQueryTypeNinfo DNSTimeseriesParamsQueryType = "NINFO"` - `const DNSTimeseriesParamsQueryTypeNS DNSTimeseriesParamsQueryType = "NS"` - `const DNSTimeseriesParamsQueryTypeNsap DNSTimeseriesParamsQueryType = "NSAP"` - `const DNSTimeseriesParamsQueryTypeNsec DNSTimeseriesParamsQueryType = "NSEC"` - `const DNSTimeseriesParamsQueryTypeNsec3 DNSTimeseriesParamsQueryType = "NSEC3"` - `const DNSTimeseriesParamsQueryTypeNsec3Param DNSTimeseriesParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesParamsQueryTypeNull DNSTimeseriesParamsQueryType = "NULL"` - `const DNSTimeseriesParamsQueryTypeNxt DNSTimeseriesParamsQueryType = "NXT"` - `const DNSTimeseriesParamsQueryTypeOpenpgpkey DNSTimeseriesParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesParamsQueryTypeOpt DNSTimeseriesParamsQueryType = "OPT"` - `const DNSTimeseriesParamsQueryTypePTR DNSTimeseriesParamsQueryType = "PTR"` - `const DNSTimeseriesParamsQueryTypePx DNSTimeseriesParamsQueryType = "PX"` - `const DNSTimeseriesParamsQueryTypeRkey DNSTimeseriesParamsQueryType = "RKEY"` - `const DNSTimeseriesParamsQueryTypeRp DNSTimeseriesParamsQueryType = "RP"` - `const DNSTimeseriesParamsQueryTypeRrsig DNSTimeseriesParamsQueryType = "RRSIG"` - `const DNSTimeseriesParamsQueryTypeRt DNSTimeseriesParamsQueryType = "RT"` - `const DNSTimeseriesParamsQueryTypeSig DNSTimeseriesParamsQueryType = "SIG"` - `const DNSTimeseriesParamsQueryTypeSink DNSTimeseriesParamsQueryType = "SINK"` - `const DNSTimeseriesParamsQueryTypeSMIMEA DNSTimeseriesParamsQueryType = "SMIMEA"` - `const DNSTimeseriesParamsQueryTypeSOA DNSTimeseriesParamsQueryType = "SOA"` - `const DNSTimeseriesParamsQueryTypeSPF DNSTimeseriesParamsQueryType = "SPF"` - `const DNSTimeseriesParamsQueryTypeSRV DNSTimeseriesParamsQueryType = "SRV"` - `const DNSTimeseriesParamsQueryTypeSSHFP DNSTimeseriesParamsQueryType = "SSHFP"` - `const DNSTimeseriesParamsQueryTypeSVCB DNSTimeseriesParamsQueryType = "SVCB"` - `const DNSTimeseriesParamsQueryTypeTa DNSTimeseriesParamsQueryType = "TA"` - `const DNSTimeseriesParamsQueryTypeTalink DNSTimeseriesParamsQueryType = "TALINK"` - `const DNSTimeseriesParamsQueryTypeTkey DNSTimeseriesParamsQueryType = "TKEY"` - `const DNSTimeseriesParamsQueryTypeTLSA DNSTimeseriesParamsQueryType = "TLSA"` - `const DNSTimeseriesParamsQueryTypeTSIG DNSTimeseriesParamsQueryType = "TSIG"` - `const DNSTimeseriesParamsQueryTypeTXT DNSTimeseriesParamsQueryType = "TXT"` - `const DNSTimeseriesParamsQueryTypeUinfo DNSTimeseriesParamsQueryType = "UINFO"` - `const DNSTimeseriesParamsQueryTypeUID DNSTimeseriesParamsQueryType = "UID"` - `const DNSTimeseriesParamsQueryTypeUnspec DNSTimeseriesParamsQueryType = "UNSPEC"` - `const DNSTimeseriesParamsQueryTypeURI DNSTimeseriesParamsQueryType = "URI"` - `const DNSTimeseriesParamsQueryTypeWks DNSTimeseriesParamsQueryType = "WKS"` - `const DNSTimeseriesParamsQueryTypeX25 DNSTimeseriesParamsQueryType = "X25"` - `const DNSTimeseriesParamsQueryTypeZonemd DNSTimeseriesParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesParamsResponseCodeNoerror DNSTimeseriesParamsResponseCode = "NOERROR"` - `const DNSTimeseriesParamsResponseCodeFormerr DNSTimeseriesParamsResponseCode = "FORMERR"` - `const DNSTimeseriesParamsResponseCodeServfail DNSTimeseriesParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesParamsResponseCodeNxdomain DNSTimeseriesParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesParamsResponseCodeNotimp DNSTimeseriesParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesParamsResponseCodeRefused DNSTimeseriesParamsResponseCode = "REFUSED"` - `const DNSTimeseriesParamsResponseCodeYxdomain DNSTimeseriesParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesParamsResponseCodeYxrrset DNSTimeseriesParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesParamsResponseCodeNxrrset DNSTimeseriesParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesParamsResponseCodeNotauth DNSTimeseriesParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesParamsResponseCodeNotzone DNSTimeseriesParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesParamsResponseCodeBadsig DNSTimeseriesParamsResponseCode = "BADSIG"` - `const DNSTimeseriesParamsResponseCodeBadkey DNSTimeseriesParamsResponseCode = "BADKEY"` - `const DNSTimeseriesParamsResponseCodeBadtime DNSTimeseriesParamsResponseCode = "BADTIME"` - `const DNSTimeseriesParamsResponseCodeBadmode DNSTimeseriesParamsResponseCode = "BADMODE"` - `const DNSTimeseriesParamsResponseCodeBadname DNSTimeseriesParamsResponseCode = "BADNAME"` - `const DNSTimeseriesParamsResponseCodeBadalg DNSTimeseriesParamsResponseCode = "BADALG"` - `const DNSTimeseriesParamsResponseCodeBadtrunc DNSTimeseriesParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesParamsResponseCodeBadcookie DNSTimeseriesParamsResponseCode = "BADCOOKIE"` - `ResponseTTL param.Field[[]DNSTimeseriesParamsResponseTTL]` Filters results by DNS response TTL. - `const DNSTimeseriesParamsResponseTTLLte1M DNSTimeseriesParamsResponseTTL = "LTE_1M"` - `const DNSTimeseriesParamsResponseTTLGt1MLte5M DNSTimeseriesParamsResponseTTL = "GT_1M_LTE_5M"` - `const DNSTimeseriesParamsResponseTTLGt5MLte15M DNSTimeseriesParamsResponseTTL = "GT_5M_LTE_15M"` - `const DNSTimeseriesParamsResponseTTLGt15MLte1H DNSTimeseriesParamsResponseTTL = "GT_15M_LTE_1H"` - `const DNSTimeseriesParamsResponseTTLGt1HLte1D DNSTimeseriesParamsResponseTTL = "GT_1H_LTE_1D"` - `const DNSTimeseriesParamsResponseTTLGt1DLte1W DNSTimeseriesParamsResponseTTL = "GT_1D_LTE_1W"` - `const DNSTimeseriesParamsResponseTTLGt1W DNSTimeseriesParamsResponseTTL = "GT_1W"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesResponse struct{…}` - `Meta DNSTimeseriesResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesResponseMetaAggIntervalFifteenMinutes DNSTimeseriesResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesResponseMetaAggIntervalOneHour DNSTimeseriesResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesResponseMetaAggIntervalOneDay DNSTimeseriesResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesResponseMetaAggIntervalOneWeek DNSTimeseriesResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesResponseMetaAggIntervalOneMonth DNSTimeseriesResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesResponseMetaNormalizationPercentage DNSTimeseriesResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesResponseMetaNormalizationMin0Max DNSTimeseriesResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesResponseMetaNormalizationMinMax DNSTimeseriesResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesResponseMetaNormalizationRawValues DNSTimeseriesResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesResponseMetaNormalizationPercentageChange DNSTimeseriesResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesResponseMetaNormalizationRollingAverage DNSTimeseriesResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesResponseMetaNormalizationOverlappedPercentage DNSTimeseriesResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesResponseMetaNormalizationRatio DNSTimeseriesResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` ### Example ```go 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.Timeseries(context.TODO(), radar.DNSTimeseriesParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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" } ] } }, "success": true } ``` ## Get DNS time series grouped by dimension `client.Radar.DNS.TimeseriesGroupsV2(ctx, dimension, query) (*DNSTimeseriesGroupsV2Response, error)` **get** `/radar/dns/timeseries_groups/{dimension}` Retrieves the distribution of DNS queries grouped by dimension over time. ### Parameters - `dimension DNSTimeseriesGroupsV2ParamsDimension` Specifies the attribute by which to group the results. Grouping by `TLD_DNS_MAGNITUDE` does not support sub-daily aggregation intervals; `15m` and `1h` are raised to `1d`. - `const DNSTimeseriesGroupsV2ParamsDimensionAs DNSTimeseriesGroupsV2ParamsDimension = "AS"` - `const DNSTimeseriesGroupsV2ParamsDimensionCacheHit DNSTimeseriesGroupsV2ParamsDimension = "CACHE_HIT"` - `const DNSTimeseriesGroupsV2ParamsDimensionDNSSEC DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC"` - `const DNSTimeseriesGroupsV2ParamsDimensionDNSSECAware DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC_AWARE"` - `const DNSTimeseriesGroupsV2ParamsDimensionDNSSECE2E DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC_E2E"` - `const DNSTimeseriesGroupsV2ParamsDimensionIPVersion DNSTimeseriesGroupsV2ParamsDimension = "IP_VERSION"` - `const DNSTimeseriesGroupsV2ParamsDimensionLocation DNSTimeseriesGroupsV2ParamsDimension = "LOCATION"` - `const DNSTimeseriesGroupsV2ParamsDimensionMatchingAnswer DNSTimeseriesGroupsV2ParamsDimension = "MATCHING_ANSWER"` - `const DNSTimeseriesGroupsV2ParamsDimensionProtocol DNSTimeseriesGroupsV2ParamsDimension = "PROTOCOL"` - `const DNSTimeseriesGroupsV2ParamsDimensionQueryType DNSTimeseriesGroupsV2ParamsDimension = "QUERY_TYPE"` - `const DNSTimeseriesGroupsV2ParamsDimensionResponseCode DNSTimeseriesGroupsV2ParamsDimension = "RESPONSE_CODE"` - `const DNSTimeseriesGroupsV2ParamsDimensionResponseTTL DNSTimeseriesGroupsV2ParamsDimension = "RESPONSE_TTL"` - `const DNSTimeseriesGroupsV2ParamsDimensionTLD DNSTimeseriesGroupsV2ParamsDimension = "TLD"` - `const DNSTimeseriesGroupsV2ParamsDimensionTLDDNSMagnitude DNSTimeseriesGroupsV2ParamsDimension = "TLD_DNS_MAGNITUDE"` - `query DNSTimeseriesGroupsV2Params` - `AggInterval param.Field[DNSTimeseriesGroupsV2ParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupsV2ParamsAggInterval15m DNSTimeseriesGroupsV2ParamsAggInterval = "15m"` - `const DNSTimeseriesGroupsV2ParamsAggInterval1h DNSTimeseriesGroupsV2ParamsAggInterval = "1h"` - `const DNSTimeseriesGroupsV2ParamsAggInterval1d DNSTimeseriesGroupsV2ParamsAggInterval = "1d"` - `const DNSTimeseriesGroupsV2ParamsAggInterval1w DNSTimeseriesGroupsV2ParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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. - `CacheHit param.Field[[]bool]` Filters results based on cache status. - `Continent param.Field[[]string]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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. - `DNSSEC param.Field[[]DNSTimeseriesGroupsV2ParamsDNSSEC]` Filters results based on DNSSEC (DNS Security Extensions) support. - `const DNSTimeseriesGroupsV2ParamsDNSSECInvalid DNSTimeseriesGroupsV2ParamsDNSSEC = "INVALID"` - `const DNSTimeseriesGroupsV2ParamsDNSSECInsecure DNSTimeseriesGroupsV2ParamsDNSSEC = "INSECURE"` - `const DNSTimeseriesGroupsV2ParamsDNSSECSecure DNSTimeseriesGroupsV2ParamsDNSSEC = "SECURE"` - `const DNSTimeseriesGroupsV2ParamsDNSSECOther DNSTimeseriesGroupsV2ParamsDNSSEC = "OTHER"` - `DNSSECAware param.Field[[]DNSTimeseriesGroupsV2ParamsDNSSECAware]` Filters results based on DNSSEC (DNS Security Extensions) client awareness. - `const DNSTimeseriesGroupsV2ParamsDNSSECAwareSupported DNSTimeseriesGroupsV2ParamsDNSSECAware = "SUPPORTED"` - `const DNSTimeseriesGroupsV2ParamsDNSSECAwareNotSupported DNSTimeseriesGroupsV2ParamsDNSSECAware = "NOT_SUPPORTED"` - `DNSSECE2E param.Field[[]bool]` Filters results based on DNSSEC-validated answers by end-to-end security status. - `Format param.Field[DNSTimeseriesGroupsV2ParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupsV2ParamsFormatJson DNSTimeseriesGroupsV2ParamsFormat = "JSON"` - `const DNSTimeseriesGroupsV2ParamsFormatCsv DNSTimeseriesGroupsV2ParamsFormat = "CSV"` - `IPVersion param.Field[[]DNSTimeseriesGroupsV2ParamsIPVersion]` Filters results by IP version (Ipv4 vs. IPv6). - `const DNSTimeseriesGroupsV2ParamsIPVersionIPv4 DNSTimeseriesGroupsV2ParamsIPVersion = "IPv4"` - `const DNSTimeseriesGroupsV2ParamsIPVersionIPv6 DNSTimeseriesGroupsV2ParamsIPVersion = "IPv6"` - `LimitPerGroup param.Field[int64]` Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category. Only supported on high-cardinality dimensions; otherwise the request is rejected. Minimum value is 2. - `Location param.Field[[]string]` 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. - `MatchingAnswer param.Field[[]bool]` Filters results based on whether the queries have a matching answer. - `Name param.Field[[]string]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Normalization param.Field[DNSTimeseriesGroupsV2ParamsNormalization]` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). `RANK` is only meaningful with the `TLD_DNS_MAGNITUDE` dimension, where it ranks TLDs by DNS query magnitude at each timestamp; for other dimensions it has no effect. - `const DNSTimeseriesGroupsV2ParamsNormalizationPercentage DNSTimeseriesGroupsV2ParamsNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupsV2ParamsNormalizationMin0Max DNSTimeseriesGroupsV2ParamsNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupsV2ParamsNormalizationRank DNSTimeseriesGroupsV2ParamsNormalization = "RANK"` - `Protocol param.Field[[]DNSTimeseriesGroupsV2ParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupsV2ParamsProtocolUdp DNSTimeseriesGroupsV2ParamsProtocol = "UDP"` - `const DNSTimeseriesGroupsV2ParamsProtocolTCP DNSTimeseriesGroupsV2ParamsProtocol = "TCP"` - `const DNSTimeseriesGroupsV2ParamsProtocolHTTPS DNSTimeseriesGroupsV2ParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupsV2ParamsProtocolTLS DNSTimeseriesGroupsV2ParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesGroupsV2ParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupsV2ParamsQueryTypeA DNSTimeseriesGroupsV2ParamsQueryType = "A"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAAAA DNSTimeseriesGroupsV2ParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeA6 DNSTimeseriesGroupsV2ParamsQueryType = "A6"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAfsdb DNSTimeseriesGroupsV2ParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAny DNSTimeseriesGroupsV2ParamsQueryType = "ANY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeApl DNSTimeseriesGroupsV2ParamsQueryType = "APL"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAtma DNSTimeseriesGroupsV2ParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAXFR DNSTimeseriesGroupsV2ParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCAA DNSTimeseriesGroupsV2ParamsQueryType = "CAA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCdnskey DNSTimeseriesGroupsV2ParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCds DNSTimeseriesGroupsV2ParamsQueryType = "CDS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCERT DNSTimeseriesGroupsV2ParamsQueryType = "CERT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCNAME DNSTimeseriesGroupsV2ParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCsync DNSTimeseriesGroupsV2ParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDhcid DNSTimeseriesGroupsV2ParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDlv DNSTimeseriesGroupsV2ParamsQueryType = "DLV"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDname DNSTimeseriesGroupsV2ParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDNSKEY DNSTimeseriesGroupsV2ParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDoa DNSTimeseriesGroupsV2ParamsQueryType = "DOA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDS DNSTimeseriesGroupsV2ParamsQueryType = "DS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeEid DNSTimeseriesGroupsV2ParamsQueryType = "EID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeEui48 DNSTimeseriesGroupsV2ParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeEui64 DNSTimeseriesGroupsV2ParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeGpos DNSTimeseriesGroupsV2ParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeGid DNSTimeseriesGroupsV2ParamsQueryType = "GID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeHinfo DNSTimeseriesGroupsV2ParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeHip DNSTimeseriesGroupsV2ParamsQueryType = "HIP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeHTTPS DNSTimeseriesGroupsV2ParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeIpseckey DNSTimeseriesGroupsV2ParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeIsdn DNSTimeseriesGroupsV2ParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeIxfr DNSTimeseriesGroupsV2ParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeKey DNSTimeseriesGroupsV2ParamsQueryType = "KEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeKx DNSTimeseriesGroupsV2ParamsQueryType = "KX"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeL32 DNSTimeseriesGroupsV2ParamsQueryType = "L32"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeL64 DNSTimeseriesGroupsV2ParamsQueryType = "L64"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeLOC DNSTimeseriesGroupsV2ParamsQueryType = "LOC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeLp DNSTimeseriesGroupsV2ParamsQueryType = "LP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMaila DNSTimeseriesGroupsV2ParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMailb DNSTimeseriesGroupsV2ParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMB DNSTimeseriesGroupsV2ParamsQueryType = "MB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMd DNSTimeseriesGroupsV2ParamsQueryType = "MD"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMf DNSTimeseriesGroupsV2ParamsQueryType = "MF"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMg DNSTimeseriesGroupsV2ParamsQueryType = "MG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMinfo DNSTimeseriesGroupsV2ParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMr DNSTimeseriesGroupsV2ParamsQueryType = "MR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMX DNSTimeseriesGroupsV2ParamsQueryType = "MX"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNAPTR DNSTimeseriesGroupsV2ParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNb DNSTimeseriesGroupsV2ParamsQueryType = "NB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNbstat DNSTimeseriesGroupsV2ParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNid DNSTimeseriesGroupsV2ParamsQueryType = "NID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNimloc DNSTimeseriesGroupsV2ParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNinfo DNSTimeseriesGroupsV2ParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNS DNSTimeseriesGroupsV2ParamsQueryType = "NS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsap DNSTimeseriesGroupsV2ParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsec DNSTimeseriesGroupsV2ParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsec3 DNSTimeseriesGroupsV2ParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsec3Param DNSTimeseriesGroupsV2ParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNull DNSTimeseriesGroupsV2ParamsQueryType = "NULL"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNxt DNSTimeseriesGroupsV2ParamsQueryType = "NXT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeOpenpgpkey DNSTimeseriesGroupsV2ParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeOpt DNSTimeseriesGroupsV2ParamsQueryType = "OPT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypePTR DNSTimeseriesGroupsV2ParamsQueryType = "PTR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypePx DNSTimeseriesGroupsV2ParamsQueryType = "PX"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRkey DNSTimeseriesGroupsV2ParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRp DNSTimeseriesGroupsV2ParamsQueryType = "RP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRrsig DNSTimeseriesGroupsV2ParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRt DNSTimeseriesGroupsV2ParamsQueryType = "RT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSig DNSTimeseriesGroupsV2ParamsQueryType = "SIG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSink DNSTimeseriesGroupsV2ParamsQueryType = "SINK"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSMIMEA DNSTimeseriesGroupsV2ParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSOA DNSTimeseriesGroupsV2ParamsQueryType = "SOA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSPF DNSTimeseriesGroupsV2ParamsQueryType = "SPF"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSRV DNSTimeseriesGroupsV2ParamsQueryType = "SRV"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSSHFP DNSTimeseriesGroupsV2ParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSVCB DNSTimeseriesGroupsV2ParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTa DNSTimeseriesGroupsV2ParamsQueryType = "TA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTalink DNSTimeseriesGroupsV2ParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTkey DNSTimeseriesGroupsV2ParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTLSA DNSTimeseriesGroupsV2ParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTSIG DNSTimeseriesGroupsV2ParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTXT DNSTimeseriesGroupsV2ParamsQueryType = "TXT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeUinfo DNSTimeseriesGroupsV2ParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeUID DNSTimeseriesGroupsV2ParamsQueryType = "UID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeUnspec DNSTimeseriesGroupsV2ParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeURI DNSTimeseriesGroupsV2ParamsQueryType = "URI"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeWks DNSTimeseriesGroupsV2ParamsQueryType = "WKS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeX25 DNSTimeseriesGroupsV2ParamsQueryType = "X25"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeZonemd DNSTimeseriesGroupsV2ParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesGroupsV2ParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupsV2ParamsResponseCodeNoerror DNSTimeseriesGroupsV2ParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeFormerr DNSTimeseriesGroupsV2ParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeServfail DNSTimeseriesGroupsV2ParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNxdomain DNSTimeseriesGroupsV2ParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNotimp DNSTimeseriesGroupsV2ParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeRefused DNSTimeseriesGroupsV2ParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeYxdomain DNSTimeseriesGroupsV2ParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeYxrrset DNSTimeseriesGroupsV2ParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNxrrset DNSTimeseriesGroupsV2ParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNotauth DNSTimeseriesGroupsV2ParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNotzone DNSTimeseriesGroupsV2ParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadsig DNSTimeseriesGroupsV2ParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadkey DNSTimeseriesGroupsV2ParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadtime DNSTimeseriesGroupsV2ParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadmode DNSTimeseriesGroupsV2ParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadname DNSTimeseriesGroupsV2ParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadalg DNSTimeseriesGroupsV2ParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadtrunc DNSTimeseriesGroupsV2ParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadcookie DNSTimeseriesGroupsV2ParamsResponseCode = "BADCOOKIE"` - `ResponseTTL param.Field[[]DNSTimeseriesGroupsV2ParamsResponseTTL]` Filters results by DNS response TTL. - `const DNSTimeseriesGroupsV2ParamsResponseTTLLte1M DNSTimeseriesGroupsV2ParamsResponseTTL = "LTE_1M"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1MLte5M DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1M_LTE_5M"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt5MLte15M DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_5M_LTE_15M"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt15MLte1H DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_15M_LTE_1H"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1HLte1D DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1H_LTE_1D"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1DLte1W DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1D_LTE_1W"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1W DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1W"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupsV2Response struct{…}` - `Meta DNSTimeseriesGroupsV2ResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupsV2ResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupsV2ResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneHour DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneDay DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneWeek DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneMonth DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupsV2ResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupsV2ResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupsV2ResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationPercentage DNSTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationMin0Max DNSTimeseriesGroupsV2ResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationMinMax DNSTimeseriesGroupsV2ResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationRawValues DNSTimeseriesGroupsV2ResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationPercentageChange DNSTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationRollingAverage DNSTimeseriesGroupsV2ResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupsV2ResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationRatio DNSTimeseriesGroupsV2ResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupsV2ResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupsV2ResponseSerie0` - `Timestamps []Time` ### Example ```go 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.TimeseriesGroupsV2( context.TODO(), radar.DNSTimeseriesGroupsV2ParamsDimensionAs, radar.DNSTimeseriesGroupsV2Params{ }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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": { "timestamps": [ "2023-08-08T10:15:00Z" ] } }, "success": true } ``` # Top ## Get top ASes by DNS queries `client.Radar.DNS.Top.Ases(ctx, query) (*DNSTopAsesResponse, error)` **get** `/radar/dns/top/ases` Retrieves the top autonomous systems by DNS queries made to 1.1.1.1 DNS resolver. ### Parameters - `query DNSTopAsesParams` - `ASN param.Field[[]string]` 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. - `CacheHit param.Field[[]bool]` Filters results based on cache status. - `Continent param.Field[[]string]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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. - `DNSSEC param.Field[[]DNSTopAsesParamsDNSSEC]` Filters results based on DNSSEC (DNS Security Extensions) support. - `const DNSTopAsesParamsDNSSECInvalid DNSTopAsesParamsDNSSEC = "INVALID"` - `const DNSTopAsesParamsDNSSECInsecure DNSTopAsesParamsDNSSEC = "INSECURE"` - `const DNSTopAsesParamsDNSSECSecure DNSTopAsesParamsDNSSEC = "SECURE"` - `const DNSTopAsesParamsDNSSECOther DNSTopAsesParamsDNSSEC = "OTHER"` - `DNSSECAware param.Field[[]DNSTopAsesParamsDNSSECAware]` Filters results based on DNSSEC (DNS Security Extensions) client awareness. - `const DNSTopAsesParamsDNSSECAwareSupported DNSTopAsesParamsDNSSECAware = "SUPPORTED"` - `const DNSTopAsesParamsDNSSECAwareNotSupported DNSTopAsesParamsDNSSECAware = "NOT_SUPPORTED"` - `DNSSECE2E param.Field[[]bool]` Filters results based on DNSSEC-validated answers by end-to-end security status. - `Domain param.Field[[]string]` Filters results by domain name. When set, no other DNS filter may be used — only date filtering (`dateRange`, or `dateStart`/`dateEnd`) is allowed — and the date range cannot exceed 31 days. - `Format param.Field[DNSTopAsesParamsFormat]` Format in which results will be returned. - `const DNSTopAsesParamsFormatJson DNSTopAsesParamsFormat = "JSON"` - `const DNSTopAsesParamsFormatCsv DNSTopAsesParamsFormat = "CSV"` - `IPVersion param.Field[[]DNSTopAsesParamsIPVersion]` Filters results by IP version (Ipv4 vs. IPv6). - `const DNSTopAsesParamsIPVersionIPv4 DNSTopAsesParamsIPVersion = "IPv4"` - `const DNSTopAsesParamsIPVersionIPv6 DNSTopAsesParamsIPVersion = "IPv6"` - `Limit param.Field[int64]` Limits the number of objects returned in the response. - `Location param.Field[[]string]` 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. - `MatchingAnswer param.Field[[]bool]` Filters results based on whether the queries have a matching answer. - `Name param.Field[[]string]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTopAsesParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTopAsesParamsProtocolUdp DNSTopAsesParamsProtocol = "UDP"` - `const DNSTopAsesParamsProtocolTCP DNSTopAsesParamsProtocol = "TCP"` - `const DNSTopAsesParamsProtocolHTTPS DNSTopAsesParamsProtocol = "HTTPS"` - `const DNSTopAsesParamsProtocolTLS DNSTopAsesParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTopAsesParamsQueryType]` Filters results by DNS query type. - `const DNSTopAsesParamsQueryTypeA DNSTopAsesParamsQueryType = "A"` - `const DNSTopAsesParamsQueryTypeAAAA DNSTopAsesParamsQueryType = "AAAA"` - `const DNSTopAsesParamsQueryTypeA6 DNSTopAsesParamsQueryType = "A6"` - `const DNSTopAsesParamsQueryTypeAfsdb DNSTopAsesParamsQueryType = "AFSDB"` - `const DNSTopAsesParamsQueryTypeAny DNSTopAsesParamsQueryType = "ANY"` - `const DNSTopAsesParamsQueryTypeApl DNSTopAsesParamsQueryType = "APL"` - `const DNSTopAsesParamsQueryTypeAtma DNSTopAsesParamsQueryType = "ATMA"` - `const DNSTopAsesParamsQueryTypeAXFR DNSTopAsesParamsQueryType = "AXFR"` - `const DNSTopAsesParamsQueryTypeCAA DNSTopAsesParamsQueryType = "CAA"` - `const DNSTopAsesParamsQueryTypeCdnskey DNSTopAsesParamsQueryType = "CDNSKEY"` - `const DNSTopAsesParamsQueryTypeCds DNSTopAsesParamsQueryType = "CDS"` - `const DNSTopAsesParamsQueryTypeCERT DNSTopAsesParamsQueryType = "CERT"` - `const DNSTopAsesParamsQueryTypeCNAME DNSTopAsesParamsQueryType = "CNAME"` - `const DNSTopAsesParamsQueryTypeCsync DNSTopAsesParamsQueryType = "CSYNC"` - `const DNSTopAsesParamsQueryTypeDhcid DNSTopAsesParamsQueryType = "DHCID"` - `const DNSTopAsesParamsQueryTypeDlv DNSTopAsesParamsQueryType = "DLV"` - `const DNSTopAsesParamsQueryTypeDname DNSTopAsesParamsQueryType = "DNAME"` - `const DNSTopAsesParamsQueryTypeDNSKEY DNSTopAsesParamsQueryType = "DNSKEY"` - `const DNSTopAsesParamsQueryTypeDoa DNSTopAsesParamsQueryType = "DOA"` - `const DNSTopAsesParamsQueryTypeDS DNSTopAsesParamsQueryType = "DS"` - `const DNSTopAsesParamsQueryTypeEid DNSTopAsesParamsQueryType = "EID"` - `const DNSTopAsesParamsQueryTypeEui48 DNSTopAsesParamsQueryType = "EUI48"` - `const DNSTopAsesParamsQueryTypeEui64 DNSTopAsesParamsQueryType = "EUI64"` - `const DNSTopAsesParamsQueryTypeGpos DNSTopAsesParamsQueryType = "GPOS"` - `const DNSTopAsesParamsQueryTypeGid DNSTopAsesParamsQueryType = "GID"` - `const DNSTopAsesParamsQueryTypeHinfo DNSTopAsesParamsQueryType = "HINFO"` - `const DNSTopAsesParamsQueryTypeHip DNSTopAsesParamsQueryType = "HIP"` - `const DNSTopAsesParamsQueryTypeHTTPS DNSTopAsesParamsQueryType = "HTTPS"` - `const DNSTopAsesParamsQueryTypeIpseckey DNSTopAsesParamsQueryType = "IPSECKEY"` - `const DNSTopAsesParamsQueryTypeIsdn DNSTopAsesParamsQueryType = "ISDN"` - `const DNSTopAsesParamsQueryTypeIxfr DNSTopAsesParamsQueryType = "IXFR"` - `const DNSTopAsesParamsQueryTypeKey DNSTopAsesParamsQueryType = "KEY"` - `const DNSTopAsesParamsQueryTypeKx DNSTopAsesParamsQueryType = "KX"` - `const DNSTopAsesParamsQueryTypeL32 DNSTopAsesParamsQueryType = "L32"` - `const DNSTopAsesParamsQueryTypeL64 DNSTopAsesParamsQueryType = "L64"` - `const DNSTopAsesParamsQueryTypeLOC DNSTopAsesParamsQueryType = "LOC"` - `const DNSTopAsesParamsQueryTypeLp DNSTopAsesParamsQueryType = "LP"` - `const DNSTopAsesParamsQueryTypeMaila DNSTopAsesParamsQueryType = "MAILA"` - `const DNSTopAsesParamsQueryTypeMailb DNSTopAsesParamsQueryType = "MAILB"` - `const DNSTopAsesParamsQueryTypeMB DNSTopAsesParamsQueryType = "MB"` - `const DNSTopAsesParamsQueryTypeMd DNSTopAsesParamsQueryType = "MD"` - `const DNSTopAsesParamsQueryTypeMf DNSTopAsesParamsQueryType = "MF"` - `const DNSTopAsesParamsQueryTypeMg DNSTopAsesParamsQueryType = "MG"` - `const DNSTopAsesParamsQueryTypeMinfo DNSTopAsesParamsQueryType = "MINFO"` - `const DNSTopAsesParamsQueryTypeMr DNSTopAsesParamsQueryType = "MR"` - `const DNSTopAsesParamsQueryTypeMX DNSTopAsesParamsQueryType = "MX"` - `const DNSTopAsesParamsQueryTypeNAPTR DNSTopAsesParamsQueryType = "NAPTR"` - `const DNSTopAsesParamsQueryTypeNb DNSTopAsesParamsQueryType = "NB"` - `const DNSTopAsesParamsQueryTypeNbstat DNSTopAsesParamsQueryType = "NBSTAT"` - `const DNSTopAsesParamsQueryTypeNid DNSTopAsesParamsQueryType = "NID"` - `const DNSTopAsesParamsQueryTypeNimloc DNSTopAsesParamsQueryType = "NIMLOC"` - `const DNSTopAsesParamsQueryTypeNinfo DNSTopAsesParamsQueryType = "NINFO"` - `const DNSTopAsesParamsQueryTypeNS DNSTopAsesParamsQueryType = "NS"` - `const DNSTopAsesParamsQueryTypeNsap DNSTopAsesParamsQueryType = "NSAP"` - `const DNSTopAsesParamsQueryTypeNsec DNSTopAsesParamsQueryType = "NSEC"` - `const DNSTopAsesParamsQueryTypeNsec3 DNSTopAsesParamsQueryType = "NSEC3"` - `const DNSTopAsesParamsQueryTypeNsec3Param DNSTopAsesParamsQueryType = "NSEC3PARAM"` - `const DNSTopAsesParamsQueryTypeNull DNSTopAsesParamsQueryType = "NULL"` - `const DNSTopAsesParamsQueryTypeNxt DNSTopAsesParamsQueryType = "NXT"` - `const DNSTopAsesParamsQueryTypeOpenpgpkey DNSTopAsesParamsQueryType = "OPENPGPKEY"` - `const DNSTopAsesParamsQueryTypeOpt DNSTopAsesParamsQueryType = "OPT"` - `const DNSTopAsesParamsQueryTypePTR DNSTopAsesParamsQueryType = "PTR"` - `const DNSTopAsesParamsQueryTypePx DNSTopAsesParamsQueryType = "PX"` - `const DNSTopAsesParamsQueryTypeRkey DNSTopAsesParamsQueryType = "RKEY"` - `const DNSTopAsesParamsQueryTypeRp DNSTopAsesParamsQueryType = "RP"` - `const DNSTopAsesParamsQueryTypeRrsig DNSTopAsesParamsQueryType = "RRSIG"` - `const DNSTopAsesParamsQueryTypeRt DNSTopAsesParamsQueryType = "RT"` - `const DNSTopAsesParamsQueryTypeSig DNSTopAsesParamsQueryType = "SIG"` - `const DNSTopAsesParamsQueryTypeSink DNSTopAsesParamsQueryType = "SINK"` - `const DNSTopAsesParamsQueryTypeSMIMEA DNSTopAsesParamsQueryType = "SMIMEA"` - `const DNSTopAsesParamsQueryTypeSOA DNSTopAsesParamsQueryType = "SOA"` - `const DNSTopAsesParamsQueryTypeSPF DNSTopAsesParamsQueryType = "SPF"` - `const DNSTopAsesParamsQueryTypeSRV DNSTopAsesParamsQueryType = "SRV"` - `const DNSTopAsesParamsQueryTypeSSHFP DNSTopAsesParamsQueryType = "SSHFP"` - `const DNSTopAsesParamsQueryTypeSVCB DNSTopAsesParamsQueryType = "SVCB"` - `const DNSTopAsesParamsQueryTypeTa DNSTopAsesParamsQueryType = "TA"` - `const DNSTopAsesParamsQueryTypeTalink DNSTopAsesParamsQueryType = "TALINK"` - `const DNSTopAsesParamsQueryTypeTkey DNSTopAsesParamsQueryType = "TKEY"` - `const DNSTopAsesParamsQueryTypeTLSA DNSTopAsesParamsQueryType = "TLSA"` - `const DNSTopAsesParamsQueryTypeTSIG DNSTopAsesParamsQueryType = "TSIG"` - `const DNSTopAsesParamsQueryTypeTXT DNSTopAsesParamsQueryType = "TXT"` - `const DNSTopAsesParamsQueryTypeUinfo DNSTopAsesParamsQueryType = "UINFO"` - `const DNSTopAsesParamsQueryTypeUID DNSTopAsesParamsQueryType = "UID"` - `const DNSTopAsesParamsQueryTypeUnspec DNSTopAsesParamsQueryType = "UNSPEC"` - `const DNSTopAsesParamsQueryTypeURI DNSTopAsesParamsQueryType = "URI"` - `const DNSTopAsesParamsQueryTypeWks DNSTopAsesParamsQueryType = "WKS"` - `const DNSTopAsesParamsQueryTypeX25 DNSTopAsesParamsQueryType = "X25"` - `const DNSTopAsesParamsQueryTypeZonemd DNSTopAsesParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTopAsesParamsResponseCode]` Filters results by DNS response code. - `const DNSTopAsesParamsResponseCodeNoerror DNSTopAsesParamsResponseCode = "NOERROR"` - `const DNSTopAsesParamsResponseCodeFormerr DNSTopAsesParamsResponseCode = "FORMERR"` - `const DNSTopAsesParamsResponseCodeServfail DNSTopAsesParamsResponseCode = "SERVFAIL"` - `const DNSTopAsesParamsResponseCodeNxdomain DNSTopAsesParamsResponseCode = "NXDOMAIN"` - `const DNSTopAsesParamsResponseCodeNotimp DNSTopAsesParamsResponseCode = "NOTIMP"` - `const DNSTopAsesParamsResponseCodeRefused DNSTopAsesParamsResponseCode = "REFUSED"` - `const DNSTopAsesParamsResponseCodeYxdomain DNSTopAsesParamsResponseCode = "YXDOMAIN"` - `const DNSTopAsesParamsResponseCodeYxrrset DNSTopAsesParamsResponseCode = "YXRRSET"` - `const DNSTopAsesParamsResponseCodeNxrrset DNSTopAsesParamsResponseCode = "NXRRSET"` - `const DNSTopAsesParamsResponseCodeNotauth DNSTopAsesParamsResponseCode = "NOTAUTH"` - `const DNSTopAsesParamsResponseCodeNotzone DNSTopAsesParamsResponseCode = "NOTZONE"` - `const DNSTopAsesParamsResponseCodeBadsig DNSTopAsesParamsResponseCode = "BADSIG"` - `const DNSTopAsesParamsResponseCodeBadkey DNSTopAsesParamsResponseCode = "BADKEY"` - `const DNSTopAsesParamsResponseCodeBadtime DNSTopAsesParamsResponseCode = "BADTIME"` - `const DNSTopAsesParamsResponseCodeBadmode DNSTopAsesParamsResponseCode = "BADMODE"` - `const DNSTopAsesParamsResponseCodeBadname DNSTopAsesParamsResponseCode = "BADNAME"` - `const DNSTopAsesParamsResponseCodeBadalg DNSTopAsesParamsResponseCode = "BADALG"` - `const DNSTopAsesParamsResponseCodeBadtrunc DNSTopAsesParamsResponseCode = "BADTRUNC"` - `const DNSTopAsesParamsResponseCodeBadcookie DNSTopAsesParamsResponseCode = "BADCOOKIE"` - `ResponseTTL param.Field[[]DNSTopAsesParamsResponseTTL]` Filters results by DNS response TTL. - `const DNSTopAsesParamsResponseTTLLte1M DNSTopAsesParamsResponseTTL = "LTE_1M"` - `const DNSTopAsesParamsResponseTTLGt1MLte5M DNSTopAsesParamsResponseTTL = "GT_1M_LTE_5M"` - `const DNSTopAsesParamsResponseTTLGt5MLte15M DNSTopAsesParamsResponseTTL = "GT_5M_LTE_15M"` - `const DNSTopAsesParamsResponseTTLGt15MLte1H DNSTopAsesParamsResponseTTL = "GT_15M_LTE_1H"` - `const DNSTopAsesParamsResponseTTLGt1HLte1D DNSTopAsesParamsResponseTTL = "GT_1H_LTE_1D"` - `const DNSTopAsesParamsResponseTTLGt1DLte1W DNSTopAsesParamsResponseTTL = "GT_1D_LTE_1W"` - `const DNSTopAsesParamsResponseTTLGt1W DNSTopAsesParamsResponseTTL = "GT_1W"` ### Returns - `type DNSTopAsesResponse struct{…}` - `Meta DNSTopAsesResponseMeta` Metadata for the results. - `ConfidenceInfo DNSTopAsesResponseMetaConfidenceInfo` - `Annotations []DNSTopAsesResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTopAsesResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTopAsesResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTopAsesResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTopAsesResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTopAsesResponseMetaNormalizationPercentage DNSTopAsesResponseMetaNormalization = "PERCENTAGE"` - `const DNSTopAsesResponseMetaNormalizationMin0Max DNSTopAsesResponseMetaNormalization = "MIN0_MAX"` - `const DNSTopAsesResponseMetaNormalizationMinMax DNSTopAsesResponseMetaNormalization = "MIN_MAX"` - `const DNSTopAsesResponseMetaNormalizationRawValues DNSTopAsesResponseMetaNormalization = "RAW_VALUES"` - `const DNSTopAsesResponseMetaNormalizationPercentageChange DNSTopAsesResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTopAsesResponseMetaNormalizationRollingAverage DNSTopAsesResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTopAsesResponseMetaNormalizationOverlappedPercentage DNSTopAsesResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTopAsesResponseMetaNormalizationRatio DNSTopAsesResponseMetaNormalization = "RATIO"` - `Units []DNSTopAsesResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Top0 []DNSTopAsesResponseTop0` - `ClientASN int64` - `ClientAsName string` - `Value string` A numeric string. ### Example ```go 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.Top.Ases(context.TODO(), radar.DNSTopAsesParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "top_0": [ { "clientASN": 3243, "clientASName": "MEO", "value": "10" } ] }, "success": true } ``` ## Get top locations by DNS queries `client.Radar.DNS.Top.Locations(ctx, query) (*DNSTopLocationsResponse, error)` **get** `/radar/dns/top/locations` Retrieves the top locations by DNS queries made to 1.1.1.1 DNS resolver. ### Parameters - `query DNSTopLocationsParams` - `ASN param.Field[[]string]` 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. - `CacheHit param.Field[[]bool]` Filters results based on cache status. - `Continent param.Field[[]string]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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. - `DNSSEC param.Field[[]DNSTopLocationsParamsDNSSEC]` Filters results based on DNSSEC (DNS Security Extensions) support. - `const DNSTopLocationsParamsDNSSECInvalid DNSTopLocationsParamsDNSSEC = "INVALID"` - `const DNSTopLocationsParamsDNSSECInsecure DNSTopLocationsParamsDNSSEC = "INSECURE"` - `const DNSTopLocationsParamsDNSSECSecure DNSTopLocationsParamsDNSSEC = "SECURE"` - `const DNSTopLocationsParamsDNSSECOther DNSTopLocationsParamsDNSSEC = "OTHER"` - `DNSSECAware param.Field[[]DNSTopLocationsParamsDNSSECAware]` Filters results based on DNSSEC (DNS Security Extensions) client awareness. - `const DNSTopLocationsParamsDNSSECAwareSupported DNSTopLocationsParamsDNSSECAware = "SUPPORTED"` - `const DNSTopLocationsParamsDNSSECAwareNotSupported DNSTopLocationsParamsDNSSECAware = "NOT_SUPPORTED"` - `DNSSECE2E param.Field[[]bool]` Filters results based on DNSSEC-validated answers by end-to-end security status. - `Domain param.Field[[]string]` Filters results by domain name. When set, no other DNS filter may be used — only date filtering (`dateRange`, or `dateStart`/`dateEnd`) is allowed — and the date range cannot exceed 31 days. - `Format param.Field[DNSTopLocationsParamsFormat]` Format in which results will be returned. - `const DNSTopLocationsParamsFormatJson DNSTopLocationsParamsFormat = "JSON"` - `const DNSTopLocationsParamsFormatCsv DNSTopLocationsParamsFormat = "CSV"` - `IPVersion param.Field[[]DNSTopLocationsParamsIPVersion]` Filters results by IP version (Ipv4 vs. IPv6). - `const DNSTopLocationsParamsIPVersionIPv4 DNSTopLocationsParamsIPVersion = "IPv4"` - `const DNSTopLocationsParamsIPVersionIPv6 DNSTopLocationsParamsIPVersion = "IPv6"` - `Limit param.Field[int64]` Limits the number of objects returned in the response. - `Location param.Field[[]string]` 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. - `MatchingAnswer param.Field[[]bool]` Filters results based on whether the queries have a matching answer. - `Name param.Field[[]string]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTopLocationsParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTopLocationsParamsProtocolUdp DNSTopLocationsParamsProtocol = "UDP"` - `const DNSTopLocationsParamsProtocolTCP DNSTopLocationsParamsProtocol = "TCP"` - `const DNSTopLocationsParamsProtocolHTTPS DNSTopLocationsParamsProtocol = "HTTPS"` - `const DNSTopLocationsParamsProtocolTLS DNSTopLocationsParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTopLocationsParamsQueryType]` Filters results by DNS query type. - `const DNSTopLocationsParamsQueryTypeA DNSTopLocationsParamsQueryType = "A"` - `const DNSTopLocationsParamsQueryTypeAAAA DNSTopLocationsParamsQueryType = "AAAA"` - `const DNSTopLocationsParamsQueryTypeA6 DNSTopLocationsParamsQueryType = "A6"` - `const DNSTopLocationsParamsQueryTypeAfsdb DNSTopLocationsParamsQueryType = "AFSDB"` - `const DNSTopLocationsParamsQueryTypeAny DNSTopLocationsParamsQueryType = "ANY"` - `const DNSTopLocationsParamsQueryTypeApl DNSTopLocationsParamsQueryType = "APL"` - `const DNSTopLocationsParamsQueryTypeAtma DNSTopLocationsParamsQueryType = "ATMA"` - `const DNSTopLocationsParamsQueryTypeAXFR DNSTopLocationsParamsQueryType = "AXFR"` - `const DNSTopLocationsParamsQueryTypeCAA DNSTopLocationsParamsQueryType = "CAA"` - `const DNSTopLocationsParamsQueryTypeCdnskey DNSTopLocationsParamsQueryType = "CDNSKEY"` - `const DNSTopLocationsParamsQueryTypeCds DNSTopLocationsParamsQueryType = "CDS"` - `const DNSTopLocationsParamsQueryTypeCERT DNSTopLocationsParamsQueryType = "CERT"` - `const DNSTopLocationsParamsQueryTypeCNAME DNSTopLocationsParamsQueryType = "CNAME"` - `const DNSTopLocationsParamsQueryTypeCsync DNSTopLocationsParamsQueryType = "CSYNC"` - `const DNSTopLocationsParamsQueryTypeDhcid DNSTopLocationsParamsQueryType = "DHCID"` - `const DNSTopLocationsParamsQueryTypeDlv DNSTopLocationsParamsQueryType = "DLV"` - `const DNSTopLocationsParamsQueryTypeDname DNSTopLocationsParamsQueryType = "DNAME"` - `const DNSTopLocationsParamsQueryTypeDNSKEY DNSTopLocationsParamsQueryType = "DNSKEY"` - `const DNSTopLocationsParamsQueryTypeDoa DNSTopLocationsParamsQueryType = "DOA"` - `const DNSTopLocationsParamsQueryTypeDS DNSTopLocationsParamsQueryType = "DS"` - `const DNSTopLocationsParamsQueryTypeEid DNSTopLocationsParamsQueryType = "EID"` - `const DNSTopLocationsParamsQueryTypeEui48 DNSTopLocationsParamsQueryType = "EUI48"` - `const DNSTopLocationsParamsQueryTypeEui64 DNSTopLocationsParamsQueryType = "EUI64"` - `const DNSTopLocationsParamsQueryTypeGpos DNSTopLocationsParamsQueryType = "GPOS"` - `const DNSTopLocationsParamsQueryTypeGid DNSTopLocationsParamsQueryType = "GID"` - `const DNSTopLocationsParamsQueryTypeHinfo DNSTopLocationsParamsQueryType = "HINFO"` - `const DNSTopLocationsParamsQueryTypeHip DNSTopLocationsParamsQueryType = "HIP"` - `const DNSTopLocationsParamsQueryTypeHTTPS DNSTopLocationsParamsQueryType = "HTTPS"` - `const DNSTopLocationsParamsQueryTypeIpseckey DNSTopLocationsParamsQueryType = "IPSECKEY"` - `const DNSTopLocationsParamsQueryTypeIsdn DNSTopLocationsParamsQueryType = "ISDN"` - `const DNSTopLocationsParamsQueryTypeIxfr DNSTopLocationsParamsQueryType = "IXFR"` - `const DNSTopLocationsParamsQueryTypeKey DNSTopLocationsParamsQueryType = "KEY"` - `const DNSTopLocationsParamsQueryTypeKx DNSTopLocationsParamsQueryType = "KX"` - `const DNSTopLocationsParamsQueryTypeL32 DNSTopLocationsParamsQueryType = "L32"` - `const DNSTopLocationsParamsQueryTypeL64 DNSTopLocationsParamsQueryType = "L64"` - `const DNSTopLocationsParamsQueryTypeLOC DNSTopLocationsParamsQueryType = "LOC"` - `const DNSTopLocationsParamsQueryTypeLp DNSTopLocationsParamsQueryType = "LP"` - `const DNSTopLocationsParamsQueryTypeMaila DNSTopLocationsParamsQueryType = "MAILA"` - `const DNSTopLocationsParamsQueryTypeMailb DNSTopLocationsParamsQueryType = "MAILB"` - `const DNSTopLocationsParamsQueryTypeMB DNSTopLocationsParamsQueryType = "MB"` - `const DNSTopLocationsParamsQueryTypeMd DNSTopLocationsParamsQueryType = "MD"` - `const DNSTopLocationsParamsQueryTypeMf DNSTopLocationsParamsQueryType = "MF"` - `const DNSTopLocationsParamsQueryTypeMg DNSTopLocationsParamsQueryType = "MG"` - `const DNSTopLocationsParamsQueryTypeMinfo DNSTopLocationsParamsQueryType = "MINFO"` - `const DNSTopLocationsParamsQueryTypeMr DNSTopLocationsParamsQueryType = "MR"` - `const DNSTopLocationsParamsQueryTypeMX DNSTopLocationsParamsQueryType = "MX"` - `const DNSTopLocationsParamsQueryTypeNAPTR DNSTopLocationsParamsQueryType = "NAPTR"` - `const DNSTopLocationsParamsQueryTypeNb DNSTopLocationsParamsQueryType = "NB"` - `const DNSTopLocationsParamsQueryTypeNbstat DNSTopLocationsParamsQueryType = "NBSTAT"` - `const DNSTopLocationsParamsQueryTypeNid DNSTopLocationsParamsQueryType = "NID"` - `const DNSTopLocationsParamsQueryTypeNimloc DNSTopLocationsParamsQueryType = "NIMLOC"` - `const DNSTopLocationsParamsQueryTypeNinfo DNSTopLocationsParamsQueryType = "NINFO"` - `const DNSTopLocationsParamsQueryTypeNS DNSTopLocationsParamsQueryType = "NS"` - `const DNSTopLocationsParamsQueryTypeNsap DNSTopLocationsParamsQueryType = "NSAP"` - `const DNSTopLocationsParamsQueryTypeNsec DNSTopLocationsParamsQueryType = "NSEC"` - `const DNSTopLocationsParamsQueryTypeNsec3 DNSTopLocationsParamsQueryType = "NSEC3"` - `const DNSTopLocationsParamsQueryTypeNsec3Param DNSTopLocationsParamsQueryType = "NSEC3PARAM"` - `const DNSTopLocationsParamsQueryTypeNull DNSTopLocationsParamsQueryType = "NULL"` - `const DNSTopLocationsParamsQueryTypeNxt DNSTopLocationsParamsQueryType = "NXT"` - `const DNSTopLocationsParamsQueryTypeOpenpgpkey DNSTopLocationsParamsQueryType = "OPENPGPKEY"` - `const DNSTopLocationsParamsQueryTypeOpt DNSTopLocationsParamsQueryType = "OPT"` - `const DNSTopLocationsParamsQueryTypePTR DNSTopLocationsParamsQueryType = "PTR"` - `const DNSTopLocationsParamsQueryTypePx DNSTopLocationsParamsQueryType = "PX"` - `const DNSTopLocationsParamsQueryTypeRkey DNSTopLocationsParamsQueryType = "RKEY"` - `const DNSTopLocationsParamsQueryTypeRp DNSTopLocationsParamsQueryType = "RP"` - `const DNSTopLocationsParamsQueryTypeRrsig DNSTopLocationsParamsQueryType = "RRSIG"` - `const DNSTopLocationsParamsQueryTypeRt DNSTopLocationsParamsQueryType = "RT"` - `const DNSTopLocationsParamsQueryTypeSig DNSTopLocationsParamsQueryType = "SIG"` - `const DNSTopLocationsParamsQueryTypeSink DNSTopLocationsParamsQueryType = "SINK"` - `const DNSTopLocationsParamsQueryTypeSMIMEA DNSTopLocationsParamsQueryType = "SMIMEA"` - `const DNSTopLocationsParamsQueryTypeSOA DNSTopLocationsParamsQueryType = "SOA"` - `const DNSTopLocationsParamsQueryTypeSPF DNSTopLocationsParamsQueryType = "SPF"` - `const DNSTopLocationsParamsQueryTypeSRV DNSTopLocationsParamsQueryType = "SRV"` - `const DNSTopLocationsParamsQueryTypeSSHFP DNSTopLocationsParamsQueryType = "SSHFP"` - `const DNSTopLocationsParamsQueryTypeSVCB DNSTopLocationsParamsQueryType = "SVCB"` - `const DNSTopLocationsParamsQueryTypeTa DNSTopLocationsParamsQueryType = "TA"` - `const DNSTopLocationsParamsQueryTypeTalink DNSTopLocationsParamsQueryType = "TALINK"` - `const DNSTopLocationsParamsQueryTypeTkey DNSTopLocationsParamsQueryType = "TKEY"` - `const DNSTopLocationsParamsQueryTypeTLSA DNSTopLocationsParamsQueryType = "TLSA"` - `const DNSTopLocationsParamsQueryTypeTSIG DNSTopLocationsParamsQueryType = "TSIG"` - `const DNSTopLocationsParamsQueryTypeTXT DNSTopLocationsParamsQueryType = "TXT"` - `const DNSTopLocationsParamsQueryTypeUinfo DNSTopLocationsParamsQueryType = "UINFO"` - `const DNSTopLocationsParamsQueryTypeUID DNSTopLocationsParamsQueryType = "UID"` - `const DNSTopLocationsParamsQueryTypeUnspec DNSTopLocationsParamsQueryType = "UNSPEC"` - `const DNSTopLocationsParamsQueryTypeURI DNSTopLocationsParamsQueryType = "URI"` - `const DNSTopLocationsParamsQueryTypeWks DNSTopLocationsParamsQueryType = "WKS"` - `const DNSTopLocationsParamsQueryTypeX25 DNSTopLocationsParamsQueryType = "X25"` - `const DNSTopLocationsParamsQueryTypeZonemd DNSTopLocationsParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTopLocationsParamsResponseCode]` Filters results by DNS response code. - `const DNSTopLocationsParamsResponseCodeNoerror DNSTopLocationsParamsResponseCode = "NOERROR"` - `const DNSTopLocationsParamsResponseCodeFormerr DNSTopLocationsParamsResponseCode = "FORMERR"` - `const DNSTopLocationsParamsResponseCodeServfail DNSTopLocationsParamsResponseCode = "SERVFAIL"` - `const DNSTopLocationsParamsResponseCodeNxdomain DNSTopLocationsParamsResponseCode = "NXDOMAIN"` - `const DNSTopLocationsParamsResponseCodeNotimp DNSTopLocationsParamsResponseCode = "NOTIMP"` - `const DNSTopLocationsParamsResponseCodeRefused DNSTopLocationsParamsResponseCode = "REFUSED"` - `const DNSTopLocationsParamsResponseCodeYxdomain DNSTopLocationsParamsResponseCode = "YXDOMAIN"` - `const DNSTopLocationsParamsResponseCodeYxrrset DNSTopLocationsParamsResponseCode = "YXRRSET"` - `const DNSTopLocationsParamsResponseCodeNxrrset DNSTopLocationsParamsResponseCode = "NXRRSET"` - `const DNSTopLocationsParamsResponseCodeNotauth DNSTopLocationsParamsResponseCode = "NOTAUTH"` - `const DNSTopLocationsParamsResponseCodeNotzone DNSTopLocationsParamsResponseCode = "NOTZONE"` - `const DNSTopLocationsParamsResponseCodeBadsig DNSTopLocationsParamsResponseCode = "BADSIG"` - `const DNSTopLocationsParamsResponseCodeBadkey DNSTopLocationsParamsResponseCode = "BADKEY"` - `const DNSTopLocationsParamsResponseCodeBadtime DNSTopLocationsParamsResponseCode = "BADTIME"` - `const DNSTopLocationsParamsResponseCodeBadmode DNSTopLocationsParamsResponseCode = "BADMODE"` - `const DNSTopLocationsParamsResponseCodeBadname DNSTopLocationsParamsResponseCode = "BADNAME"` - `const DNSTopLocationsParamsResponseCodeBadalg DNSTopLocationsParamsResponseCode = "BADALG"` - `const DNSTopLocationsParamsResponseCodeBadtrunc DNSTopLocationsParamsResponseCode = "BADTRUNC"` - `const DNSTopLocationsParamsResponseCodeBadcookie DNSTopLocationsParamsResponseCode = "BADCOOKIE"` - `ResponseTTL param.Field[[]DNSTopLocationsParamsResponseTTL]` Filters results by DNS response TTL. - `const DNSTopLocationsParamsResponseTTLLte1M DNSTopLocationsParamsResponseTTL = "LTE_1M"` - `const DNSTopLocationsParamsResponseTTLGt1MLte5M DNSTopLocationsParamsResponseTTL = "GT_1M_LTE_5M"` - `const DNSTopLocationsParamsResponseTTLGt5MLte15M DNSTopLocationsParamsResponseTTL = "GT_5M_LTE_15M"` - `const DNSTopLocationsParamsResponseTTLGt15MLte1H DNSTopLocationsParamsResponseTTL = "GT_15M_LTE_1H"` - `const DNSTopLocationsParamsResponseTTLGt1HLte1D DNSTopLocationsParamsResponseTTL = "GT_1H_LTE_1D"` - `const DNSTopLocationsParamsResponseTTLGt1DLte1W DNSTopLocationsParamsResponseTTL = "GT_1D_LTE_1W"` - `const DNSTopLocationsParamsResponseTTLGt1W DNSTopLocationsParamsResponseTTL = "GT_1W"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTopLocationsResponse struct{…}` - `Meta DNSTopLocationsResponseMeta` Metadata for the results. - `ConfidenceInfo DNSTopLocationsResponseMetaConfidenceInfo` - `Annotations []DNSTopLocationsResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTopLocationsResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTopLocationsResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTopLocationsResponseMetaNormalizationPercentage DNSTopLocationsResponseMetaNormalization = "PERCENTAGE"` - `const DNSTopLocationsResponseMetaNormalizationMin0Max DNSTopLocationsResponseMetaNormalization = "MIN0_MAX"` - `const DNSTopLocationsResponseMetaNormalizationMinMax DNSTopLocationsResponseMetaNormalization = "MIN_MAX"` - `const DNSTopLocationsResponseMetaNormalizationRawValues DNSTopLocationsResponseMetaNormalization = "RAW_VALUES"` - `const DNSTopLocationsResponseMetaNormalizationPercentageChange DNSTopLocationsResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTopLocationsResponseMetaNormalizationRollingAverage DNSTopLocationsResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTopLocationsResponseMetaNormalizationOverlappedPercentage DNSTopLocationsResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTopLocationsResponseMetaNormalizationRatio DNSTopLocationsResponseMetaNormalization = "RATIO"` - `Units []DNSTopLocationsResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Top0 []DNSTopLocationsResponseTop0` - `ClientCountryAlpha2 string` - `ClientCountryName string` - `Value string` A numeric string. ### Example ```go 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.Top.Locations(context.TODO(), radar.DNSTopLocationsParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "top_0": [ { "clientCountryAlpha2": "PT", "clientCountryName": "Portugal", "value": "10" } ] }, "success": true } ``` # Summary ## Get DNS queries by cache status summary `client.Radar.DNS.Summary.CacheHit(ctx, query) (*DNSSummaryCacheHitResponse, error)` **get** `/radar/dns/summary/cache_hit` Retrieves the distribution of DNS queries by cache status. ### Parameters - `query DNSSummaryCacheHitParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryCacheHitParamsFormat]` Format in which results will be returned. - `const DNSSummaryCacheHitParamsFormatJson DNSSummaryCacheHitParamsFormat = "JSON"` - `const DNSSummaryCacheHitParamsFormatCsv DNSSummaryCacheHitParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryCacheHitParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryCacheHitParamsProtocolUdp DNSSummaryCacheHitParamsProtocol = "UDP"` - `const DNSSummaryCacheHitParamsProtocolTCP DNSSummaryCacheHitParamsProtocol = "TCP"` - `const DNSSummaryCacheHitParamsProtocolHTTPS DNSSummaryCacheHitParamsProtocol = "HTTPS"` - `const DNSSummaryCacheHitParamsProtocolTLS DNSSummaryCacheHitParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryCacheHitParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryCacheHitParamsQueryTypeA DNSSummaryCacheHitParamsQueryType = "A"` - `const DNSSummaryCacheHitParamsQueryTypeAAAA DNSSummaryCacheHitParamsQueryType = "AAAA"` - `const DNSSummaryCacheHitParamsQueryTypeA6 DNSSummaryCacheHitParamsQueryType = "A6"` - `const DNSSummaryCacheHitParamsQueryTypeAfsdb DNSSummaryCacheHitParamsQueryType = "AFSDB"` - `const DNSSummaryCacheHitParamsQueryTypeAny DNSSummaryCacheHitParamsQueryType = "ANY"` - `const DNSSummaryCacheHitParamsQueryTypeApl DNSSummaryCacheHitParamsQueryType = "APL"` - `const DNSSummaryCacheHitParamsQueryTypeAtma DNSSummaryCacheHitParamsQueryType = "ATMA"` - `const DNSSummaryCacheHitParamsQueryTypeAXFR DNSSummaryCacheHitParamsQueryType = "AXFR"` - `const DNSSummaryCacheHitParamsQueryTypeCAA DNSSummaryCacheHitParamsQueryType = "CAA"` - `const DNSSummaryCacheHitParamsQueryTypeCdnskey DNSSummaryCacheHitParamsQueryType = "CDNSKEY"` - `const DNSSummaryCacheHitParamsQueryTypeCds DNSSummaryCacheHitParamsQueryType = "CDS"` - `const DNSSummaryCacheHitParamsQueryTypeCERT DNSSummaryCacheHitParamsQueryType = "CERT"` - `const DNSSummaryCacheHitParamsQueryTypeCNAME DNSSummaryCacheHitParamsQueryType = "CNAME"` - `const DNSSummaryCacheHitParamsQueryTypeCsync DNSSummaryCacheHitParamsQueryType = "CSYNC"` - `const DNSSummaryCacheHitParamsQueryTypeDhcid DNSSummaryCacheHitParamsQueryType = "DHCID"` - `const DNSSummaryCacheHitParamsQueryTypeDlv DNSSummaryCacheHitParamsQueryType = "DLV"` - `const DNSSummaryCacheHitParamsQueryTypeDname DNSSummaryCacheHitParamsQueryType = "DNAME"` - `const DNSSummaryCacheHitParamsQueryTypeDNSKEY DNSSummaryCacheHitParamsQueryType = "DNSKEY"` - `const DNSSummaryCacheHitParamsQueryTypeDoa DNSSummaryCacheHitParamsQueryType = "DOA"` - `const DNSSummaryCacheHitParamsQueryTypeDS DNSSummaryCacheHitParamsQueryType = "DS"` - `const DNSSummaryCacheHitParamsQueryTypeEid DNSSummaryCacheHitParamsQueryType = "EID"` - `const DNSSummaryCacheHitParamsQueryTypeEui48 DNSSummaryCacheHitParamsQueryType = "EUI48"` - `const DNSSummaryCacheHitParamsQueryTypeEui64 DNSSummaryCacheHitParamsQueryType = "EUI64"` - `const DNSSummaryCacheHitParamsQueryTypeGpos DNSSummaryCacheHitParamsQueryType = "GPOS"` - `const DNSSummaryCacheHitParamsQueryTypeGid DNSSummaryCacheHitParamsQueryType = "GID"` - `const DNSSummaryCacheHitParamsQueryTypeHinfo DNSSummaryCacheHitParamsQueryType = "HINFO"` - `const DNSSummaryCacheHitParamsQueryTypeHip DNSSummaryCacheHitParamsQueryType = "HIP"` - `const DNSSummaryCacheHitParamsQueryTypeHTTPS DNSSummaryCacheHitParamsQueryType = "HTTPS"` - `const DNSSummaryCacheHitParamsQueryTypeIpseckey DNSSummaryCacheHitParamsQueryType = "IPSECKEY"` - `const DNSSummaryCacheHitParamsQueryTypeIsdn DNSSummaryCacheHitParamsQueryType = "ISDN"` - `const DNSSummaryCacheHitParamsQueryTypeIxfr DNSSummaryCacheHitParamsQueryType = "IXFR"` - `const DNSSummaryCacheHitParamsQueryTypeKey DNSSummaryCacheHitParamsQueryType = "KEY"` - `const DNSSummaryCacheHitParamsQueryTypeKx DNSSummaryCacheHitParamsQueryType = "KX"` - `const DNSSummaryCacheHitParamsQueryTypeL32 DNSSummaryCacheHitParamsQueryType = "L32"` - `const DNSSummaryCacheHitParamsQueryTypeL64 DNSSummaryCacheHitParamsQueryType = "L64"` - `const DNSSummaryCacheHitParamsQueryTypeLOC DNSSummaryCacheHitParamsQueryType = "LOC"` - `const DNSSummaryCacheHitParamsQueryTypeLp DNSSummaryCacheHitParamsQueryType = "LP"` - `const DNSSummaryCacheHitParamsQueryTypeMaila DNSSummaryCacheHitParamsQueryType = "MAILA"` - `const DNSSummaryCacheHitParamsQueryTypeMailb DNSSummaryCacheHitParamsQueryType = "MAILB"` - `const DNSSummaryCacheHitParamsQueryTypeMB DNSSummaryCacheHitParamsQueryType = "MB"` - `const DNSSummaryCacheHitParamsQueryTypeMd DNSSummaryCacheHitParamsQueryType = "MD"` - `const DNSSummaryCacheHitParamsQueryTypeMf DNSSummaryCacheHitParamsQueryType = "MF"` - `const DNSSummaryCacheHitParamsQueryTypeMg DNSSummaryCacheHitParamsQueryType = "MG"` - `const DNSSummaryCacheHitParamsQueryTypeMinfo DNSSummaryCacheHitParamsQueryType = "MINFO"` - `const DNSSummaryCacheHitParamsQueryTypeMr DNSSummaryCacheHitParamsQueryType = "MR"` - `const DNSSummaryCacheHitParamsQueryTypeMX DNSSummaryCacheHitParamsQueryType = "MX"` - `const DNSSummaryCacheHitParamsQueryTypeNAPTR DNSSummaryCacheHitParamsQueryType = "NAPTR"` - `const DNSSummaryCacheHitParamsQueryTypeNb DNSSummaryCacheHitParamsQueryType = "NB"` - `const DNSSummaryCacheHitParamsQueryTypeNbstat DNSSummaryCacheHitParamsQueryType = "NBSTAT"` - `const DNSSummaryCacheHitParamsQueryTypeNid DNSSummaryCacheHitParamsQueryType = "NID"` - `const DNSSummaryCacheHitParamsQueryTypeNimloc DNSSummaryCacheHitParamsQueryType = "NIMLOC"` - `const DNSSummaryCacheHitParamsQueryTypeNinfo DNSSummaryCacheHitParamsQueryType = "NINFO"` - `const DNSSummaryCacheHitParamsQueryTypeNS DNSSummaryCacheHitParamsQueryType = "NS"` - `const DNSSummaryCacheHitParamsQueryTypeNsap DNSSummaryCacheHitParamsQueryType = "NSAP"` - `const DNSSummaryCacheHitParamsQueryTypeNsec DNSSummaryCacheHitParamsQueryType = "NSEC"` - `const DNSSummaryCacheHitParamsQueryTypeNsec3 DNSSummaryCacheHitParamsQueryType = "NSEC3"` - `const DNSSummaryCacheHitParamsQueryTypeNsec3Param DNSSummaryCacheHitParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryCacheHitParamsQueryTypeNull DNSSummaryCacheHitParamsQueryType = "NULL"` - `const DNSSummaryCacheHitParamsQueryTypeNxt DNSSummaryCacheHitParamsQueryType = "NXT"` - `const DNSSummaryCacheHitParamsQueryTypeOpenpgpkey DNSSummaryCacheHitParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryCacheHitParamsQueryTypeOpt DNSSummaryCacheHitParamsQueryType = "OPT"` - `const DNSSummaryCacheHitParamsQueryTypePTR DNSSummaryCacheHitParamsQueryType = "PTR"` - `const DNSSummaryCacheHitParamsQueryTypePx DNSSummaryCacheHitParamsQueryType = "PX"` - `const DNSSummaryCacheHitParamsQueryTypeRkey DNSSummaryCacheHitParamsQueryType = "RKEY"` - `const DNSSummaryCacheHitParamsQueryTypeRp DNSSummaryCacheHitParamsQueryType = "RP"` - `const DNSSummaryCacheHitParamsQueryTypeRrsig DNSSummaryCacheHitParamsQueryType = "RRSIG"` - `const DNSSummaryCacheHitParamsQueryTypeRt DNSSummaryCacheHitParamsQueryType = "RT"` - `const DNSSummaryCacheHitParamsQueryTypeSig DNSSummaryCacheHitParamsQueryType = "SIG"` - `const DNSSummaryCacheHitParamsQueryTypeSink DNSSummaryCacheHitParamsQueryType = "SINK"` - `const DNSSummaryCacheHitParamsQueryTypeSMIMEA DNSSummaryCacheHitParamsQueryType = "SMIMEA"` - `const DNSSummaryCacheHitParamsQueryTypeSOA DNSSummaryCacheHitParamsQueryType = "SOA"` - `const DNSSummaryCacheHitParamsQueryTypeSPF DNSSummaryCacheHitParamsQueryType = "SPF"` - `const DNSSummaryCacheHitParamsQueryTypeSRV DNSSummaryCacheHitParamsQueryType = "SRV"` - `const DNSSummaryCacheHitParamsQueryTypeSSHFP DNSSummaryCacheHitParamsQueryType = "SSHFP"` - `const DNSSummaryCacheHitParamsQueryTypeSVCB DNSSummaryCacheHitParamsQueryType = "SVCB"` - `const DNSSummaryCacheHitParamsQueryTypeTa DNSSummaryCacheHitParamsQueryType = "TA"` - `const DNSSummaryCacheHitParamsQueryTypeTalink DNSSummaryCacheHitParamsQueryType = "TALINK"` - `const DNSSummaryCacheHitParamsQueryTypeTkey DNSSummaryCacheHitParamsQueryType = "TKEY"` - `const DNSSummaryCacheHitParamsQueryTypeTLSA DNSSummaryCacheHitParamsQueryType = "TLSA"` - `const DNSSummaryCacheHitParamsQueryTypeTSIG DNSSummaryCacheHitParamsQueryType = "TSIG"` - `const DNSSummaryCacheHitParamsQueryTypeTXT DNSSummaryCacheHitParamsQueryType = "TXT"` - `const DNSSummaryCacheHitParamsQueryTypeUinfo DNSSummaryCacheHitParamsQueryType = "UINFO"` - `const DNSSummaryCacheHitParamsQueryTypeUID DNSSummaryCacheHitParamsQueryType = "UID"` - `const DNSSummaryCacheHitParamsQueryTypeUnspec DNSSummaryCacheHitParamsQueryType = "UNSPEC"` - `const DNSSummaryCacheHitParamsQueryTypeURI DNSSummaryCacheHitParamsQueryType = "URI"` - `const DNSSummaryCacheHitParamsQueryTypeWks DNSSummaryCacheHitParamsQueryType = "WKS"` - `const DNSSummaryCacheHitParamsQueryTypeX25 DNSSummaryCacheHitParamsQueryType = "X25"` - `const DNSSummaryCacheHitParamsQueryTypeZonemd DNSSummaryCacheHitParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryCacheHitParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryCacheHitParamsResponseCodeNoerror DNSSummaryCacheHitParamsResponseCode = "NOERROR"` - `const DNSSummaryCacheHitParamsResponseCodeFormerr DNSSummaryCacheHitParamsResponseCode = "FORMERR"` - `const DNSSummaryCacheHitParamsResponseCodeServfail DNSSummaryCacheHitParamsResponseCode = "SERVFAIL"` - `const DNSSummaryCacheHitParamsResponseCodeNxdomain DNSSummaryCacheHitParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryCacheHitParamsResponseCodeNotimp DNSSummaryCacheHitParamsResponseCode = "NOTIMP"` - `const DNSSummaryCacheHitParamsResponseCodeRefused DNSSummaryCacheHitParamsResponseCode = "REFUSED"` - `const DNSSummaryCacheHitParamsResponseCodeYxdomain DNSSummaryCacheHitParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryCacheHitParamsResponseCodeYxrrset DNSSummaryCacheHitParamsResponseCode = "YXRRSET"` - `const DNSSummaryCacheHitParamsResponseCodeNxrrset DNSSummaryCacheHitParamsResponseCode = "NXRRSET"` - `const DNSSummaryCacheHitParamsResponseCodeNotauth DNSSummaryCacheHitParamsResponseCode = "NOTAUTH"` - `const DNSSummaryCacheHitParamsResponseCodeNotzone DNSSummaryCacheHitParamsResponseCode = "NOTZONE"` - `const DNSSummaryCacheHitParamsResponseCodeBadsig DNSSummaryCacheHitParamsResponseCode = "BADSIG"` - `const DNSSummaryCacheHitParamsResponseCodeBadkey DNSSummaryCacheHitParamsResponseCode = "BADKEY"` - `const DNSSummaryCacheHitParamsResponseCodeBadtime DNSSummaryCacheHitParamsResponseCode = "BADTIME"` - `const DNSSummaryCacheHitParamsResponseCodeBadmode DNSSummaryCacheHitParamsResponseCode = "BADMODE"` - `const DNSSummaryCacheHitParamsResponseCodeBadname DNSSummaryCacheHitParamsResponseCode = "BADNAME"` - `const DNSSummaryCacheHitParamsResponseCodeBadalg DNSSummaryCacheHitParamsResponseCode = "BADALG"` - `const DNSSummaryCacheHitParamsResponseCodeBadtrunc DNSSummaryCacheHitParamsResponseCode = "BADTRUNC"` - `const DNSSummaryCacheHitParamsResponseCodeBadcookie DNSSummaryCacheHitParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryCacheHitResponse struct{…}` - `Meta DNSSummaryCacheHitResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryCacheHitResponseMetaConfidenceInfo` - `Annotations []DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryCacheHitResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryCacheHitResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryCacheHitResponseMetaNormalizationPercentage DNSSummaryCacheHitResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryCacheHitResponseMetaNormalizationMin0Max DNSSummaryCacheHitResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryCacheHitResponseMetaNormalizationMinMax DNSSummaryCacheHitResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryCacheHitResponseMetaNormalizationRawValues DNSSummaryCacheHitResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryCacheHitResponseMetaNormalizationPercentageChange DNSSummaryCacheHitResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryCacheHitResponseMetaNormalizationRollingAverage DNSSummaryCacheHitResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryCacheHitResponseMetaNormalizationOverlappedPercentage DNSSummaryCacheHitResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryCacheHitResponseMetaNormalizationRatio DNSSummaryCacheHitResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryCacheHitResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryCacheHitResponseSummary0` - `Negative string` A numeric string. - `Positive string` A numeric string. ### Example ```go 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.Summary.CacheHit(context.TODO(), radar.DNSSummaryCacheHitParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "NEGATIVE": "10", "POSITIVE": "10" } }, "success": true } ``` ## Get DNS queries by DNSSEC support summary `client.Radar.DNS.Summary.DNSSEC(ctx, query) (*DNSSummaryDNSSECResponse, error)` **get** `/radar/dns/summary/dnssec` Retrieves the distribution of DNS responses by DNSSEC (DNS Security Extensions) support. ### Parameters - `query DNSSummaryDNSSECParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryDNSSECParamsFormat]` Format in which results will be returned. - `const DNSSummaryDNSSECParamsFormatJson DNSSummaryDNSSECParamsFormat = "JSON"` - `const DNSSummaryDNSSECParamsFormatCsv DNSSummaryDNSSECParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryDNSSECParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryDNSSECParamsProtocolUdp DNSSummaryDNSSECParamsProtocol = "UDP"` - `const DNSSummaryDNSSECParamsProtocolTCP DNSSummaryDNSSECParamsProtocol = "TCP"` - `const DNSSummaryDNSSECParamsProtocolHTTPS DNSSummaryDNSSECParamsProtocol = "HTTPS"` - `const DNSSummaryDNSSECParamsProtocolTLS DNSSummaryDNSSECParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryDNSSECParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryDNSSECParamsQueryTypeA DNSSummaryDNSSECParamsQueryType = "A"` - `const DNSSummaryDNSSECParamsQueryTypeAAAA DNSSummaryDNSSECParamsQueryType = "AAAA"` - `const DNSSummaryDNSSECParamsQueryTypeA6 DNSSummaryDNSSECParamsQueryType = "A6"` - `const DNSSummaryDNSSECParamsQueryTypeAfsdb DNSSummaryDNSSECParamsQueryType = "AFSDB"` - `const DNSSummaryDNSSECParamsQueryTypeAny DNSSummaryDNSSECParamsQueryType = "ANY"` - `const DNSSummaryDNSSECParamsQueryTypeApl DNSSummaryDNSSECParamsQueryType = "APL"` - `const DNSSummaryDNSSECParamsQueryTypeAtma DNSSummaryDNSSECParamsQueryType = "ATMA"` - `const DNSSummaryDNSSECParamsQueryTypeAXFR DNSSummaryDNSSECParamsQueryType = "AXFR"` - `const DNSSummaryDNSSECParamsQueryTypeCAA DNSSummaryDNSSECParamsQueryType = "CAA"` - `const DNSSummaryDNSSECParamsQueryTypeCdnskey DNSSummaryDNSSECParamsQueryType = "CDNSKEY"` - `const DNSSummaryDNSSECParamsQueryTypeCds DNSSummaryDNSSECParamsQueryType = "CDS"` - `const DNSSummaryDNSSECParamsQueryTypeCERT DNSSummaryDNSSECParamsQueryType = "CERT"` - `const DNSSummaryDNSSECParamsQueryTypeCNAME DNSSummaryDNSSECParamsQueryType = "CNAME"` - `const DNSSummaryDNSSECParamsQueryTypeCsync DNSSummaryDNSSECParamsQueryType = "CSYNC"` - `const DNSSummaryDNSSECParamsQueryTypeDhcid DNSSummaryDNSSECParamsQueryType = "DHCID"` - `const DNSSummaryDNSSECParamsQueryTypeDlv DNSSummaryDNSSECParamsQueryType = "DLV"` - `const DNSSummaryDNSSECParamsQueryTypeDname DNSSummaryDNSSECParamsQueryType = "DNAME"` - `const DNSSummaryDNSSECParamsQueryTypeDNSKEY DNSSummaryDNSSECParamsQueryType = "DNSKEY"` - `const DNSSummaryDNSSECParamsQueryTypeDoa DNSSummaryDNSSECParamsQueryType = "DOA"` - `const DNSSummaryDNSSECParamsQueryTypeDS DNSSummaryDNSSECParamsQueryType = "DS"` - `const DNSSummaryDNSSECParamsQueryTypeEid DNSSummaryDNSSECParamsQueryType = "EID"` - `const DNSSummaryDNSSECParamsQueryTypeEui48 DNSSummaryDNSSECParamsQueryType = "EUI48"` - `const DNSSummaryDNSSECParamsQueryTypeEui64 DNSSummaryDNSSECParamsQueryType = "EUI64"` - `const DNSSummaryDNSSECParamsQueryTypeGpos DNSSummaryDNSSECParamsQueryType = "GPOS"` - `const DNSSummaryDNSSECParamsQueryTypeGid DNSSummaryDNSSECParamsQueryType = "GID"` - `const DNSSummaryDNSSECParamsQueryTypeHinfo DNSSummaryDNSSECParamsQueryType = "HINFO"` - `const DNSSummaryDNSSECParamsQueryTypeHip DNSSummaryDNSSECParamsQueryType = "HIP"` - `const DNSSummaryDNSSECParamsQueryTypeHTTPS DNSSummaryDNSSECParamsQueryType = "HTTPS"` - `const DNSSummaryDNSSECParamsQueryTypeIpseckey DNSSummaryDNSSECParamsQueryType = "IPSECKEY"` - `const DNSSummaryDNSSECParamsQueryTypeIsdn DNSSummaryDNSSECParamsQueryType = "ISDN"` - `const DNSSummaryDNSSECParamsQueryTypeIxfr DNSSummaryDNSSECParamsQueryType = "IXFR"` - `const DNSSummaryDNSSECParamsQueryTypeKey DNSSummaryDNSSECParamsQueryType = "KEY"` - `const DNSSummaryDNSSECParamsQueryTypeKx DNSSummaryDNSSECParamsQueryType = "KX"` - `const DNSSummaryDNSSECParamsQueryTypeL32 DNSSummaryDNSSECParamsQueryType = "L32"` - `const DNSSummaryDNSSECParamsQueryTypeL64 DNSSummaryDNSSECParamsQueryType = "L64"` - `const DNSSummaryDNSSECParamsQueryTypeLOC DNSSummaryDNSSECParamsQueryType = "LOC"` - `const DNSSummaryDNSSECParamsQueryTypeLp DNSSummaryDNSSECParamsQueryType = "LP"` - `const DNSSummaryDNSSECParamsQueryTypeMaila DNSSummaryDNSSECParamsQueryType = "MAILA"` - `const DNSSummaryDNSSECParamsQueryTypeMailb DNSSummaryDNSSECParamsQueryType = "MAILB"` - `const DNSSummaryDNSSECParamsQueryTypeMB DNSSummaryDNSSECParamsQueryType = "MB"` - `const DNSSummaryDNSSECParamsQueryTypeMd DNSSummaryDNSSECParamsQueryType = "MD"` - `const DNSSummaryDNSSECParamsQueryTypeMf DNSSummaryDNSSECParamsQueryType = "MF"` - `const DNSSummaryDNSSECParamsQueryTypeMg DNSSummaryDNSSECParamsQueryType = "MG"` - `const DNSSummaryDNSSECParamsQueryTypeMinfo DNSSummaryDNSSECParamsQueryType = "MINFO"` - `const DNSSummaryDNSSECParamsQueryTypeMr DNSSummaryDNSSECParamsQueryType = "MR"` - `const DNSSummaryDNSSECParamsQueryTypeMX DNSSummaryDNSSECParamsQueryType = "MX"` - `const DNSSummaryDNSSECParamsQueryTypeNAPTR DNSSummaryDNSSECParamsQueryType = "NAPTR"` - `const DNSSummaryDNSSECParamsQueryTypeNb DNSSummaryDNSSECParamsQueryType = "NB"` - `const DNSSummaryDNSSECParamsQueryTypeNbstat DNSSummaryDNSSECParamsQueryType = "NBSTAT"` - `const DNSSummaryDNSSECParamsQueryTypeNid DNSSummaryDNSSECParamsQueryType = "NID"` - `const DNSSummaryDNSSECParamsQueryTypeNimloc DNSSummaryDNSSECParamsQueryType = "NIMLOC"` - `const DNSSummaryDNSSECParamsQueryTypeNinfo DNSSummaryDNSSECParamsQueryType = "NINFO"` - `const DNSSummaryDNSSECParamsQueryTypeNS DNSSummaryDNSSECParamsQueryType = "NS"` - `const DNSSummaryDNSSECParamsQueryTypeNsap DNSSummaryDNSSECParamsQueryType = "NSAP"` - `const DNSSummaryDNSSECParamsQueryTypeNsec DNSSummaryDNSSECParamsQueryType = "NSEC"` - `const DNSSummaryDNSSECParamsQueryTypeNsec3 DNSSummaryDNSSECParamsQueryType = "NSEC3"` - `const DNSSummaryDNSSECParamsQueryTypeNsec3Param DNSSummaryDNSSECParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryDNSSECParamsQueryTypeNull DNSSummaryDNSSECParamsQueryType = "NULL"` - `const DNSSummaryDNSSECParamsQueryTypeNxt DNSSummaryDNSSECParamsQueryType = "NXT"` - `const DNSSummaryDNSSECParamsQueryTypeOpenpgpkey DNSSummaryDNSSECParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryDNSSECParamsQueryTypeOpt DNSSummaryDNSSECParamsQueryType = "OPT"` - `const DNSSummaryDNSSECParamsQueryTypePTR DNSSummaryDNSSECParamsQueryType = "PTR"` - `const DNSSummaryDNSSECParamsQueryTypePx DNSSummaryDNSSECParamsQueryType = "PX"` - `const DNSSummaryDNSSECParamsQueryTypeRkey DNSSummaryDNSSECParamsQueryType = "RKEY"` - `const DNSSummaryDNSSECParamsQueryTypeRp DNSSummaryDNSSECParamsQueryType = "RP"` - `const DNSSummaryDNSSECParamsQueryTypeRrsig DNSSummaryDNSSECParamsQueryType = "RRSIG"` - `const DNSSummaryDNSSECParamsQueryTypeRt DNSSummaryDNSSECParamsQueryType = "RT"` - `const DNSSummaryDNSSECParamsQueryTypeSig DNSSummaryDNSSECParamsQueryType = "SIG"` - `const DNSSummaryDNSSECParamsQueryTypeSink DNSSummaryDNSSECParamsQueryType = "SINK"` - `const DNSSummaryDNSSECParamsQueryTypeSMIMEA DNSSummaryDNSSECParamsQueryType = "SMIMEA"` - `const DNSSummaryDNSSECParamsQueryTypeSOA DNSSummaryDNSSECParamsQueryType = "SOA"` - `const DNSSummaryDNSSECParamsQueryTypeSPF DNSSummaryDNSSECParamsQueryType = "SPF"` - `const DNSSummaryDNSSECParamsQueryTypeSRV DNSSummaryDNSSECParamsQueryType = "SRV"` - `const DNSSummaryDNSSECParamsQueryTypeSSHFP DNSSummaryDNSSECParamsQueryType = "SSHFP"` - `const DNSSummaryDNSSECParamsQueryTypeSVCB DNSSummaryDNSSECParamsQueryType = "SVCB"` - `const DNSSummaryDNSSECParamsQueryTypeTa DNSSummaryDNSSECParamsQueryType = "TA"` - `const DNSSummaryDNSSECParamsQueryTypeTalink DNSSummaryDNSSECParamsQueryType = "TALINK"` - `const DNSSummaryDNSSECParamsQueryTypeTkey DNSSummaryDNSSECParamsQueryType = "TKEY"` - `const DNSSummaryDNSSECParamsQueryTypeTLSA DNSSummaryDNSSECParamsQueryType = "TLSA"` - `const DNSSummaryDNSSECParamsQueryTypeTSIG DNSSummaryDNSSECParamsQueryType = "TSIG"` - `const DNSSummaryDNSSECParamsQueryTypeTXT DNSSummaryDNSSECParamsQueryType = "TXT"` - `const DNSSummaryDNSSECParamsQueryTypeUinfo DNSSummaryDNSSECParamsQueryType = "UINFO"` - `const DNSSummaryDNSSECParamsQueryTypeUID DNSSummaryDNSSECParamsQueryType = "UID"` - `const DNSSummaryDNSSECParamsQueryTypeUnspec DNSSummaryDNSSECParamsQueryType = "UNSPEC"` - `const DNSSummaryDNSSECParamsQueryTypeURI DNSSummaryDNSSECParamsQueryType = "URI"` - `const DNSSummaryDNSSECParamsQueryTypeWks DNSSummaryDNSSECParamsQueryType = "WKS"` - `const DNSSummaryDNSSECParamsQueryTypeX25 DNSSummaryDNSSECParamsQueryType = "X25"` - `const DNSSummaryDNSSECParamsQueryTypeZonemd DNSSummaryDNSSECParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryDNSSECParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryDNSSECParamsResponseCodeNoerror DNSSummaryDNSSECParamsResponseCode = "NOERROR"` - `const DNSSummaryDNSSECParamsResponseCodeFormerr DNSSummaryDNSSECParamsResponseCode = "FORMERR"` - `const DNSSummaryDNSSECParamsResponseCodeServfail DNSSummaryDNSSECParamsResponseCode = "SERVFAIL"` - `const DNSSummaryDNSSECParamsResponseCodeNxdomain DNSSummaryDNSSECParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryDNSSECParamsResponseCodeNotimp DNSSummaryDNSSECParamsResponseCode = "NOTIMP"` - `const DNSSummaryDNSSECParamsResponseCodeRefused DNSSummaryDNSSECParamsResponseCode = "REFUSED"` - `const DNSSummaryDNSSECParamsResponseCodeYxdomain DNSSummaryDNSSECParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryDNSSECParamsResponseCodeYxrrset DNSSummaryDNSSECParamsResponseCode = "YXRRSET"` - `const DNSSummaryDNSSECParamsResponseCodeNxrrset DNSSummaryDNSSECParamsResponseCode = "NXRRSET"` - `const DNSSummaryDNSSECParamsResponseCodeNotauth DNSSummaryDNSSECParamsResponseCode = "NOTAUTH"` - `const DNSSummaryDNSSECParamsResponseCodeNotzone DNSSummaryDNSSECParamsResponseCode = "NOTZONE"` - `const DNSSummaryDNSSECParamsResponseCodeBadsig DNSSummaryDNSSECParamsResponseCode = "BADSIG"` - `const DNSSummaryDNSSECParamsResponseCodeBadkey DNSSummaryDNSSECParamsResponseCode = "BADKEY"` - `const DNSSummaryDNSSECParamsResponseCodeBadtime DNSSummaryDNSSECParamsResponseCode = "BADTIME"` - `const DNSSummaryDNSSECParamsResponseCodeBadmode DNSSummaryDNSSECParamsResponseCode = "BADMODE"` - `const DNSSummaryDNSSECParamsResponseCodeBadname DNSSummaryDNSSECParamsResponseCode = "BADNAME"` - `const DNSSummaryDNSSECParamsResponseCodeBadalg DNSSummaryDNSSECParamsResponseCode = "BADALG"` - `const DNSSummaryDNSSECParamsResponseCodeBadtrunc DNSSummaryDNSSECParamsResponseCode = "BADTRUNC"` - `const DNSSummaryDNSSECParamsResponseCodeBadcookie DNSSummaryDNSSECParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryDNSSECResponse struct{…}` - `Meta DNSSummaryDNSSECResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryDNSSECResponseMetaConfidenceInfo` - `Annotations []DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryDNSSECResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryDNSSECResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryDNSSECResponseMetaNormalizationPercentage DNSSummaryDNSSECResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryDNSSECResponseMetaNormalizationMin0Max DNSSummaryDNSSECResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryDNSSECResponseMetaNormalizationMinMax DNSSummaryDNSSECResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryDNSSECResponseMetaNormalizationRawValues DNSSummaryDNSSECResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryDNSSECResponseMetaNormalizationPercentageChange DNSSummaryDNSSECResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryDNSSECResponseMetaNormalizationRollingAverage DNSSummaryDNSSECResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryDNSSECResponseMetaNormalizationOverlappedPercentage DNSSummaryDNSSECResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryDNSSECResponseMetaNormalizationRatio DNSSummaryDNSSECResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryDNSSECResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryDNSSECResponseSummary0` - `Insecure string` A numeric string. - `Invalid string` A numeric string. - `Other string` A numeric string. - `Secure string` A numeric string. ### Example ```go 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.Summary.DNSSEC(context.TODO(), radar.DNSSummaryDNSSECParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "INSECURE": "10", "INVALID": "10", "OTHER": "10", "SECURE": "10" } }, "success": true } ``` ## Get DNS queries by DNSSEC awareness summary `client.Radar.DNS.Summary.DNSSECAware(ctx, query) (*DNSSummaryDNSSECAwareResponse, error)` **get** `/radar/dns/summary/dnssec_aware` Retrieves the distribution of DNS queries by DNSSEC (DNS Security Extensions) client awareness. ### Parameters - `query DNSSummaryDNSSECAwareParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryDNSSECAwareParamsFormat]` Format in which results will be returned. - `const DNSSummaryDNSSECAwareParamsFormatJson DNSSummaryDNSSECAwareParamsFormat = "JSON"` - `const DNSSummaryDNSSECAwareParamsFormatCsv DNSSummaryDNSSECAwareParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryDNSSECAwareParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryDNSSECAwareParamsProtocolUdp DNSSummaryDNSSECAwareParamsProtocol = "UDP"` - `const DNSSummaryDNSSECAwareParamsProtocolTCP DNSSummaryDNSSECAwareParamsProtocol = "TCP"` - `const DNSSummaryDNSSECAwareParamsProtocolHTTPS DNSSummaryDNSSECAwareParamsProtocol = "HTTPS"` - `const DNSSummaryDNSSECAwareParamsProtocolTLS DNSSummaryDNSSECAwareParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryDNSSECAwareParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryDNSSECAwareParamsQueryTypeA DNSSummaryDNSSECAwareParamsQueryType = "A"` - `const DNSSummaryDNSSECAwareParamsQueryTypeAAAA DNSSummaryDNSSECAwareParamsQueryType = "AAAA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeA6 DNSSummaryDNSSECAwareParamsQueryType = "A6"` - `const DNSSummaryDNSSECAwareParamsQueryTypeAfsdb DNSSummaryDNSSECAwareParamsQueryType = "AFSDB"` - `const DNSSummaryDNSSECAwareParamsQueryTypeAny DNSSummaryDNSSECAwareParamsQueryType = "ANY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeApl DNSSummaryDNSSECAwareParamsQueryType = "APL"` - `const DNSSummaryDNSSECAwareParamsQueryTypeAtma DNSSummaryDNSSECAwareParamsQueryType = "ATMA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeAXFR DNSSummaryDNSSECAwareParamsQueryType = "AXFR"` - `const DNSSummaryDNSSECAwareParamsQueryTypeCAA DNSSummaryDNSSECAwareParamsQueryType = "CAA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeCdnskey DNSSummaryDNSSECAwareParamsQueryType = "CDNSKEY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeCds DNSSummaryDNSSECAwareParamsQueryType = "CDS"` - `const DNSSummaryDNSSECAwareParamsQueryTypeCERT DNSSummaryDNSSECAwareParamsQueryType = "CERT"` - `const DNSSummaryDNSSECAwareParamsQueryTypeCNAME DNSSummaryDNSSECAwareParamsQueryType = "CNAME"` - `const DNSSummaryDNSSECAwareParamsQueryTypeCsync DNSSummaryDNSSECAwareParamsQueryType = "CSYNC"` - `const DNSSummaryDNSSECAwareParamsQueryTypeDhcid DNSSummaryDNSSECAwareParamsQueryType = "DHCID"` - `const DNSSummaryDNSSECAwareParamsQueryTypeDlv DNSSummaryDNSSECAwareParamsQueryType = "DLV"` - `const DNSSummaryDNSSECAwareParamsQueryTypeDname DNSSummaryDNSSECAwareParamsQueryType = "DNAME"` - `const DNSSummaryDNSSECAwareParamsQueryTypeDNSKEY DNSSummaryDNSSECAwareParamsQueryType = "DNSKEY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeDoa DNSSummaryDNSSECAwareParamsQueryType = "DOA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeDS DNSSummaryDNSSECAwareParamsQueryType = "DS"` - `const DNSSummaryDNSSECAwareParamsQueryTypeEid DNSSummaryDNSSECAwareParamsQueryType = "EID"` - `const DNSSummaryDNSSECAwareParamsQueryTypeEui48 DNSSummaryDNSSECAwareParamsQueryType = "EUI48"` - `const DNSSummaryDNSSECAwareParamsQueryTypeEui64 DNSSummaryDNSSECAwareParamsQueryType = "EUI64"` - `const DNSSummaryDNSSECAwareParamsQueryTypeGpos DNSSummaryDNSSECAwareParamsQueryType = "GPOS"` - `const DNSSummaryDNSSECAwareParamsQueryTypeGid DNSSummaryDNSSECAwareParamsQueryType = "GID"` - `const DNSSummaryDNSSECAwareParamsQueryTypeHinfo DNSSummaryDNSSECAwareParamsQueryType = "HINFO"` - `const DNSSummaryDNSSECAwareParamsQueryTypeHip DNSSummaryDNSSECAwareParamsQueryType = "HIP"` - `const DNSSummaryDNSSECAwareParamsQueryTypeHTTPS DNSSummaryDNSSECAwareParamsQueryType = "HTTPS"` - `const DNSSummaryDNSSECAwareParamsQueryTypeIpseckey DNSSummaryDNSSECAwareParamsQueryType = "IPSECKEY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeIsdn DNSSummaryDNSSECAwareParamsQueryType = "ISDN"` - `const DNSSummaryDNSSECAwareParamsQueryTypeIxfr DNSSummaryDNSSECAwareParamsQueryType = "IXFR"` - `const DNSSummaryDNSSECAwareParamsQueryTypeKey DNSSummaryDNSSECAwareParamsQueryType = "KEY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeKx DNSSummaryDNSSECAwareParamsQueryType = "KX"` - `const DNSSummaryDNSSECAwareParamsQueryTypeL32 DNSSummaryDNSSECAwareParamsQueryType = "L32"` - `const DNSSummaryDNSSECAwareParamsQueryTypeL64 DNSSummaryDNSSECAwareParamsQueryType = "L64"` - `const DNSSummaryDNSSECAwareParamsQueryTypeLOC DNSSummaryDNSSECAwareParamsQueryType = "LOC"` - `const DNSSummaryDNSSECAwareParamsQueryTypeLp DNSSummaryDNSSECAwareParamsQueryType = "LP"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMaila DNSSummaryDNSSECAwareParamsQueryType = "MAILA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMailb DNSSummaryDNSSECAwareParamsQueryType = "MAILB"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMB DNSSummaryDNSSECAwareParamsQueryType = "MB"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMd DNSSummaryDNSSECAwareParamsQueryType = "MD"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMf DNSSummaryDNSSECAwareParamsQueryType = "MF"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMg DNSSummaryDNSSECAwareParamsQueryType = "MG"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMinfo DNSSummaryDNSSECAwareParamsQueryType = "MINFO"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMr DNSSummaryDNSSECAwareParamsQueryType = "MR"` - `const DNSSummaryDNSSECAwareParamsQueryTypeMX DNSSummaryDNSSECAwareParamsQueryType = "MX"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNAPTR DNSSummaryDNSSECAwareParamsQueryType = "NAPTR"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNb DNSSummaryDNSSECAwareParamsQueryType = "NB"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNbstat DNSSummaryDNSSECAwareParamsQueryType = "NBSTAT"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNid DNSSummaryDNSSECAwareParamsQueryType = "NID"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNimloc DNSSummaryDNSSECAwareParamsQueryType = "NIMLOC"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNinfo DNSSummaryDNSSECAwareParamsQueryType = "NINFO"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNS DNSSummaryDNSSECAwareParamsQueryType = "NS"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNsap DNSSummaryDNSSECAwareParamsQueryType = "NSAP"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNsec DNSSummaryDNSSECAwareParamsQueryType = "NSEC"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNsec3 DNSSummaryDNSSECAwareParamsQueryType = "NSEC3"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNsec3Param DNSSummaryDNSSECAwareParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNull DNSSummaryDNSSECAwareParamsQueryType = "NULL"` - `const DNSSummaryDNSSECAwareParamsQueryTypeNxt DNSSummaryDNSSECAwareParamsQueryType = "NXT"` - `const DNSSummaryDNSSECAwareParamsQueryTypeOpenpgpkey DNSSummaryDNSSECAwareParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeOpt DNSSummaryDNSSECAwareParamsQueryType = "OPT"` - `const DNSSummaryDNSSECAwareParamsQueryTypePTR DNSSummaryDNSSECAwareParamsQueryType = "PTR"` - `const DNSSummaryDNSSECAwareParamsQueryTypePx DNSSummaryDNSSECAwareParamsQueryType = "PX"` - `const DNSSummaryDNSSECAwareParamsQueryTypeRkey DNSSummaryDNSSECAwareParamsQueryType = "RKEY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeRp DNSSummaryDNSSECAwareParamsQueryType = "RP"` - `const DNSSummaryDNSSECAwareParamsQueryTypeRrsig DNSSummaryDNSSECAwareParamsQueryType = "RRSIG"` - `const DNSSummaryDNSSECAwareParamsQueryTypeRt DNSSummaryDNSSECAwareParamsQueryType = "RT"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSig DNSSummaryDNSSECAwareParamsQueryType = "SIG"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSink DNSSummaryDNSSECAwareParamsQueryType = "SINK"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSMIMEA DNSSummaryDNSSECAwareParamsQueryType = "SMIMEA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSOA DNSSummaryDNSSECAwareParamsQueryType = "SOA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSPF DNSSummaryDNSSECAwareParamsQueryType = "SPF"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSRV DNSSummaryDNSSECAwareParamsQueryType = "SRV"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSSHFP DNSSummaryDNSSECAwareParamsQueryType = "SSHFP"` - `const DNSSummaryDNSSECAwareParamsQueryTypeSVCB DNSSummaryDNSSECAwareParamsQueryType = "SVCB"` - `const DNSSummaryDNSSECAwareParamsQueryTypeTa DNSSummaryDNSSECAwareParamsQueryType = "TA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeTalink DNSSummaryDNSSECAwareParamsQueryType = "TALINK"` - `const DNSSummaryDNSSECAwareParamsQueryTypeTkey DNSSummaryDNSSECAwareParamsQueryType = "TKEY"` - `const DNSSummaryDNSSECAwareParamsQueryTypeTLSA DNSSummaryDNSSECAwareParamsQueryType = "TLSA"` - `const DNSSummaryDNSSECAwareParamsQueryTypeTSIG DNSSummaryDNSSECAwareParamsQueryType = "TSIG"` - `const DNSSummaryDNSSECAwareParamsQueryTypeTXT DNSSummaryDNSSECAwareParamsQueryType = "TXT"` - `const DNSSummaryDNSSECAwareParamsQueryTypeUinfo DNSSummaryDNSSECAwareParamsQueryType = "UINFO"` - `const DNSSummaryDNSSECAwareParamsQueryTypeUID DNSSummaryDNSSECAwareParamsQueryType = "UID"` - `const DNSSummaryDNSSECAwareParamsQueryTypeUnspec DNSSummaryDNSSECAwareParamsQueryType = "UNSPEC"` - `const DNSSummaryDNSSECAwareParamsQueryTypeURI DNSSummaryDNSSECAwareParamsQueryType = "URI"` - `const DNSSummaryDNSSECAwareParamsQueryTypeWks DNSSummaryDNSSECAwareParamsQueryType = "WKS"` - `const DNSSummaryDNSSECAwareParamsQueryTypeX25 DNSSummaryDNSSECAwareParamsQueryType = "X25"` - `const DNSSummaryDNSSECAwareParamsQueryTypeZonemd DNSSummaryDNSSECAwareParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryDNSSECAwareParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryDNSSECAwareParamsResponseCodeNoerror DNSSummaryDNSSECAwareParamsResponseCode = "NOERROR"` - `const DNSSummaryDNSSECAwareParamsResponseCodeFormerr DNSSummaryDNSSECAwareParamsResponseCode = "FORMERR"` - `const DNSSummaryDNSSECAwareParamsResponseCodeServfail DNSSummaryDNSSECAwareParamsResponseCode = "SERVFAIL"` - `const DNSSummaryDNSSECAwareParamsResponseCodeNxdomain DNSSummaryDNSSECAwareParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryDNSSECAwareParamsResponseCodeNotimp DNSSummaryDNSSECAwareParamsResponseCode = "NOTIMP"` - `const DNSSummaryDNSSECAwareParamsResponseCodeRefused DNSSummaryDNSSECAwareParamsResponseCode = "REFUSED"` - `const DNSSummaryDNSSECAwareParamsResponseCodeYxdomain DNSSummaryDNSSECAwareParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryDNSSECAwareParamsResponseCodeYxrrset DNSSummaryDNSSECAwareParamsResponseCode = "YXRRSET"` - `const DNSSummaryDNSSECAwareParamsResponseCodeNxrrset DNSSummaryDNSSECAwareParamsResponseCode = "NXRRSET"` - `const DNSSummaryDNSSECAwareParamsResponseCodeNotauth DNSSummaryDNSSECAwareParamsResponseCode = "NOTAUTH"` - `const DNSSummaryDNSSECAwareParamsResponseCodeNotzone DNSSummaryDNSSECAwareParamsResponseCode = "NOTZONE"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadsig DNSSummaryDNSSECAwareParamsResponseCode = "BADSIG"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadkey DNSSummaryDNSSECAwareParamsResponseCode = "BADKEY"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadtime DNSSummaryDNSSECAwareParamsResponseCode = "BADTIME"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadmode DNSSummaryDNSSECAwareParamsResponseCode = "BADMODE"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadname DNSSummaryDNSSECAwareParamsResponseCode = "BADNAME"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadalg DNSSummaryDNSSECAwareParamsResponseCode = "BADALG"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadtrunc DNSSummaryDNSSECAwareParamsResponseCode = "BADTRUNC"` - `const DNSSummaryDNSSECAwareParamsResponseCodeBadcookie DNSSummaryDNSSECAwareParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryDNSSECAwareResponse struct{…}` - `Meta DNSSummaryDNSSECAwareResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryDNSSECAwareResponseMetaConfidenceInfo` - `Annotations []DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryDNSSECAwareResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryDNSSECAwareResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryDNSSECAwareResponseMetaNormalizationPercentage DNSSummaryDNSSECAwareResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryDNSSECAwareResponseMetaNormalizationMin0Max DNSSummaryDNSSECAwareResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryDNSSECAwareResponseMetaNormalizationMinMax DNSSummaryDNSSECAwareResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryDNSSECAwareResponseMetaNormalizationRawValues DNSSummaryDNSSECAwareResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryDNSSECAwareResponseMetaNormalizationPercentageChange DNSSummaryDNSSECAwareResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryDNSSECAwareResponseMetaNormalizationRollingAverage DNSSummaryDNSSECAwareResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryDNSSECAwareResponseMetaNormalizationOverlappedPercentage DNSSummaryDNSSECAwareResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryDNSSECAwareResponseMetaNormalizationRatio DNSSummaryDNSSECAwareResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryDNSSECAwareResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryDNSSECAwareResponseSummary0` - `NotSupported string` A numeric string. - `Supported string` A numeric string. ### Example ```go 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.Summary.DNSSECAware(context.TODO(), radar.DNSSummaryDNSSECAwareParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "NOT_SUPPORTED": "10", "SUPPORTED": "10" } }, "success": true } ``` ## Get DNS queries by DNSSEC end-to-end summary `client.Radar.DNS.Summary.DNSSECE2E(ctx, query) (*DNSSummaryDnssece2EResponse, error)` **get** `/radar/dns/summary/dnssec_e2e` Retrieves the distribution of DNSSEC-validated answers by end-to-end security status. ### Parameters - `query DNSSummaryDNSSECE2EParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryDnssece2EParamsFormat]` Format in which results will be returned. - `const DNSSummaryDnssece2EParamsFormatJson DNSSummaryDnssece2EParamsFormat = "JSON"` - `const DNSSummaryDnssece2EParamsFormatCsv DNSSummaryDnssece2EParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryDnssece2EParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryDnssece2EParamsProtocolUdp DNSSummaryDnssece2EParamsProtocol = "UDP"` - `const DNSSummaryDnssece2EParamsProtocolTCP DNSSummaryDnssece2EParamsProtocol = "TCP"` - `const DNSSummaryDnssece2EParamsProtocolHTTPS DNSSummaryDnssece2EParamsProtocol = "HTTPS"` - `const DNSSummaryDnssece2EParamsProtocolTLS DNSSummaryDnssece2EParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryDnssece2EParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryDnssece2EParamsQueryTypeA DNSSummaryDnssece2EParamsQueryType = "A"` - `const DNSSummaryDnssece2EParamsQueryTypeAAAA DNSSummaryDnssece2EParamsQueryType = "AAAA"` - `const DNSSummaryDnssece2EParamsQueryTypeA6 DNSSummaryDnssece2EParamsQueryType = "A6"` - `const DNSSummaryDnssece2EParamsQueryTypeAfsdb DNSSummaryDnssece2EParamsQueryType = "AFSDB"` - `const DNSSummaryDnssece2EParamsQueryTypeAny DNSSummaryDnssece2EParamsQueryType = "ANY"` - `const DNSSummaryDnssece2EParamsQueryTypeApl DNSSummaryDnssece2EParamsQueryType = "APL"` - `const DNSSummaryDnssece2EParamsQueryTypeAtma DNSSummaryDnssece2EParamsQueryType = "ATMA"` - `const DNSSummaryDnssece2EParamsQueryTypeAXFR DNSSummaryDnssece2EParamsQueryType = "AXFR"` - `const DNSSummaryDnssece2EParamsQueryTypeCAA DNSSummaryDnssece2EParamsQueryType = "CAA"` - `const DNSSummaryDnssece2EParamsQueryTypeCdnskey DNSSummaryDnssece2EParamsQueryType = "CDNSKEY"` - `const DNSSummaryDnssece2EParamsQueryTypeCds DNSSummaryDnssece2EParamsQueryType = "CDS"` - `const DNSSummaryDnssece2EParamsQueryTypeCERT DNSSummaryDnssece2EParamsQueryType = "CERT"` - `const DNSSummaryDnssece2EParamsQueryTypeCNAME DNSSummaryDnssece2EParamsQueryType = "CNAME"` - `const DNSSummaryDnssece2EParamsQueryTypeCsync DNSSummaryDnssece2EParamsQueryType = "CSYNC"` - `const DNSSummaryDnssece2EParamsQueryTypeDhcid DNSSummaryDnssece2EParamsQueryType = "DHCID"` - `const DNSSummaryDnssece2EParamsQueryTypeDlv DNSSummaryDnssece2EParamsQueryType = "DLV"` - `const DNSSummaryDnssece2EParamsQueryTypeDname DNSSummaryDnssece2EParamsQueryType = "DNAME"` - `const DNSSummaryDnssece2EParamsQueryTypeDNSKEY DNSSummaryDnssece2EParamsQueryType = "DNSKEY"` - `const DNSSummaryDnssece2EParamsQueryTypeDoa DNSSummaryDnssece2EParamsQueryType = "DOA"` - `const DNSSummaryDnssece2EParamsQueryTypeDS DNSSummaryDnssece2EParamsQueryType = "DS"` - `const DNSSummaryDnssece2EParamsQueryTypeEid DNSSummaryDnssece2EParamsQueryType = "EID"` - `const DNSSummaryDnssece2EParamsQueryTypeEui48 DNSSummaryDnssece2EParamsQueryType = "EUI48"` - `const DNSSummaryDnssece2EParamsQueryTypeEui64 DNSSummaryDnssece2EParamsQueryType = "EUI64"` - `const DNSSummaryDnssece2EParamsQueryTypeGpos DNSSummaryDnssece2EParamsQueryType = "GPOS"` - `const DNSSummaryDnssece2EParamsQueryTypeGid DNSSummaryDnssece2EParamsQueryType = "GID"` - `const DNSSummaryDnssece2EParamsQueryTypeHinfo DNSSummaryDnssece2EParamsQueryType = "HINFO"` - `const DNSSummaryDnssece2EParamsQueryTypeHip DNSSummaryDnssece2EParamsQueryType = "HIP"` - `const DNSSummaryDnssece2EParamsQueryTypeHTTPS DNSSummaryDnssece2EParamsQueryType = "HTTPS"` - `const DNSSummaryDnssece2EParamsQueryTypeIpseckey DNSSummaryDnssece2EParamsQueryType = "IPSECKEY"` - `const DNSSummaryDnssece2EParamsQueryTypeIsdn DNSSummaryDnssece2EParamsQueryType = "ISDN"` - `const DNSSummaryDnssece2EParamsQueryTypeIxfr DNSSummaryDnssece2EParamsQueryType = "IXFR"` - `const DNSSummaryDnssece2EParamsQueryTypeKey DNSSummaryDnssece2EParamsQueryType = "KEY"` - `const DNSSummaryDnssece2EParamsQueryTypeKx DNSSummaryDnssece2EParamsQueryType = "KX"` - `const DNSSummaryDnssece2EParamsQueryTypeL32 DNSSummaryDnssece2EParamsQueryType = "L32"` - `const DNSSummaryDnssece2EParamsQueryTypeL64 DNSSummaryDnssece2EParamsQueryType = "L64"` - `const DNSSummaryDnssece2EParamsQueryTypeLOC DNSSummaryDnssece2EParamsQueryType = "LOC"` - `const DNSSummaryDnssece2EParamsQueryTypeLp DNSSummaryDnssece2EParamsQueryType = "LP"` - `const DNSSummaryDnssece2EParamsQueryTypeMaila DNSSummaryDnssece2EParamsQueryType = "MAILA"` - `const DNSSummaryDnssece2EParamsQueryTypeMailb DNSSummaryDnssece2EParamsQueryType = "MAILB"` - `const DNSSummaryDnssece2EParamsQueryTypeMB DNSSummaryDnssece2EParamsQueryType = "MB"` - `const DNSSummaryDnssece2EParamsQueryTypeMd DNSSummaryDnssece2EParamsQueryType = "MD"` - `const DNSSummaryDnssece2EParamsQueryTypeMf DNSSummaryDnssece2EParamsQueryType = "MF"` - `const DNSSummaryDnssece2EParamsQueryTypeMg DNSSummaryDnssece2EParamsQueryType = "MG"` - `const DNSSummaryDnssece2EParamsQueryTypeMinfo DNSSummaryDnssece2EParamsQueryType = "MINFO"` - `const DNSSummaryDnssece2EParamsQueryTypeMr DNSSummaryDnssece2EParamsQueryType = "MR"` - `const DNSSummaryDnssece2EParamsQueryTypeMX DNSSummaryDnssece2EParamsQueryType = "MX"` - `const DNSSummaryDnssece2EParamsQueryTypeNAPTR DNSSummaryDnssece2EParamsQueryType = "NAPTR"` - `const DNSSummaryDnssece2EParamsQueryTypeNb DNSSummaryDnssece2EParamsQueryType = "NB"` - `const DNSSummaryDnssece2EParamsQueryTypeNbstat DNSSummaryDnssece2EParamsQueryType = "NBSTAT"` - `const DNSSummaryDnssece2EParamsQueryTypeNid DNSSummaryDnssece2EParamsQueryType = "NID"` - `const DNSSummaryDnssece2EParamsQueryTypeNimloc DNSSummaryDnssece2EParamsQueryType = "NIMLOC"` - `const DNSSummaryDnssece2EParamsQueryTypeNinfo DNSSummaryDnssece2EParamsQueryType = "NINFO"` - `const DNSSummaryDnssece2EParamsQueryTypeNS DNSSummaryDnssece2EParamsQueryType = "NS"` - `const DNSSummaryDnssece2EParamsQueryTypeNsap DNSSummaryDnssece2EParamsQueryType = "NSAP"` - `const DNSSummaryDnssece2EParamsQueryTypeNsec DNSSummaryDnssece2EParamsQueryType = "NSEC"` - `const DNSSummaryDnssece2EParamsQueryTypeNsec3 DNSSummaryDnssece2EParamsQueryType = "NSEC3"` - `const DNSSummaryDnssece2EParamsQueryTypeNsec3Param DNSSummaryDnssece2EParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryDnssece2EParamsQueryTypeNull DNSSummaryDnssece2EParamsQueryType = "NULL"` - `const DNSSummaryDnssece2EParamsQueryTypeNxt DNSSummaryDnssece2EParamsQueryType = "NXT"` - `const DNSSummaryDnssece2EParamsQueryTypeOpenpgpkey DNSSummaryDnssece2EParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryDnssece2EParamsQueryTypeOpt DNSSummaryDnssece2EParamsQueryType = "OPT"` - `const DNSSummaryDnssece2EParamsQueryTypePTR DNSSummaryDnssece2EParamsQueryType = "PTR"` - `const DNSSummaryDnssece2EParamsQueryTypePx DNSSummaryDnssece2EParamsQueryType = "PX"` - `const DNSSummaryDnssece2EParamsQueryTypeRkey DNSSummaryDnssece2EParamsQueryType = "RKEY"` - `const DNSSummaryDnssece2EParamsQueryTypeRp DNSSummaryDnssece2EParamsQueryType = "RP"` - `const DNSSummaryDnssece2EParamsQueryTypeRrsig DNSSummaryDnssece2EParamsQueryType = "RRSIG"` - `const DNSSummaryDnssece2EParamsQueryTypeRt DNSSummaryDnssece2EParamsQueryType = "RT"` - `const DNSSummaryDnssece2EParamsQueryTypeSig DNSSummaryDnssece2EParamsQueryType = "SIG"` - `const DNSSummaryDnssece2EParamsQueryTypeSink DNSSummaryDnssece2EParamsQueryType = "SINK"` - `const DNSSummaryDnssece2EParamsQueryTypeSMIMEA DNSSummaryDnssece2EParamsQueryType = "SMIMEA"` - `const DNSSummaryDnssece2EParamsQueryTypeSOA DNSSummaryDnssece2EParamsQueryType = "SOA"` - `const DNSSummaryDnssece2EParamsQueryTypeSPF DNSSummaryDnssece2EParamsQueryType = "SPF"` - `const DNSSummaryDnssece2EParamsQueryTypeSRV DNSSummaryDnssece2EParamsQueryType = "SRV"` - `const DNSSummaryDnssece2EParamsQueryTypeSSHFP DNSSummaryDnssece2EParamsQueryType = "SSHFP"` - `const DNSSummaryDnssece2EParamsQueryTypeSVCB DNSSummaryDnssece2EParamsQueryType = "SVCB"` - `const DNSSummaryDnssece2EParamsQueryTypeTa DNSSummaryDnssece2EParamsQueryType = "TA"` - `const DNSSummaryDnssece2EParamsQueryTypeTalink DNSSummaryDnssece2EParamsQueryType = "TALINK"` - `const DNSSummaryDnssece2EParamsQueryTypeTkey DNSSummaryDnssece2EParamsQueryType = "TKEY"` - `const DNSSummaryDnssece2EParamsQueryTypeTLSA DNSSummaryDnssece2EParamsQueryType = "TLSA"` - `const DNSSummaryDnssece2EParamsQueryTypeTSIG DNSSummaryDnssece2EParamsQueryType = "TSIG"` - `const DNSSummaryDnssece2EParamsQueryTypeTXT DNSSummaryDnssece2EParamsQueryType = "TXT"` - `const DNSSummaryDnssece2EParamsQueryTypeUinfo DNSSummaryDnssece2EParamsQueryType = "UINFO"` - `const DNSSummaryDnssece2EParamsQueryTypeUID DNSSummaryDnssece2EParamsQueryType = "UID"` - `const DNSSummaryDnssece2EParamsQueryTypeUnspec DNSSummaryDnssece2EParamsQueryType = "UNSPEC"` - `const DNSSummaryDnssece2EParamsQueryTypeURI DNSSummaryDnssece2EParamsQueryType = "URI"` - `const DNSSummaryDnssece2EParamsQueryTypeWks DNSSummaryDnssece2EParamsQueryType = "WKS"` - `const DNSSummaryDnssece2EParamsQueryTypeX25 DNSSummaryDnssece2EParamsQueryType = "X25"` - `const DNSSummaryDnssece2EParamsQueryTypeZonemd DNSSummaryDnssece2EParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryDnssece2EParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryDnssece2EParamsResponseCodeNoerror DNSSummaryDnssece2EParamsResponseCode = "NOERROR"` - `const DNSSummaryDnssece2EParamsResponseCodeFormerr DNSSummaryDnssece2EParamsResponseCode = "FORMERR"` - `const DNSSummaryDnssece2EParamsResponseCodeServfail DNSSummaryDnssece2EParamsResponseCode = "SERVFAIL"` - `const DNSSummaryDnssece2EParamsResponseCodeNxdomain DNSSummaryDnssece2EParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryDnssece2EParamsResponseCodeNotimp DNSSummaryDnssece2EParamsResponseCode = "NOTIMP"` - `const DNSSummaryDnssece2EParamsResponseCodeRefused DNSSummaryDnssece2EParamsResponseCode = "REFUSED"` - `const DNSSummaryDnssece2EParamsResponseCodeYxdomain DNSSummaryDnssece2EParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryDnssece2EParamsResponseCodeYxrrset DNSSummaryDnssece2EParamsResponseCode = "YXRRSET"` - `const DNSSummaryDnssece2EParamsResponseCodeNxrrset DNSSummaryDnssece2EParamsResponseCode = "NXRRSET"` - `const DNSSummaryDnssece2EParamsResponseCodeNotauth DNSSummaryDnssece2EParamsResponseCode = "NOTAUTH"` - `const DNSSummaryDnssece2EParamsResponseCodeNotzone DNSSummaryDnssece2EParamsResponseCode = "NOTZONE"` - `const DNSSummaryDnssece2EParamsResponseCodeBadsig DNSSummaryDnssece2EParamsResponseCode = "BADSIG"` - `const DNSSummaryDnssece2EParamsResponseCodeBadkey DNSSummaryDnssece2EParamsResponseCode = "BADKEY"` - `const DNSSummaryDnssece2EParamsResponseCodeBadtime DNSSummaryDnssece2EParamsResponseCode = "BADTIME"` - `const DNSSummaryDnssece2EParamsResponseCodeBadmode DNSSummaryDnssece2EParamsResponseCode = "BADMODE"` - `const DNSSummaryDnssece2EParamsResponseCodeBadname DNSSummaryDnssece2EParamsResponseCode = "BADNAME"` - `const DNSSummaryDnssece2EParamsResponseCodeBadalg DNSSummaryDnssece2EParamsResponseCode = "BADALG"` - `const DNSSummaryDnssece2EParamsResponseCodeBadtrunc DNSSummaryDnssece2EParamsResponseCode = "BADTRUNC"` - `const DNSSummaryDnssece2EParamsResponseCodeBadcookie DNSSummaryDnssece2EParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryDnssece2EResponse struct{…}` - `Meta DNSSummaryDnssece2EResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryDnssece2EResponseMetaConfidenceInfo` - `Annotations []DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryDnssece2EResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryDnssece2EResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryDnssece2EResponseMetaNormalizationPercentage DNSSummaryDnssece2EResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryDnssece2EResponseMetaNormalizationMin0Max DNSSummaryDnssece2EResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryDnssece2EResponseMetaNormalizationMinMax DNSSummaryDnssece2EResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryDnssece2EResponseMetaNormalizationRawValues DNSSummaryDnssece2EResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryDnssece2EResponseMetaNormalizationPercentageChange DNSSummaryDnssece2EResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryDnssece2EResponseMetaNormalizationRollingAverage DNSSummaryDnssece2EResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryDnssece2EResponseMetaNormalizationOverlappedPercentage DNSSummaryDnssece2EResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryDnssece2EResponseMetaNormalizationRatio DNSSummaryDnssece2EResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryDnssece2EResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryDnssece2EResponseSummary0` - `Negative string` A numeric string. - `Positive string` A numeric string. ### Example ```go 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.Summary.DNSSECE2E(context.TODO(), radar.DNSSummaryDNSSECE2EParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "NEGATIVE": "10", "POSITIVE": "10" } }, "success": true } ``` ## Get DNS queries by IP version summary `client.Radar.DNS.Summary.IPVersion(ctx, query) (*DNSSummaryIPVersionResponse, error)` **get** `/radar/dns/summary/ip_version` Retrieves the distribution of DNS queries by IP version. ### Parameters - `query DNSSummaryIPVersionParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryIPVersionParamsFormat]` Format in which results will be returned. - `const DNSSummaryIPVersionParamsFormatJson DNSSummaryIPVersionParamsFormat = "JSON"` - `const DNSSummaryIPVersionParamsFormatCsv DNSSummaryIPVersionParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryIPVersionParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryIPVersionParamsProtocolUdp DNSSummaryIPVersionParamsProtocol = "UDP"` - `const DNSSummaryIPVersionParamsProtocolTCP DNSSummaryIPVersionParamsProtocol = "TCP"` - `const DNSSummaryIPVersionParamsProtocolHTTPS DNSSummaryIPVersionParamsProtocol = "HTTPS"` - `const DNSSummaryIPVersionParamsProtocolTLS DNSSummaryIPVersionParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryIPVersionParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryIPVersionParamsQueryTypeA DNSSummaryIPVersionParamsQueryType = "A"` - `const DNSSummaryIPVersionParamsQueryTypeAAAA DNSSummaryIPVersionParamsQueryType = "AAAA"` - `const DNSSummaryIPVersionParamsQueryTypeA6 DNSSummaryIPVersionParamsQueryType = "A6"` - `const DNSSummaryIPVersionParamsQueryTypeAfsdb DNSSummaryIPVersionParamsQueryType = "AFSDB"` - `const DNSSummaryIPVersionParamsQueryTypeAny DNSSummaryIPVersionParamsQueryType = "ANY"` - `const DNSSummaryIPVersionParamsQueryTypeApl DNSSummaryIPVersionParamsQueryType = "APL"` - `const DNSSummaryIPVersionParamsQueryTypeAtma DNSSummaryIPVersionParamsQueryType = "ATMA"` - `const DNSSummaryIPVersionParamsQueryTypeAXFR DNSSummaryIPVersionParamsQueryType = "AXFR"` - `const DNSSummaryIPVersionParamsQueryTypeCAA DNSSummaryIPVersionParamsQueryType = "CAA"` - `const DNSSummaryIPVersionParamsQueryTypeCdnskey DNSSummaryIPVersionParamsQueryType = "CDNSKEY"` - `const DNSSummaryIPVersionParamsQueryTypeCds DNSSummaryIPVersionParamsQueryType = "CDS"` - `const DNSSummaryIPVersionParamsQueryTypeCERT DNSSummaryIPVersionParamsQueryType = "CERT"` - `const DNSSummaryIPVersionParamsQueryTypeCNAME DNSSummaryIPVersionParamsQueryType = "CNAME"` - `const DNSSummaryIPVersionParamsQueryTypeCsync DNSSummaryIPVersionParamsQueryType = "CSYNC"` - `const DNSSummaryIPVersionParamsQueryTypeDhcid DNSSummaryIPVersionParamsQueryType = "DHCID"` - `const DNSSummaryIPVersionParamsQueryTypeDlv DNSSummaryIPVersionParamsQueryType = "DLV"` - `const DNSSummaryIPVersionParamsQueryTypeDname DNSSummaryIPVersionParamsQueryType = "DNAME"` - `const DNSSummaryIPVersionParamsQueryTypeDNSKEY DNSSummaryIPVersionParamsQueryType = "DNSKEY"` - `const DNSSummaryIPVersionParamsQueryTypeDoa DNSSummaryIPVersionParamsQueryType = "DOA"` - `const DNSSummaryIPVersionParamsQueryTypeDS DNSSummaryIPVersionParamsQueryType = "DS"` - `const DNSSummaryIPVersionParamsQueryTypeEid DNSSummaryIPVersionParamsQueryType = "EID"` - `const DNSSummaryIPVersionParamsQueryTypeEui48 DNSSummaryIPVersionParamsQueryType = "EUI48"` - `const DNSSummaryIPVersionParamsQueryTypeEui64 DNSSummaryIPVersionParamsQueryType = "EUI64"` - `const DNSSummaryIPVersionParamsQueryTypeGpos DNSSummaryIPVersionParamsQueryType = "GPOS"` - `const DNSSummaryIPVersionParamsQueryTypeGid DNSSummaryIPVersionParamsQueryType = "GID"` - `const DNSSummaryIPVersionParamsQueryTypeHinfo DNSSummaryIPVersionParamsQueryType = "HINFO"` - `const DNSSummaryIPVersionParamsQueryTypeHip DNSSummaryIPVersionParamsQueryType = "HIP"` - `const DNSSummaryIPVersionParamsQueryTypeHTTPS DNSSummaryIPVersionParamsQueryType = "HTTPS"` - `const DNSSummaryIPVersionParamsQueryTypeIpseckey DNSSummaryIPVersionParamsQueryType = "IPSECKEY"` - `const DNSSummaryIPVersionParamsQueryTypeIsdn DNSSummaryIPVersionParamsQueryType = "ISDN"` - `const DNSSummaryIPVersionParamsQueryTypeIxfr DNSSummaryIPVersionParamsQueryType = "IXFR"` - `const DNSSummaryIPVersionParamsQueryTypeKey DNSSummaryIPVersionParamsQueryType = "KEY"` - `const DNSSummaryIPVersionParamsQueryTypeKx DNSSummaryIPVersionParamsQueryType = "KX"` - `const DNSSummaryIPVersionParamsQueryTypeL32 DNSSummaryIPVersionParamsQueryType = "L32"` - `const DNSSummaryIPVersionParamsQueryTypeL64 DNSSummaryIPVersionParamsQueryType = "L64"` - `const DNSSummaryIPVersionParamsQueryTypeLOC DNSSummaryIPVersionParamsQueryType = "LOC"` - `const DNSSummaryIPVersionParamsQueryTypeLp DNSSummaryIPVersionParamsQueryType = "LP"` - `const DNSSummaryIPVersionParamsQueryTypeMaila DNSSummaryIPVersionParamsQueryType = "MAILA"` - `const DNSSummaryIPVersionParamsQueryTypeMailb DNSSummaryIPVersionParamsQueryType = "MAILB"` - `const DNSSummaryIPVersionParamsQueryTypeMB DNSSummaryIPVersionParamsQueryType = "MB"` - `const DNSSummaryIPVersionParamsQueryTypeMd DNSSummaryIPVersionParamsQueryType = "MD"` - `const DNSSummaryIPVersionParamsQueryTypeMf DNSSummaryIPVersionParamsQueryType = "MF"` - `const DNSSummaryIPVersionParamsQueryTypeMg DNSSummaryIPVersionParamsQueryType = "MG"` - `const DNSSummaryIPVersionParamsQueryTypeMinfo DNSSummaryIPVersionParamsQueryType = "MINFO"` - `const DNSSummaryIPVersionParamsQueryTypeMr DNSSummaryIPVersionParamsQueryType = "MR"` - `const DNSSummaryIPVersionParamsQueryTypeMX DNSSummaryIPVersionParamsQueryType = "MX"` - `const DNSSummaryIPVersionParamsQueryTypeNAPTR DNSSummaryIPVersionParamsQueryType = "NAPTR"` - `const DNSSummaryIPVersionParamsQueryTypeNb DNSSummaryIPVersionParamsQueryType = "NB"` - `const DNSSummaryIPVersionParamsQueryTypeNbstat DNSSummaryIPVersionParamsQueryType = "NBSTAT"` - `const DNSSummaryIPVersionParamsQueryTypeNid DNSSummaryIPVersionParamsQueryType = "NID"` - `const DNSSummaryIPVersionParamsQueryTypeNimloc DNSSummaryIPVersionParamsQueryType = "NIMLOC"` - `const DNSSummaryIPVersionParamsQueryTypeNinfo DNSSummaryIPVersionParamsQueryType = "NINFO"` - `const DNSSummaryIPVersionParamsQueryTypeNS DNSSummaryIPVersionParamsQueryType = "NS"` - `const DNSSummaryIPVersionParamsQueryTypeNsap DNSSummaryIPVersionParamsQueryType = "NSAP"` - `const DNSSummaryIPVersionParamsQueryTypeNsec DNSSummaryIPVersionParamsQueryType = "NSEC"` - `const DNSSummaryIPVersionParamsQueryTypeNsec3 DNSSummaryIPVersionParamsQueryType = "NSEC3"` - `const DNSSummaryIPVersionParamsQueryTypeNsec3Param DNSSummaryIPVersionParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryIPVersionParamsQueryTypeNull DNSSummaryIPVersionParamsQueryType = "NULL"` - `const DNSSummaryIPVersionParamsQueryTypeNxt DNSSummaryIPVersionParamsQueryType = "NXT"` - `const DNSSummaryIPVersionParamsQueryTypeOpenpgpkey DNSSummaryIPVersionParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryIPVersionParamsQueryTypeOpt DNSSummaryIPVersionParamsQueryType = "OPT"` - `const DNSSummaryIPVersionParamsQueryTypePTR DNSSummaryIPVersionParamsQueryType = "PTR"` - `const DNSSummaryIPVersionParamsQueryTypePx DNSSummaryIPVersionParamsQueryType = "PX"` - `const DNSSummaryIPVersionParamsQueryTypeRkey DNSSummaryIPVersionParamsQueryType = "RKEY"` - `const DNSSummaryIPVersionParamsQueryTypeRp DNSSummaryIPVersionParamsQueryType = "RP"` - `const DNSSummaryIPVersionParamsQueryTypeRrsig DNSSummaryIPVersionParamsQueryType = "RRSIG"` - `const DNSSummaryIPVersionParamsQueryTypeRt DNSSummaryIPVersionParamsQueryType = "RT"` - `const DNSSummaryIPVersionParamsQueryTypeSig DNSSummaryIPVersionParamsQueryType = "SIG"` - `const DNSSummaryIPVersionParamsQueryTypeSink DNSSummaryIPVersionParamsQueryType = "SINK"` - `const DNSSummaryIPVersionParamsQueryTypeSMIMEA DNSSummaryIPVersionParamsQueryType = "SMIMEA"` - `const DNSSummaryIPVersionParamsQueryTypeSOA DNSSummaryIPVersionParamsQueryType = "SOA"` - `const DNSSummaryIPVersionParamsQueryTypeSPF DNSSummaryIPVersionParamsQueryType = "SPF"` - `const DNSSummaryIPVersionParamsQueryTypeSRV DNSSummaryIPVersionParamsQueryType = "SRV"` - `const DNSSummaryIPVersionParamsQueryTypeSSHFP DNSSummaryIPVersionParamsQueryType = "SSHFP"` - `const DNSSummaryIPVersionParamsQueryTypeSVCB DNSSummaryIPVersionParamsQueryType = "SVCB"` - `const DNSSummaryIPVersionParamsQueryTypeTa DNSSummaryIPVersionParamsQueryType = "TA"` - `const DNSSummaryIPVersionParamsQueryTypeTalink DNSSummaryIPVersionParamsQueryType = "TALINK"` - `const DNSSummaryIPVersionParamsQueryTypeTkey DNSSummaryIPVersionParamsQueryType = "TKEY"` - `const DNSSummaryIPVersionParamsQueryTypeTLSA DNSSummaryIPVersionParamsQueryType = "TLSA"` - `const DNSSummaryIPVersionParamsQueryTypeTSIG DNSSummaryIPVersionParamsQueryType = "TSIG"` - `const DNSSummaryIPVersionParamsQueryTypeTXT DNSSummaryIPVersionParamsQueryType = "TXT"` - `const DNSSummaryIPVersionParamsQueryTypeUinfo DNSSummaryIPVersionParamsQueryType = "UINFO"` - `const DNSSummaryIPVersionParamsQueryTypeUID DNSSummaryIPVersionParamsQueryType = "UID"` - `const DNSSummaryIPVersionParamsQueryTypeUnspec DNSSummaryIPVersionParamsQueryType = "UNSPEC"` - `const DNSSummaryIPVersionParamsQueryTypeURI DNSSummaryIPVersionParamsQueryType = "URI"` - `const DNSSummaryIPVersionParamsQueryTypeWks DNSSummaryIPVersionParamsQueryType = "WKS"` - `const DNSSummaryIPVersionParamsQueryTypeX25 DNSSummaryIPVersionParamsQueryType = "X25"` - `const DNSSummaryIPVersionParamsQueryTypeZonemd DNSSummaryIPVersionParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryIPVersionParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryIPVersionParamsResponseCodeNoerror DNSSummaryIPVersionParamsResponseCode = "NOERROR"` - `const DNSSummaryIPVersionParamsResponseCodeFormerr DNSSummaryIPVersionParamsResponseCode = "FORMERR"` - `const DNSSummaryIPVersionParamsResponseCodeServfail DNSSummaryIPVersionParamsResponseCode = "SERVFAIL"` - `const DNSSummaryIPVersionParamsResponseCodeNxdomain DNSSummaryIPVersionParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryIPVersionParamsResponseCodeNotimp DNSSummaryIPVersionParamsResponseCode = "NOTIMP"` - `const DNSSummaryIPVersionParamsResponseCodeRefused DNSSummaryIPVersionParamsResponseCode = "REFUSED"` - `const DNSSummaryIPVersionParamsResponseCodeYxdomain DNSSummaryIPVersionParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryIPVersionParamsResponseCodeYxrrset DNSSummaryIPVersionParamsResponseCode = "YXRRSET"` - `const DNSSummaryIPVersionParamsResponseCodeNxrrset DNSSummaryIPVersionParamsResponseCode = "NXRRSET"` - `const DNSSummaryIPVersionParamsResponseCodeNotauth DNSSummaryIPVersionParamsResponseCode = "NOTAUTH"` - `const DNSSummaryIPVersionParamsResponseCodeNotzone DNSSummaryIPVersionParamsResponseCode = "NOTZONE"` - `const DNSSummaryIPVersionParamsResponseCodeBadsig DNSSummaryIPVersionParamsResponseCode = "BADSIG"` - `const DNSSummaryIPVersionParamsResponseCodeBadkey DNSSummaryIPVersionParamsResponseCode = "BADKEY"` - `const DNSSummaryIPVersionParamsResponseCodeBadtime DNSSummaryIPVersionParamsResponseCode = "BADTIME"` - `const DNSSummaryIPVersionParamsResponseCodeBadmode DNSSummaryIPVersionParamsResponseCode = "BADMODE"` - `const DNSSummaryIPVersionParamsResponseCodeBadname DNSSummaryIPVersionParamsResponseCode = "BADNAME"` - `const DNSSummaryIPVersionParamsResponseCodeBadalg DNSSummaryIPVersionParamsResponseCode = "BADALG"` - `const DNSSummaryIPVersionParamsResponseCodeBadtrunc DNSSummaryIPVersionParamsResponseCode = "BADTRUNC"` - `const DNSSummaryIPVersionParamsResponseCodeBadcookie DNSSummaryIPVersionParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryIPVersionResponse struct{…}` - `Meta DNSSummaryIPVersionResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryIPVersionResponseMetaConfidenceInfo` - `Annotations []DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryIPVersionResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryIPVersionResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryIPVersionResponseMetaNormalizationPercentage DNSSummaryIPVersionResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryIPVersionResponseMetaNormalizationMin0Max DNSSummaryIPVersionResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryIPVersionResponseMetaNormalizationMinMax DNSSummaryIPVersionResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryIPVersionResponseMetaNormalizationRawValues DNSSummaryIPVersionResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryIPVersionResponseMetaNormalizationPercentageChange DNSSummaryIPVersionResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryIPVersionResponseMetaNormalizationRollingAverage DNSSummaryIPVersionResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryIPVersionResponseMetaNormalizationOverlappedPercentage DNSSummaryIPVersionResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryIPVersionResponseMetaNormalizationRatio DNSSummaryIPVersionResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryIPVersionResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryIPVersionResponseSummary0` - `IPv4 string` A numeric string. - `IPv6 string` A numeric string. ### Example ```go 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.Summary.IPVersion(context.TODO(), radar.DNSSummaryIPVersionParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "IPv4": "10", "IPv6": "10" } }, "success": true } ``` ## Get DNS queries by matching answer summary `client.Radar.DNS.Summary.MatchingAnswer(ctx, query) (*DNSSummaryMatchingAnswerResponse, error)` **get** `/radar/dns/summary/matching_answer` Retrieves the distribution of DNS queries by matching answers. ### Parameters - `query DNSSummaryMatchingAnswerParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryMatchingAnswerParamsFormat]` Format in which results will be returned. - `const DNSSummaryMatchingAnswerParamsFormatJson DNSSummaryMatchingAnswerParamsFormat = "JSON"` - `const DNSSummaryMatchingAnswerParamsFormatCsv DNSSummaryMatchingAnswerParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryMatchingAnswerParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryMatchingAnswerParamsProtocolUdp DNSSummaryMatchingAnswerParamsProtocol = "UDP"` - `const DNSSummaryMatchingAnswerParamsProtocolTCP DNSSummaryMatchingAnswerParamsProtocol = "TCP"` - `const DNSSummaryMatchingAnswerParamsProtocolHTTPS DNSSummaryMatchingAnswerParamsProtocol = "HTTPS"` - `const DNSSummaryMatchingAnswerParamsProtocolTLS DNSSummaryMatchingAnswerParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryMatchingAnswerParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryMatchingAnswerParamsQueryTypeA DNSSummaryMatchingAnswerParamsQueryType = "A"` - `const DNSSummaryMatchingAnswerParamsQueryTypeAAAA DNSSummaryMatchingAnswerParamsQueryType = "AAAA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeA6 DNSSummaryMatchingAnswerParamsQueryType = "A6"` - `const DNSSummaryMatchingAnswerParamsQueryTypeAfsdb DNSSummaryMatchingAnswerParamsQueryType = "AFSDB"` - `const DNSSummaryMatchingAnswerParamsQueryTypeAny DNSSummaryMatchingAnswerParamsQueryType = "ANY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeApl DNSSummaryMatchingAnswerParamsQueryType = "APL"` - `const DNSSummaryMatchingAnswerParamsQueryTypeAtma DNSSummaryMatchingAnswerParamsQueryType = "ATMA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeAXFR DNSSummaryMatchingAnswerParamsQueryType = "AXFR"` - `const DNSSummaryMatchingAnswerParamsQueryTypeCAA DNSSummaryMatchingAnswerParamsQueryType = "CAA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeCdnskey DNSSummaryMatchingAnswerParamsQueryType = "CDNSKEY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeCds DNSSummaryMatchingAnswerParamsQueryType = "CDS"` - `const DNSSummaryMatchingAnswerParamsQueryTypeCERT DNSSummaryMatchingAnswerParamsQueryType = "CERT"` - `const DNSSummaryMatchingAnswerParamsQueryTypeCNAME DNSSummaryMatchingAnswerParamsQueryType = "CNAME"` - `const DNSSummaryMatchingAnswerParamsQueryTypeCsync DNSSummaryMatchingAnswerParamsQueryType = "CSYNC"` - `const DNSSummaryMatchingAnswerParamsQueryTypeDhcid DNSSummaryMatchingAnswerParamsQueryType = "DHCID"` - `const DNSSummaryMatchingAnswerParamsQueryTypeDlv DNSSummaryMatchingAnswerParamsQueryType = "DLV"` - `const DNSSummaryMatchingAnswerParamsQueryTypeDname DNSSummaryMatchingAnswerParamsQueryType = "DNAME"` - `const DNSSummaryMatchingAnswerParamsQueryTypeDNSKEY DNSSummaryMatchingAnswerParamsQueryType = "DNSKEY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeDoa DNSSummaryMatchingAnswerParamsQueryType = "DOA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeDS DNSSummaryMatchingAnswerParamsQueryType = "DS"` - `const DNSSummaryMatchingAnswerParamsQueryTypeEid DNSSummaryMatchingAnswerParamsQueryType = "EID"` - `const DNSSummaryMatchingAnswerParamsQueryTypeEui48 DNSSummaryMatchingAnswerParamsQueryType = "EUI48"` - `const DNSSummaryMatchingAnswerParamsQueryTypeEui64 DNSSummaryMatchingAnswerParamsQueryType = "EUI64"` - `const DNSSummaryMatchingAnswerParamsQueryTypeGpos DNSSummaryMatchingAnswerParamsQueryType = "GPOS"` - `const DNSSummaryMatchingAnswerParamsQueryTypeGid DNSSummaryMatchingAnswerParamsQueryType = "GID"` - `const DNSSummaryMatchingAnswerParamsQueryTypeHinfo DNSSummaryMatchingAnswerParamsQueryType = "HINFO"` - `const DNSSummaryMatchingAnswerParamsQueryTypeHip DNSSummaryMatchingAnswerParamsQueryType = "HIP"` - `const DNSSummaryMatchingAnswerParamsQueryTypeHTTPS DNSSummaryMatchingAnswerParamsQueryType = "HTTPS"` - `const DNSSummaryMatchingAnswerParamsQueryTypeIpseckey DNSSummaryMatchingAnswerParamsQueryType = "IPSECKEY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeIsdn DNSSummaryMatchingAnswerParamsQueryType = "ISDN"` - `const DNSSummaryMatchingAnswerParamsQueryTypeIxfr DNSSummaryMatchingAnswerParamsQueryType = "IXFR"` - `const DNSSummaryMatchingAnswerParamsQueryTypeKey DNSSummaryMatchingAnswerParamsQueryType = "KEY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeKx DNSSummaryMatchingAnswerParamsQueryType = "KX"` - `const DNSSummaryMatchingAnswerParamsQueryTypeL32 DNSSummaryMatchingAnswerParamsQueryType = "L32"` - `const DNSSummaryMatchingAnswerParamsQueryTypeL64 DNSSummaryMatchingAnswerParamsQueryType = "L64"` - `const DNSSummaryMatchingAnswerParamsQueryTypeLOC DNSSummaryMatchingAnswerParamsQueryType = "LOC"` - `const DNSSummaryMatchingAnswerParamsQueryTypeLp DNSSummaryMatchingAnswerParamsQueryType = "LP"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMaila DNSSummaryMatchingAnswerParamsQueryType = "MAILA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMailb DNSSummaryMatchingAnswerParamsQueryType = "MAILB"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMB DNSSummaryMatchingAnswerParamsQueryType = "MB"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMd DNSSummaryMatchingAnswerParamsQueryType = "MD"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMf DNSSummaryMatchingAnswerParamsQueryType = "MF"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMg DNSSummaryMatchingAnswerParamsQueryType = "MG"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMinfo DNSSummaryMatchingAnswerParamsQueryType = "MINFO"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMr DNSSummaryMatchingAnswerParamsQueryType = "MR"` - `const DNSSummaryMatchingAnswerParamsQueryTypeMX DNSSummaryMatchingAnswerParamsQueryType = "MX"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNAPTR DNSSummaryMatchingAnswerParamsQueryType = "NAPTR"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNb DNSSummaryMatchingAnswerParamsQueryType = "NB"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNbstat DNSSummaryMatchingAnswerParamsQueryType = "NBSTAT"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNid DNSSummaryMatchingAnswerParamsQueryType = "NID"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNimloc DNSSummaryMatchingAnswerParamsQueryType = "NIMLOC"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNinfo DNSSummaryMatchingAnswerParamsQueryType = "NINFO"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNS DNSSummaryMatchingAnswerParamsQueryType = "NS"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNsap DNSSummaryMatchingAnswerParamsQueryType = "NSAP"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNsec DNSSummaryMatchingAnswerParamsQueryType = "NSEC"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNsec3 DNSSummaryMatchingAnswerParamsQueryType = "NSEC3"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNsec3Param DNSSummaryMatchingAnswerParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNull DNSSummaryMatchingAnswerParamsQueryType = "NULL"` - `const DNSSummaryMatchingAnswerParamsQueryTypeNxt DNSSummaryMatchingAnswerParamsQueryType = "NXT"` - `const DNSSummaryMatchingAnswerParamsQueryTypeOpenpgpkey DNSSummaryMatchingAnswerParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeOpt DNSSummaryMatchingAnswerParamsQueryType = "OPT"` - `const DNSSummaryMatchingAnswerParamsQueryTypePTR DNSSummaryMatchingAnswerParamsQueryType = "PTR"` - `const DNSSummaryMatchingAnswerParamsQueryTypePx DNSSummaryMatchingAnswerParamsQueryType = "PX"` - `const DNSSummaryMatchingAnswerParamsQueryTypeRkey DNSSummaryMatchingAnswerParamsQueryType = "RKEY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeRp DNSSummaryMatchingAnswerParamsQueryType = "RP"` - `const DNSSummaryMatchingAnswerParamsQueryTypeRrsig DNSSummaryMatchingAnswerParamsQueryType = "RRSIG"` - `const DNSSummaryMatchingAnswerParamsQueryTypeRt DNSSummaryMatchingAnswerParamsQueryType = "RT"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSig DNSSummaryMatchingAnswerParamsQueryType = "SIG"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSink DNSSummaryMatchingAnswerParamsQueryType = "SINK"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSMIMEA DNSSummaryMatchingAnswerParamsQueryType = "SMIMEA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSOA DNSSummaryMatchingAnswerParamsQueryType = "SOA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSPF DNSSummaryMatchingAnswerParamsQueryType = "SPF"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSRV DNSSummaryMatchingAnswerParamsQueryType = "SRV"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSSHFP DNSSummaryMatchingAnswerParamsQueryType = "SSHFP"` - `const DNSSummaryMatchingAnswerParamsQueryTypeSVCB DNSSummaryMatchingAnswerParamsQueryType = "SVCB"` - `const DNSSummaryMatchingAnswerParamsQueryTypeTa DNSSummaryMatchingAnswerParamsQueryType = "TA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeTalink DNSSummaryMatchingAnswerParamsQueryType = "TALINK"` - `const DNSSummaryMatchingAnswerParamsQueryTypeTkey DNSSummaryMatchingAnswerParamsQueryType = "TKEY"` - `const DNSSummaryMatchingAnswerParamsQueryTypeTLSA DNSSummaryMatchingAnswerParamsQueryType = "TLSA"` - `const DNSSummaryMatchingAnswerParamsQueryTypeTSIG DNSSummaryMatchingAnswerParamsQueryType = "TSIG"` - `const DNSSummaryMatchingAnswerParamsQueryTypeTXT DNSSummaryMatchingAnswerParamsQueryType = "TXT"` - `const DNSSummaryMatchingAnswerParamsQueryTypeUinfo DNSSummaryMatchingAnswerParamsQueryType = "UINFO"` - `const DNSSummaryMatchingAnswerParamsQueryTypeUID DNSSummaryMatchingAnswerParamsQueryType = "UID"` - `const DNSSummaryMatchingAnswerParamsQueryTypeUnspec DNSSummaryMatchingAnswerParamsQueryType = "UNSPEC"` - `const DNSSummaryMatchingAnswerParamsQueryTypeURI DNSSummaryMatchingAnswerParamsQueryType = "URI"` - `const DNSSummaryMatchingAnswerParamsQueryTypeWks DNSSummaryMatchingAnswerParamsQueryType = "WKS"` - `const DNSSummaryMatchingAnswerParamsQueryTypeX25 DNSSummaryMatchingAnswerParamsQueryType = "X25"` - `const DNSSummaryMatchingAnswerParamsQueryTypeZonemd DNSSummaryMatchingAnswerParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryMatchingAnswerParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryMatchingAnswerParamsResponseCodeNoerror DNSSummaryMatchingAnswerParamsResponseCode = "NOERROR"` - `const DNSSummaryMatchingAnswerParamsResponseCodeFormerr DNSSummaryMatchingAnswerParamsResponseCode = "FORMERR"` - `const DNSSummaryMatchingAnswerParamsResponseCodeServfail DNSSummaryMatchingAnswerParamsResponseCode = "SERVFAIL"` - `const DNSSummaryMatchingAnswerParamsResponseCodeNxdomain DNSSummaryMatchingAnswerParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryMatchingAnswerParamsResponseCodeNotimp DNSSummaryMatchingAnswerParamsResponseCode = "NOTIMP"` - `const DNSSummaryMatchingAnswerParamsResponseCodeRefused DNSSummaryMatchingAnswerParamsResponseCode = "REFUSED"` - `const DNSSummaryMatchingAnswerParamsResponseCodeYxdomain DNSSummaryMatchingAnswerParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryMatchingAnswerParamsResponseCodeYxrrset DNSSummaryMatchingAnswerParamsResponseCode = "YXRRSET"` - `const DNSSummaryMatchingAnswerParamsResponseCodeNxrrset DNSSummaryMatchingAnswerParamsResponseCode = "NXRRSET"` - `const DNSSummaryMatchingAnswerParamsResponseCodeNotauth DNSSummaryMatchingAnswerParamsResponseCode = "NOTAUTH"` - `const DNSSummaryMatchingAnswerParamsResponseCodeNotzone DNSSummaryMatchingAnswerParamsResponseCode = "NOTZONE"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadsig DNSSummaryMatchingAnswerParamsResponseCode = "BADSIG"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadkey DNSSummaryMatchingAnswerParamsResponseCode = "BADKEY"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadtime DNSSummaryMatchingAnswerParamsResponseCode = "BADTIME"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadmode DNSSummaryMatchingAnswerParamsResponseCode = "BADMODE"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadname DNSSummaryMatchingAnswerParamsResponseCode = "BADNAME"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadalg DNSSummaryMatchingAnswerParamsResponseCode = "BADALG"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadtrunc DNSSummaryMatchingAnswerParamsResponseCode = "BADTRUNC"` - `const DNSSummaryMatchingAnswerParamsResponseCodeBadcookie DNSSummaryMatchingAnswerParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryMatchingAnswerResponse struct{…}` - `Meta DNSSummaryMatchingAnswerResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryMatchingAnswerResponseMetaConfidenceInfo` - `Annotations []DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryMatchingAnswerResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryMatchingAnswerResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryMatchingAnswerResponseMetaNormalizationPercentage DNSSummaryMatchingAnswerResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryMatchingAnswerResponseMetaNormalizationMin0Max DNSSummaryMatchingAnswerResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryMatchingAnswerResponseMetaNormalizationMinMax DNSSummaryMatchingAnswerResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryMatchingAnswerResponseMetaNormalizationRawValues DNSSummaryMatchingAnswerResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryMatchingAnswerResponseMetaNormalizationPercentageChange DNSSummaryMatchingAnswerResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryMatchingAnswerResponseMetaNormalizationRollingAverage DNSSummaryMatchingAnswerResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryMatchingAnswerResponseMetaNormalizationOverlappedPercentage DNSSummaryMatchingAnswerResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryMatchingAnswerResponseMetaNormalizationRatio DNSSummaryMatchingAnswerResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryMatchingAnswerResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryMatchingAnswerResponseSummary0` - `Negative string` A numeric string. - `Positive string` A numeric string. ### Example ```go 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.Summary.MatchingAnswer(context.TODO(), radar.DNSSummaryMatchingAnswerParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "NEGATIVE": "10", "POSITIVE": "10" } }, "success": true } ``` ## Get DNS queries by protocol summary `client.Radar.DNS.Summary.Protocol(ctx, query) (*DNSSummaryProtocolResponse, error)` **get** `/radar/dns/summary/protocol` Retrieves the distribution of DNS queries by DNS transport protocol. ### Parameters - `query DNSSummaryProtocolParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryProtocolParamsFormat]` Format in which results will be returned. - `const DNSSummaryProtocolParamsFormatJson DNSSummaryProtocolParamsFormat = "JSON"` - `const DNSSummaryProtocolParamsFormatCsv DNSSummaryProtocolParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `QueryType param.Field[[]DNSSummaryProtocolParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryProtocolParamsQueryTypeA DNSSummaryProtocolParamsQueryType = "A"` - `const DNSSummaryProtocolParamsQueryTypeAAAA DNSSummaryProtocolParamsQueryType = "AAAA"` - `const DNSSummaryProtocolParamsQueryTypeA6 DNSSummaryProtocolParamsQueryType = "A6"` - `const DNSSummaryProtocolParamsQueryTypeAfsdb DNSSummaryProtocolParamsQueryType = "AFSDB"` - `const DNSSummaryProtocolParamsQueryTypeAny DNSSummaryProtocolParamsQueryType = "ANY"` - `const DNSSummaryProtocolParamsQueryTypeApl DNSSummaryProtocolParamsQueryType = "APL"` - `const DNSSummaryProtocolParamsQueryTypeAtma DNSSummaryProtocolParamsQueryType = "ATMA"` - `const DNSSummaryProtocolParamsQueryTypeAXFR DNSSummaryProtocolParamsQueryType = "AXFR"` - `const DNSSummaryProtocolParamsQueryTypeCAA DNSSummaryProtocolParamsQueryType = "CAA"` - `const DNSSummaryProtocolParamsQueryTypeCdnskey DNSSummaryProtocolParamsQueryType = "CDNSKEY"` - `const DNSSummaryProtocolParamsQueryTypeCds DNSSummaryProtocolParamsQueryType = "CDS"` - `const DNSSummaryProtocolParamsQueryTypeCERT DNSSummaryProtocolParamsQueryType = "CERT"` - `const DNSSummaryProtocolParamsQueryTypeCNAME DNSSummaryProtocolParamsQueryType = "CNAME"` - `const DNSSummaryProtocolParamsQueryTypeCsync DNSSummaryProtocolParamsQueryType = "CSYNC"` - `const DNSSummaryProtocolParamsQueryTypeDhcid DNSSummaryProtocolParamsQueryType = "DHCID"` - `const DNSSummaryProtocolParamsQueryTypeDlv DNSSummaryProtocolParamsQueryType = "DLV"` - `const DNSSummaryProtocolParamsQueryTypeDname DNSSummaryProtocolParamsQueryType = "DNAME"` - `const DNSSummaryProtocolParamsQueryTypeDNSKEY DNSSummaryProtocolParamsQueryType = "DNSKEY"` - `const DNSSummaryProtocolParamsQueryTypeDoa DNSSummaryProtocolParamsQueryType = "DOA"` - `const DNSSummaryProtocolParamsQueryTypeDS DNSSummaryProtocolParamsQueryType = "DS"` - `const DNSSummaryProtocolParamsQueryTypeEid DNSSummaryProtocolParamsQueryType = "EID"` - `const DNSSummaryProtocolParamsQueryTypeEui48 DNSSummaryProtocolParamsQueryType = "EUI48"` - `const DNSSummaryProtocolParamsQueryTypeEui64 DNSSummaryProtocolParamsQueryType = "EUI64"` - `const DNSSummaryProtocolParamsQueryTypeGpos DNSSummaryProtocolParamsQueryType = "GPOS"` - `const DNSSummaryProtocolParamsQueryTypeGid DNSSummaryProtocolParamsQueryType = "GID"` - `const DNSSummaryProtocolParamsQueryTypeHinfo DNSSummaryProtocolParamsQueryType = "HINFO"` - `const DNSSummaryProtocolParamsQueryTypeHip DNSSummaryProtocolParamsQueryType = "HIP"` - `const DNSSummaryProtocolParamsQueryTypeHTTPS DNSSummaryProtocolParamsQueryType = "HTTPS"` - `const DNSSummaryProtocolParamsQueryTypeIpseckey DNSSummaryProtocolParamsQueryType = "IPSECKEY"` - `const DNSSummaryProtocolParamsQueryTypeIsdn DNSSummaryProtocolParamsQueryType = "ISDN"` - `const DNSSummaryProtocolParamsQueryTypeIxfr DNSSummaryProtocolParamsQueryType = "IXFR"` - `const DNSSummaryProtocolParamsQueryTypeKey DNSSummaryProtocolParamsQueryType = "KEY"` - `const DNSSummaryProtocolParamsQueryTypeKx DNSSummaryProtocolParamsQueryType = "KX"` - `const DNSSummaryProtocolParamsQueryTypeL32 DNSSummaryProtocolParamsQueryType = "L32"` - `const DNSSummaryProtocolParamsQueryTypeL64 DNSSummaryProtocolParamsQueryType = "L64"` - `const DNSSummaryProtocolParamsQueryTypeLOC DNSSummaryProtocolParamsQueryType = "LOC"` - `const DNSSummaryProtocolParamsQueryTypeLp DNSSummaryProtocolParamsQueryType = "LP"` - `const DNSSummaryProtocolParamsQueryTypeMaila DNSSummaryProtocolParamsQueryType = "MAILA"` - `const DNSSummaryProtocolParamsQueryTypeMailb DNSSummaryProtocolParamsQueryType = "MAILB"` - `const DNSSummaryProtocolParamsQueryTypeMB DNSSummaryProtocolParamsQueryType = "MB"` - `const DNSSummaryProtocolParamsQueryTypeMd DNSSummaryProtocolParamsQueryType = "MD"` - `const DNSSummaryProtocolParamsQueryTypeMf DNSSummaryProtocolParamsQueryType = "MF"` - `const DNSSummaryProtocolParamsQueryTypeMg DNSSummaryProtocolParamsQueryType = "MG"` - `const DNSSummaryProtocolParamsQueryTypeMinfo DNSSummaryProtocolParamsQueryType = "MINFO"` - `const DNSSummaryProtocolParamsQueryTypeMr DNSSummaryProtocolParamsQueryType = "MR"` - `const DNSSummaryProtocolParamsQueryTypeMX DNSSummaryProtocolParamsQueryType = "MX"` - `const DNSSummaryProtocolParamsQueryTypeNAPTR DNSSummaryProtocolParamsQueryType = "NAPTR"` - `const DNSSummaryProtocolParamsQueryTypeNb DNSSummaryProtocolParamsQueryType = "NB"` - `const DNSSummaryProtocolParamsQueryTypeNbstat DNSSummaryProtocolParamsQueryType = "NBSTAT"` - `const DNSSummaryProtocolParamsQueryTypeNid DNSSummaryProtocolParamsQueryType = "NID"` - `const DNSSummaryProtocolParamsQueryTypeNimloc DNSSummaryProtocolParamsQueryType = "NIMLOC"` - `const DNSSummaryProtocolParamsQueryTypeNinfo DNSSummaryProtocolParamsQueryType = "NINFO"` - `const DNSSummaryProtocolParamsQueryTypeNS DNSSummaryProtocolParamsQueryType = "NS"` - `const DNSSummaryProtocolParamsQueryTypeNsap DNSSummaryProtocolParamsQueryType = "NSAP"` - `const DNSSummaryProtocolParamsQueryTypeNsec DNSSummaryProtocolParamsQueryType = "NSEC"` - `const DNSSummaryProtocolParamsQueryTypeNsec3 DNSSummaryProtocolParamsQueryType = "NSEC3"` - `const DNSSummaryProtocolParamsQueryTypeNsec3Param DNSSummaryProtocolParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryProtocolParamsQueryTypeNull DNSSummaryProtocolParamsQueryType = "NULL"` - `const DNSSummaryProtocolParamsQueryTypeNxt DNSSummaryProtocolParamsQueryType = "NXT"` - `const DNSSummaryProtocolParamsQueryTypeOpenpgpkey DNSSummaryProtocolParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryProtocolParamsQueryTypeOpt DNSSummaryProtocolParamsQueryType = "OPT"` - `const DNSSummaryProtocolParamsQueryTypePTR DNSSummaryProtocolParamsQueryType = "PTR"` - `const DNSSummaryProtocolParamsQueryTypePx DNSSummaryProtocolParamsQueryType = "PX"` - `const DNSSummaryProtocolParamsQueryTypeRkey DNSSummaryProtocolParamsQueryType = "RKEY"` - `const DNSSummaryProtocolParamsQueryTypeRp DNSSummaryProtocolParamsQueryType = "RP"` - `const DNSSummaryProtocolParamsQueryTypeRrsig DNSSummaryProtocolParamsQueryType = "RRSIG"` - `const DNSSummaryProtocolParamsQueryTypeRt DNSSummaryProtocolParamsQueryType = "RT"` - `const DNSSummaryProtocolParamsQueryTypeSig DNSSummaryProtocolParamsQueryType = "SIG"` - `const DNSSummaryProtocolParamsQueryTypeSink DNSSummaryProtocolParamsQueryType = "SINK"` - `const DNSSummaryProtocolParamsQueryTypeSMIMEA DNSSummaryProtocolParamsQueryType = "SMIMEA"` - `const DNSSummaryProtocolParamsQueryTypeSOA DNSSummaryProtocolParamsQueryType = "SOA"` - `const DNSSummaryProtocolParamsQueryTypeSPF DNSSummaryProtocolParamsQueryType = "SPF"` - `const DNSSummaryProtocolParamsQueryTypeSRV DNSSummaryProtocolParamsQueryType = "SRV"` - `const DNSSummaryProtocolParamsQueryTypeSSHFP DNSSummaryProtocolParamsQueryType = "SSHFP"` - `const DNSSummaryProtocolParamsQueryTypeSVCB DNSSummaryProtocolParamsQueryType = "SVCB"` - `const DNSSummaryProtocolParamsQueryTypeTa DNSSummaryProtocolParamsQueryType = "TA"` - `const DNSSummaryProtocolParamsQueryTypeTalink DNSSummaryProtocolParamsQueryType = "TALINK"` - `const DNSSummaryProtocolParamsQueryTypeTkey DNSSummaryProtocolParamsQueryType = "TKEY"` - `const DNSSummaryProtocolParamsQueryTypeTLSA DNSSummaryProtocolParamsQueryType = "TLSA"` - `const DNSSummaryProtocolParamsQueryTypeTSIG DNSSummaryProtocolParamsQueryType = "TSIG"` - `const DNSSummaryProtocolParamsQueryTypeTXT DNSSummaryProtocolParamsQueryType = "TXT"` - `const DNSSummaryProtocolParamsQueryTypeUinfo DNSSummaryProtocolParamsQueryType = "UINFO"` - `const DNSSummaryProtocolParamsQueryTypeUID DNSSummaryProtocolParamsQueryType = "UID"` - `const DNSSummaryProtocolParamsQueryTypeUnspec DNSSummaryProtocolParamsQueryType = "UNSPEC"` - `const DNSSummaryProtocolParamsQueryTypeURI DNSSummaryProtocolParamsQueryType = "URI"` - `const DNSSummaryProtocolParamsQueryTypeWks DNSSummaryProtocolParamsQueryType = "WKS"` - `const DNSSummaryProtocolParamsQueryTypeX25 DNSSummaryProtocolParamsQueryType = "X25"` - `const DNSSummaryProtocolParamsQueryTypeZonemd DNSSummaryProtocolParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryProtocolParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryProtocolParamsResponseCodeNoerror DNSSummaryProtocolParamsResponseCode = "NOERROR"` - `const DNSSummaryProtocolParamsResponseCodeFormerr DNSSummaryProtocolParamsResponseCode = "FORMERR"` - `const DNSSummaryProtocolParamsResponseCodeServfail DNSSummaryProtocolParamsResponseCode = "SERVFAIL"` - `const DNSSummaryProtocolParamsResponseCodeNxdomain DNSSummaryProtocolParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryProtocolParamsResponseCodeNotimp DNSSummaryProtocolParamsResponseCode = "NOTIMP"` - `const DNSSummaryProtocolParamsResponseCodeRefused DNSSummaryProtocolParamsResponseCode = "REFUSED"` - `const DNSSummaryProtocolParamsResponseCodeYxdomain DNSSummaryProtocolParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryProtocolParamsResponseCodeYxrrset DNSSummaryProtocolParamsResponseCode = "YXRRSET"` - `const DNSSummaryProtocolParamsResponseCodeNxrrset DNSSummaryProtocolParamsResponseCode = "NXRRSET"` - `const DNSSummaryProtocolParamsResponseCodeNotauth DNSSummaryProtocolParamsResponseCode = "NOTAUTH"` - `const DNSSummaryProtocolParamsResponseCodeNotzone DNSSummaryProtocolParamsResponseCode = "NOTZONE"` - `const DNSSummaryProtocolParamsResponseCodeBadsig DNSSummaryProtocolParamsResponseCode = "BADSIG"` - `const DNSSummaryProtocolParamsResponseCodeBadkey DNSSummaryProtocolParamsResponseCode = "BADKEY"` - `const DNSSummaryProtocolParamsResponseCodeBadtime DNSSummaryProtocolParamsResponseCode = "BADTIME"` - `const DNSSummaryProtocolParamsResponseCodeBadmode DNSSummaryProtocolParamsResponseCode = "BADMODE"` - `const DNSSummaryProtocolParamsResponseCodeBadname DNSSummaryProtocolParamsResponseCode = "BADNAME"` - `const DNSSummaryProtocolParamsResponseCodeBadalg DNSSummaryProtocolParamsResponseCode = "BADALG"` - `const DNSSummaryProtocolParamsResponseCodeBadtrunc DNSSummaryProtocolParamsResponseCode = "BADTRUNC"` - `const DNSSummaryProtocolParamsResponseCodeBadcookie DNSSummaryProtocolParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryProtocolResponse struct{…}` - `Meta DNSSummaryProtocolResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryProtocolResponseMetaConfidenceInfo` - `Annotations []DNSSummaryProtocolResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryProtocolResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryProtocolResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryProtocolResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryProtocolResponseMetaNormalizationPercentage DNSSummaryProtocolResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryProtocolResponseMetaNormalizationMin0Max DNSSummaryProtocolResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryProtocolResponseMetaNormalizationMinMax DNSSummaryProtocolResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryProtocolResponseMetaNormalizationRawValues DNSSummaryProtocolResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryProtocolResponseMetaNormalizationPercentageChange DNSSummaryProtocolResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryProtocolResponseMetaNormalizationRollingAverage DNSSummaryProtocolResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryProtocolResponseMetaNormalizationOverlappedPercentage DNSSummaryProtocolResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryProtocolResponseMetaNormalizationRatio DNSSummaryProtocolResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryProtocolResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryProtocolResponseSummary0` - `HTTPS string` A numeric string. - `TCP string` A numeric string. - `TLS string` A numeric string. - `Udp string` A numeric string. ### Example ```go 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.Summary.Protocol(context.TODO(), radar.DNSSummaryProtocolParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "HTTPS": "10", "TCP": "10", "TLS": "10", "UDP": "10" } }, "success": true } ``` ## Get DNS queries by type summary `client.Radar.DNS.Summary.QueryType(ctx, query) (*DNSSummaryQueryTypeResponse, error)` **get** `/radar/dns/summary/query_type` Retrieves the distribution of DNS queries by type. ### Parameters - `query DNSSummaryQueryTypeParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryQueryTypeParamsFormat]` Format in which results will be returned. - `const DNSSummaryQueryTypeParamsFormatJson DNSSummaryQueryTypeParamsFormat = "JSON"` - `const DNSSummaryQueryTypeParamsFormatCsv DNSSummaryQueryTypeParamsFormat = "CSV"` - `LimitPerGroup param.Field[int64]` Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category. Only supported on high-cardinality dimensions; otherwise the request is rejected. Minimum value is 2. - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryQueryTypeParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryQueryTypeParamsProtocolUdp DNSSummaryQueryTypeParamsProtocol = "UDP"` - `const DNSSummaryQueryTypeParamsProtocolTCP DNSSummaryQueryTypeParamsProtocol = "TCP"` - `const DNSSummaryQueryTypeParamsProtocolHTTPS DNSSummaryQueryTypeParamsProtocol = "HTTPS"` - `const DNSSummaryQueryTypeParamsProtocolTLS DNSSummaryQueryTypeParamsProtocol = "TLS"` - `ResponseCode param.Field[[]DNSSummaryQueryTypeParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryQueryTypeParamsResponseCodeNoerror DNSSummaryQueryTypeParamsResponseCode = "NOERROR"` - `const DNSSummaryQueryTypeParamsResponseCodeFormerr DNSSummaryQueryTypeParamsResponseCode = "FORMERR"` - `const DNSSummaryQueryTypeParamsResponseCodeServfail DNSSummaryQueryTypeParamsResponseCode = "SERVFAIL"` - `const DNSSummaryQueryTypeParamsResponseCodeNxdomain DNSSummaryQueryTypeParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryQueryTypeParamsResponseCodeNotimp DNSSummaryQueryTypeParamsResponseCode = "NOTIMP"` - `const DNSSummaryQueryTypeParamsResponseCodeRefused DNSSummaryQueryTypeParamsResponseCode = "REFUSED"` - `const DNSSummaryQueryTypeParamsResponseCodeYxdomain DNSSummaryQueryTypeParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryQueryTypeParamsResponseCodeYxrrset DNSSummaryQueryTypeParamsResponseCode = "YXRRSET"` - `const DNSSummaryQueryTypeParamsResponseCodeNxrrset DNSSummaryQueryTypeParamsResponseCode = "NXRRSET"` - `const DNSSummaryQueryTypeParamsResponseCodeNotauth DNSSummaryQueryTypeParamsResponseCode = "NOTAUTH"` - `const DNSSummaryQueryTypeParamsResponseCodeNotzone DNSSummaryQueryTypeParamsResponseCode = "NOTZONE"` - `const DNSSummaryQueryTypeParamsResponseCodeBadsig DNSSummaryQueryTypeParamsResponseCode = "BADSIG"` - `const DNSSummaryQueryTypeParamsResponseCodeBadkey DNSSummaryQueryTypeParamsResponseCode = "BADKEY"` - `const DNSSummaryQueryTypeParamsResponseCodeBadtime DNSSummaryQueryTypeParamsResponseCode = "BADTIME"` - `const DNSSummaryQueryTypeParamsResponseCodeBadmode DNSSummaryQueryTypeParamsResponseCode = "BADMODE"` - `const DNSSummaryQueryTypeParamsResponseCodeBadname DNSSummaryQueryTypeParamsResponseCode = "BADNAME"` - `const DNSSummaryQueryTypeParamsResponseCodeBadalg DNSSummaryQueryTypeParamsResponseCode = "BADALG"` - `const DNSSummaryQueryTypeParamsResponseCodeBadtrunc DNSSummaryQueryTypeParamsResponseCode = "BADTRUNC"` - `const DNSSummaryQueryTypeParamsResponseCodeBadcookie DNSSummaryQueryTypeParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryQueryTypeResponse struct{…}` - `Meta DNSSummaryQueryTypeResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryQueryTypeResponseMetaConfidenceInfo` - `Annotations []DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryQueryTypeResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryQueryTypeResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryQueryTypeResponseMetaNormalizationPercentage DNSSummaryQueryTypeResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryQueryTypeResponseMetaNormalizationMin0Max DNSSummaryQueryTypeResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryQueryTypeResponseMetaNormalizationMinMax DNSSummaryQueryTypeResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryQueryTypeResponseMetaNormalizationRawValues DNSSummaryQueryTypeResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryQueryTypeResponseMetaNormalizationPercentageChange DNSSummaryQueryTypeResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryQueryTypeResponseMetaNormalizationRollingAverage DNSSummaryQueryTypeResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryQueryTypeResponseMetaNormalizationOverlappedPercentage DNSSummaryQueryTypeResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryQueryTypeResponseMetaNormalizationRatio DNSSummaryQueryTypeResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryQueryTypeResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 map[string, string]` ### Example ```go 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.Summary.QueryType(context.TODO(), radar.DNSSummaryQueryTypeParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "A": "20", "AAAA": "20", "HTTPS": "20", "NS": "20", "PTR": "20" } }, "success": true } ``` ## Get DNS queries by response code summary `client.Radar.DNS.Summary.ResponseCode(ctx, query) (*DNSSummaryResponseCodeResponse, error)` **get** `/radar/dns/summary/response_code` Retrieves the distribution of DNS queries by response code. ### Parameters - `query DNSSummaryResponseCodeParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryResponseCodeParamsFormat]` Format in which results will be returned. - `const DNSSummaryResponseCodeParamsFormatJson DNSSummaryResponseCodeParamsFormat = "JSON"` - `const DNSSummaryResponseCodeParamsFormatCsv DNSSummaryResponseCodeParamsFormat = "CSV"` - `LimitPerGroup param.Field[int64]` Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category. Only supported on high-cardinality dimensions; otherwise the request is rejected. Minimum value is 2. - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryResponseCodeParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryResponseCodeParamsProtocolUdp DNSSummaryResponseCodeParamsProtocol = "UDP"` - `const DNSSummaryResponseCodeParamsProtocolTCP DNSSummaryResponseCodeParamsProtocol = "TCP"` - `const DNSSummaryResponseCodeParamsProtocolHTTPS DNSSummaryResponseCodeParamsProtocol = "HTTPS"` - `const DNSSummaryResponseCodeParamsProtocolTLS DNSSummaryResponseCodeParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryResponseCodeParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryResponseCodeParamsQueryTypeA DNSSummaryResponseCodeParamsQueryType = "A"` - `const DNSSummaryResponseCodeParamsQueryTypeAAAA DNSSummaryResponseCodeParamsQueryType = "AAAA"` - `const DNSSummaryResponseCodeParamsQueryTypeA6 DNSSummaryResponseCodeParamsQueryType = "A6"` - `const DNSSummaryResponseCodeParamsQueryTypeAfsdb DNSSummaryResponseCodeParamsQueryType = "AFSDB"` - `const DNSSummaryResponseCodeParamsQueryTypeAny DNSSummaryResponseCodeParamsQueryType = "ANY"` - `const DNSSummaryResponseCodeParamsQueryTypeApl DNSSummaryResponseCodeParamsQueryType = "APL"` - `const DNSSummaryResponseCodeParamsQueryTypeAtma DNSSummaryResponseCodeParamsQueryType = "ATMA"` - `const DNSSummaryResponseCodeParamsQueryTypeAXFR DNSSummaryResponseCodeParamsQueryType = "AXFR"` - `const DNSSummaryResponseCodeParamsQueryTypeCAA DNSSummaryResponseCodeParamsQueryType = "CAA"` - `const DNSSummaryResponseCodeParamsQueryTypeCdnskey DNSSummaryResponseCodeParamsQueryType = "CDNSKEY"` - `const DNSSummaryResponseCodeParamsQueryTypeCds DNSSummaryResponseCodeParamsQueryType = "CDS"` - `const DNSSummaryResponseCodeParamsQueryTypeCERT DNSSummaryResponseCodeParamsQueryType = "CERT"` - `const DNSSummaryResponseCodeParamsQueryTypeCNAME DNSSummaryResponseCodeParamsQueryType = "CNAME"` - `const DNSSummaryResponseCodeParamsQueryTypeCsync DNSSummaryResponseCodeParamsQueryType = "CSYNC"` - `const DNSSummaryResponseCodeParamsQueryTypeDhcid DNSSummaryResponseCodeParamsQueryType = "DHCID"` - `const DNSSummaryResponseCodeParamsQueryTypeDlv DNSSummaryResponseCodeParamsQueryType = "DLV"` - `const DNSSummaryResponseCodeParamsQueryTypeDname DNSSummaryResponseCodeParamsQueryType = "DNAME"` - `const DNSSummaryResponseCodeParamsQueryTypeDNSKEY DNSSummaryResponseCodeParamsQueryType = "DNSKEY"` - `const DNSSummaryResponseCodeParamsQueryTypeDoa DNSSummaryResponseCodeParamsQueryType = "DOA"` - `const DNSSummaryResponseCodeParamsQueryTypeDS DNSSummaryResponseCodeParamsQueryType = "DS"` - `const DNSSummaryResponseCodeParamsQueryTypeEid DNSSummaryResponseCodeParamsQueryType = "EID"` - `const DNSSummaryResponseCodeParamsQueryTypeEui48 DNSSummaryResponseCodeParamsQueryType = "EUI48"` - `const DNSSummaryResponseCodeParamsQueryTypeEui64 DNSSummaryResponseCodeParamsQueryType = "EUI64"` - `const DNSSummaryResponseCodeParamsQueryTypeGpos DNSSummaryResponseCodeParamsQueryType = "GPOS"` - `const DNSSummaryResponseCodeParamsQueryTypeGid DNSSummaryResponseCodeParamsQueryType = "GID"` - `const DNSSummaryResponseCodeParamsQueryTypeHinfo DNSSummaryResponseCodeParamsQueryType = "HINFO"` - `const DNSSummaryResponseCodeParamsQueryTypeHip DNSSummaryResponseCodeParamsQueryType = "HIP"` - `const DNSSummaryResponseCodeParamsQueryTypeHTTPS DNSSummaryResponseCodeParamsQueryType = "HTTPS"` - `const DNSSummaryResponseCodeParamsQueryTypeIpseckey DNSSummaryResponseCodeParamsQueryType = "IPSECKEY"` - `const DNSSummaryResponseCodeParamsQueryTypeIsdn DNSSummaryResponseCodeParamsQueryType = "ISDN"` - `const DNSSummaryResponseCodeParamsQueryTypeIxfr DNSSummaryResponseCodeParamsQueryType = "IXFR"` - `const DNSSummaryResponseCodeParamsQueryTypeKey DNSSummaryResponseCodeParamsQueryType = "KEY"` - `const DNSSummaryResponseCodeParamsQueryTypeKx DNSSummaryResponseCodeParamsQueryType = "KX"` - `const DNSSummaryResponseCodeParamsQueryTypeL32 DNSSummaryResponseCodeParamsQueryType = "L32"` - `const DNSSummaryResponseCodeParamsQueryTypeL64 DNSSummaryResponseCodeParamsQueryType = "L64"` - `const DNSSummaryResponseCodeParamsQueryTypeLOC DNSSummaryResponseCodeParamsQueryType = "LOC"` - `const DNSSummaryResponseCodeParamsQueryTypeLp DNSSummaryResponseCodeParamsQueryType = "LP"` - `const DNSSummaryResponseCodeParamsQueryTypeMaila DNSSummaryResponseCodeParamsQueryType = "MAILA"` - `const DNSSummaryResponseCodeParamsQueryTypeMailb DNSSummaryResponseCodeParamsQueryType = "MAILB"` - `const DNSSummaryResponseCodeParamsQueryTypeMB DNSSummaryResponseCodeParamsQueryType = "MB"` - `const DNSSummaryResponseCodeParamsQueryTypeMd DNSSummaryResponseCodeParamsQueryType = "MD"` - `const DNSSummaryResponseCodeParamsQueryTypeMf DNSSummaryResponseCodeParamsQueryType = "MF"` - `const DNSSummaryResponseCodeParamsQueryTypeMg DNSSummaryResponseCodeParamsQueryType = "MG"` - `const DNSSummaryResponseCodeParamsQueryTypeMinfo DNSSummaryResponseCodeParamsQueryType = "MINFO"` - `const DNSSummaryResponseCodeParamsQueryTypeMr DNSSummaryResponseCodeParamsQueryType = "MR"` - `const DNSSummaryResponseCodeParamsQueryTypeMX DNSSummaryResponseCodeParamsQueryType = "MX"` - `const DNSSummaryResponseCodeParamsQueryTypeNAPTR DNSSummaryResponseCodeParamsQueryType = "NAPTR"` - `const DNSSummaryResponseCodeParamsQueryTypeNb DNSSummaryResponseCodeParamsQueryType = "NB"` - `const DNSSummaryResponseCodeParamsQueryTypeNbstat DNSSummaryResponseCodeParamsQueryType = "NBSTAT"` - `const DNSSummaryResponseCodeParamsQueryTypeNid DNSSummaryResponseCodeParamsQueryType = "NID"` - `const DNSSummaryResponseCodeParamsQueryTypeNimloc DNSSummaryResponseCodeParamsQueryType = "NIMLOC"` - `const DNSSummaryResponseCodeParamsQueryTypeNinfo DNSSummaryResponseCodeParamsQueryType = "NINFO"` - `const DNSSummaryResponseCodeParamsQueryTypeNS DNSSummaryResponseCodeParamsQueryType = "NS"` - `const DNSSummaryResponseCodeParamsQueryTypeNsap DNSSummaryResponseCodeParamsQueryType = "NSAP"` - `const DNSSummaryResponseCodeParamsQueryTypeNsec DNSSummaryResponseCodeParamsQueryType = "NSEC"` - `const DNSSummaryResponseCodeParamsQueryTypeNsec3 DNSSummaryResponseCodeParamsQueryType = "NSEC3"` - `const DNSSummaryResponseCodeParamsQueryTypeNsec3Param DNSSummaryResponseCodeParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryResponseCodeParamsQueryTypeNull DNSSummaryResponseCodeParamsQueryType = "NULL"` - `const DNSSummaryResponseCodeParamsQueryTypeNxt DNSSummaryResponseCodeParamsQueryType = "NXT"` - `const DNSSummaryResponseCodeParamsQueryTypeOpenpgpkey DNSSummaryResponseCodeParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryResponseCodeParamsQueryTypeOpt DNSSummaryResponseCodeParamsQueryType = "OPT"` - `const DNSSummaryResponseCodeParamsQueryTypePTR DNSSummaryResponseCodeParamsQueryType = "PTR"` - `const DNSSummaryResponseCodeParamsQueryTypePx DNSSummaryResponseCodeParamsQueryType = "PX"` - `const DNSSummaryResponseCodeParamsQueryTypeRkey DNSSummaryResponseCodeParamsQueryType = "RKEY"` - `const DNSSummaryResponseCodeParamsQueryTypeRp DNSSummaryResponseCodeParamsQueryType = "RP"` - `const DNSSummaryResponseCodeParamsQueryTypeRrsig DNSSummaryResponseCodeParamsQueryType = "RRSIG"` - `const DNSSummaryResponseCodeParamsQueryTypeRt DNSSummaryResponseCodeParamsQueryType = "RT"` - `const DNSSummaryResponseCodeParamsQueryTypeSig DNSSummaryResponseCodeParamsQueryType = "SIG"` - `const DNSSummaryResponseCodeParamsQueryTypeSink DNSSummaryResponseCodeParamsQueryType = "SINK"` - `const DNSSummaryResponseCodeParamsQueryTypeSMIMEA DNSSummaryResponseCodeParamsQueryType = "SMIMEA"` - `const DNSSummaryResponseCodeParamsQueryTypeSOA DNSSummaryResponseCodeParamsQueryType = "SOA"` - `const DNSSummaryResponseCodeParamsQueryTypeSPF DNSSummaryResponseCodeParamsQueryType = "SPF"` - `const DNSSummaryResponseCodeParamsQueryTypeSRV DNSSummaryResponseCodeParamsQueryType = "SRV"` - `const DNSSummaryResponseCodeParamsQueryTypeSSHFP DNSSummaryResponseCodeParamsQueryType = "SSHFP"` - `const DNSSummaryResponseCodeParamsQueryTypeSVCB DNSSummaryResponseCodeParamsQueryType = "SVCB"` - `const DNSSummaryResponseCodeParamsQueryTypeTa DNSSummaryResponseCodeParamsQueryType = "TA"` - `const DNSSummaryResponseCodeParamsQueryTypeTalink DNSSummaryResponseCodeParamsQueryType = "TALINK"` - `const DNSSummaryResponseCodeParamsQueryTypeTkey DNSSummaryResponseCodeParamsQueryType = "TKEY"` - `const DNSSummaryResponseCodeParamsQueryTypeTLSA DNSSummaryResponseCodeParamsQueryType = "TLSA"` - `const DNSSummaryResponseCodeParamsQueryTypeTSIG DNSSummaryResponseCodeParamsQueryType = "TSIG"` - `const DNSSummaryResponseCodeParamsQueryTypeTXT DNSSummaryResponseCodeParamsQueryType = "TXT"` - `const DNSSummaryResponseCodeParamsQueryTypeUinfo DNSSummaryResponseCodeParamsQueryType = "UINFO"` - `const DNSSummaryResponseCodeParamsQueryTypeUID DNSSummaryResponseCodeParamsQueryType = "UID"` - `const DNSSummaryResponseCodeParamsQueryTypeUnspec DNSSummaryResponseCodeParamsQueryType = "UNSPEC"` - `const DNSSummaryResponseCodeParamsQueryTypeURI DNSSummaryResponseCodeParamsQueryType = "URI"` - `const DNSSummaryResponseCodeParamsQueryTypeWks DNSSummaryResponseCodeParamsQueryType = "WKS"` - `const DNSSummaryResponseCodeParamsQueryTypeX25 DNSSummaryResponseCodeParamsQueryType = "X25"` - `const DNSSummaryResponseCodeParamsQueryTypeZonemd DNSSummaryResponseCodeParamsQueryType = "ZONEMD"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryResponseCodeResponse struct{…}` - `Meta DNSSummaryResponseCodeResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryResponseCodeResponseMetaConfidenceInfo` - `Annotations []DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryResponseCodeResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryResponseCodeResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryResponseCodeResponseMetaNormalizationPercentage DNSSummaryResponseCodeResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryResponseCodeResponseMetaNormalizationMin0Max DNSSummaryResponseCodeResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryResponseCodeResponseMetaNormalizationMinMax DNSSummaryResponseCodeResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryResponseCodeResponseMetaNormalizationRawValues DNSSummaryResponseCodeResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryResponseCodeResponseMetaNormalizationPercentageChange DNSSummaryResponseCodeResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryResponseCodeResponseMetaNormalizationRollingAverage DNSSummaryResponseCodeResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryResponseCodeResponseMetaNormalizationOverlappedPercentage DNSSummaryResponseCodeResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryResponseCodeResponseMetaNormalizationRatio DNSSummaryResponseCodeResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryResponseCodeResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 map[string, string]` ### Example ```go 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.Summary.ResponseCode(context.TODO(), radar.DNSSummaryResponseCodeParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_0": { "NOERROR": "70", "NOTIMP": "5", "NXDOMAIN": "10", "REFUSED": "5", "SERVFAIL": "5" } }, "success": true } ``` ## Get DNS queries by response TTL summary `client.Radar.DNS.Summary.ResponseTTL(ctx, query) (*DNSSummaryResponseTTLResponse, error)` **get** `/radar/dns/summary/response_ttl` Retrieves the distribution of DNS queries by minimum response TTL. ### Parameters - `query DNSSummaryResponseTTLParams` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSSummaryResponseTTLParamsFormat]` Format in which results will be returned. - `const DNSSummaryResponseTTLParamsFormatJson DNSSummaryResponseTTLParamsFormat = "JSON"` - `const DNSSummaryResponseTTLParamsFormatCsv DNSSummaryResponseTTLParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSSummaryResponseTTLParamsProtocol]` Filters results by DNS transport protocol. - `const DNSSummaryResponseTTLParamsProtocolUdp DNSSummaryResponseTTLParamsProtocol = "UDP"` - `const DNSSummaryResponseTTLParamsProtocolTCP DNSSummaryResponseTTLParamsProtocol = "TCP"` - `const DNSSummaryResponseTTLParamsProtocolHTTPS DNSSummaryResponseTTLParamsProtocol = "HTTPS"` - `const DNSSummaryResponseTTLParamsProtocolTLS DNSSummaryResponseTTLParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSSummaryResponseTTLParamsQueryType]` Filters results by DNS query type. - `const DNSSummaryResponseTTLParamsQueryTypeA DNSSummaryResponseTTLParamsQueryType = "A"` - `const DNSSummaryResponseTTLParamsQueryTypeAAAA DNSSummaryResponseTTLParamsQueryType = "AAAA"` - `const DNSSummaryResponseTTLParamsQueryTypeA6 DNSSummaryResponseTTLParamsQueryType = "A6"` - `const DNSSummaryResponseTTLParamsQueryTypeAfsdb DNSSummaryResponseTTLParamsQueryType = "AFSDB"` - `const DNSSummaryResponseTTLParamsQueryTypeAny DNSSummaryResponseTTLParamsQueryType = "ANY"` - `const DNSSummaryResponseTTLParamsQueryTypeApl DNSSummaryResponseTTLParamsQueryType = "APL"` - `const DNSSummaryResponseTTLParamsQueryTypeAtma DNSSummaryResponseTTLParamsQueryType = "ATMA"` - `const DNSSummaryResponseTTLParamsQueryTypeAXFR DNSSummaryResponseTTLParamsQueryType = "AXFR"` - `const DNSSummaryResponseTTLParamsQueryTypeCAA DNSSummaryResponseTTLParamsQueryType = "CAA"` - `const DNSSummaryResponseTTLParamsQueryTypeCdnskey DNSSummaryResponseTTLParamsQueryType = "CDNSKEY"` - `const DNSSummaryResponseTTLParamsQueryTypeCds DNSSummaryResponseTTLParamsQueryType = "CDS"` - `const DNSSummaryResponseTTLParamsQueryTypeCERT DNSSummaryResponseTTLParamsQueryType = "CERT"` - `const DNSSummaryResponseTTLParamsQueryTypeCNAME DNSSummaryResponseTTLParamsQueryType = "CNAME"` - `const DNSSummaryResponseTTLParamsQueryTypeCsync DNSSummaryResponseTTLParamsQueryType = "CSYNC"` - `const DNSSummaryResponseTTLParamsQueryTypeDhcid DNSSummaryResponseTTLParamsQueryType = "DHCID"` - `const DNSSummaryResponseTTLParamsQueryTypeDlv DNSSummaryResponseTTLParamsQueryType = "DLV"` - `const DNSSummaryResponseTTLParamsQueryTypeDname DNSSummaryResponseTTLParamsQueryType = "DNAME"` - `const DNSSummaryResponseTTLParamsQueryTypeDNSKEY DNSSummaryResponseTTLParamsQueryType = "DNSKEY"` - `const DNSSummaryResponseTTLParamsQueryTypeDoa DNSSummaryResponseTTLParamsQueryType = "DOA"` - `const DNSSummaryResponseTTLParamsQueryTypeDS DNSSummaryResponseTTLParamsQueryType = "DS"` - `const DNSSummaryResponseTTLParamsQueryTypeEid DNSSummaryResponseTTLParamsQueryType = "EID"` - `const DNSSummaryResponseTTLParamsQueryTypeEui48 DNSSummaryResponseTTLParamsQueryType = "EUI48"` - `const DNSSummaryResponseTTLParamsQueryTypeEui64 DNSSummaryResponseTTLParamsQueryType = "EUI64"` - `const DNSSummaryResponseTTLParamsQueryTypeGpos DNSSummaryResponseTTLParamsQueryType = "GPOS"` - `const DNSSummaryResponseTTLParamsQueryTypeGid DNSSummaryResponseTTLParamsQueryType = "GID"` - `const DNSSummaryResponseTTLParamsQueryTypeHinfo DNSSummaryResponseTTLParamsQueryType = "HINFO"` - `const DNSSummaryResponseTTLParamsQueryTypeHip DNSSummaryResponseTTLParamsQueryType = "HIP"` - `const DNSSummaryResponseTTLParamsQueryTypeHTTPS DNSSummaryResponseTTLParamsQueryType = "HTTPS"` - `const DNSSummaryResponseTTLParamsQueryTypeIpseckey DNSSummaryResponseTTLParamsQueryType = "IPSECKEY"` - `const DNSSummaryResponseTTLParamsQueryTypeIsdn DNSSummaryResponseTTLParamsQueryType = "ISDN"` - `const DNSSummaryResponseTTLParamsQueryTypeIxfr DNSSummaryResponseTTLParamsQueryType = "IXFR"` - `const DNSSummaryResponseTTLParamsQueryTypeKey DNSSummaryResponseTTLParamsQueryType = "KEY"` - `const DNSSummaryResponseTTLParamsQueryTypeKx DNSSummaryResponseTTLParamsQueryType = "KX"` - `const DNSSummaryResponseTTLParamsQueryTypeL32 DNSSummaryResponseTTLParamsQueryType = "L32"` - `const DNSSummaryResponseTTLParamsQueryTypeL64 DNSSummaryResponseTTLParamsQueryType = "L64"` - `const DNSSummaryResponseTTLParamsQueryTypeLOC DNSSummaryResponseTTLParamsQueryType = "LOC"` - `const DNSSummaryResponseTTLParamsQueryTypeLp DNSSummaryResponseTTLParamsQueryType = "LP"` - `const DNSSummaryResponseTTLParamsQueryTypeMaila DNSSummaryResponseTTLParamsQueryType = "MAILA"` - `const DNSSummaryResponseTTLParamsQueryTypeMailb DNSSummaryResponseTTLParamsQueryType = "MAILB"` - `const DNSSummaryResponseTTLParamsQueryTypeMB DNSSummaryResponseTTLParamsQueryType = "MB"` - `const DNSSummaryResponseTTLParamsQueryTypeMd DNSSummaryResponseTTLParamsQueryType = "MD"` - `const DNSSummaryResponseTTLParamsQueryTypeMf DNSSummaryResponseTTLParamsQueryType = "MF"` - `const DNSSummaryResponseTTLParamsQueryTypeMg DNSSummaryResponseTTLParamsQueryType = "MG"` - `const DNSSummaryResponseTTLParamsQueryTypeMinfo DNSSummaryResponseTTLParamsQueryType = "MINFO"` - `const DNSSummaryResponseTTLParamsQueryTypeMr DNSSummaryResponseTTLParamsQueryType = "MR"` - `const DNSSummaryResponseTTLParamsQueryTypeMX DNSSummaryResponseTTLParamsQueryType = "MX"` - `const DNSSummaryResponseTTLParamsQueryTypeNAPTR DNSSummaryResponseTTLParamsQueryType = "NAPTR"` - `const DNSSummaryResponseTTLParamsQueryTypeNb DNSSummaryResponseTTLParamsQueryType = "NB"` - `const DNSSummaryResponseTTLParamsQueryTypeNbstat DNSSummaryResponseTTLParamsQueryType = "NBSTAT"` - `const DNSSummaryResponseTTLParamsQueryTypeNid DNSSummaryResponseTTLParamsQueryType = "NID"` - `const DNSSummaryResponseTTLParamsQueryTypeNimloc DNSSummaryResponseTTLParamsQueryType = "NIMLOC"` - `const DNSSummaryResponseTTLParamsQueryTypeNinfo DNSSummaryResponseTTLParamsQueryType = "NINFO"` - `const DNSSummaryResponseTTLParamsQueryTypeNS DNSSummaryResponseTTLParamsQueryType = "NS"` - `const DNSSummaryResponseTTLParamsQueryTypeNsap DNSSummaryResponseTTLParamsQueryType = "NSAP"` - `const DNSSummaryResponseTTLParamsQueryTypeNsec DNSSummaryResponseTTLParamsQueryType = "NSEC"` - `const DNSSummaryResponseTTLParamsQueryTypeNsec3 DNSSummaryResponseTTLParamsQueryType = "NSEC3"` - `const DNSSummaryResponseTTLParamsQueryTypeNsec3Param DNSSummaryResponseTTLParamsQueryType = "NSEC3PARAM"` - `const DNSSummaryResponseTTLParamsQueryTypeNull DNSSummaryResponseTTLParamsQueryType = "NULL"` - `const DNSSummaryResponseTTLParamsQueryTypeNxt DNSSummaryResponseTTLParamsQueryType = "NXT"` - `const DNSSummaryResponseTTLParamsQueryTypeOpenpgpkey DNSSummaryResponseTTLParamsQueryType = "OPENPGPKEY"` - `const DNSSummaryResponseTTLParamsQueryTypeOpt DNSSummaryResponseTTLParamsQueryType = "OPT"` - `const DNSSummaryResponseTTLParamsQueryTypePTR DNSSummaryResponseTTLParamsQueryType = "PTR"` - `const DNSSummaryResponseTTLParamsQueryTypePx DNSSummaryResponseTTLParamsQueryType = "PX"` - `const DNSSummaryResponseTTLParamsQueryTypeRkey DNSSummaryResponseTTLParamsQueryType = "RKEY"` - `const DNSSummaryResponseTTLParamsQueryTypeRp DNSSummaryResponseTTLParamsQueryType = "RP"` - `const DNSSummaryResponseTTLParamsQueryTypeRrsig DNSSummaryResponseTTLParamsQueryType = "RRSIG"` - `const DNSSummaryResponseTTLParamsQueryTypeRt DNSSummaryResponseTTLParamsQueryType = "RT"` - `const DNSSummaryResponseTTLParamsQueryTypeSig DNSSummaryResponseTTLParamsQueryType = "SIG"` - `const DNSSummaryResponseTTLParamsQueryTypeSink DNSSummaryResponseTTLParamsQueryType = "SINK"` - `const DNSSummaryResponseTTLParamsQueryTypeSMIMEA DNSSummaryResponseTTLParamsQueryType = "SMIMEA"` - `const DNSSummaryResponseTTLParamsQueryTypeSOA DNSSummaryResponseTTLParamsQueryType = "SOA"` - `const DNSSummaryResponseTTLParamsQueryTypeSPF DNSSummaryResponseTTLParamsQueryType = "SPF"` - `const DNSSummaryResponseTTLParamsQueryTypeSRV DNSSummaryResponseTTLParamsQueryType = "SRV"` - `const DNSSummaryResponseTTLParamsQueryTypeSSHFP DNSSummaryResponseTTLParamsQueryType = "SSHFP"` - `const DNSSummaryResponseTTLParamsQueryTypeSVCB DNSSummaryResponseTTLParamsQueryType = "SVCB"` - `const DNSSummaryResponseTTLParamsQueryTypeTa DNSSummaryResponseTTLParamsQueryType = "TA"` - `const DNSSummaryResponseTTLParamsQueryTypeTalink DNSSummaryResponseTTLParamsQueryType = "TALINK"` - `const DNSSummaryResponseTTLParamsQueryTypeTkey DNSSummaryResponseTTLParamsQueryType = "TKEY"` - `const DNSSummaryResponseTTLParamsQueryTypeTLSA DNSSummaryResponseTTLParamsQueryType = "TLSA"` - `const DNSSummaryResponseTTLParamsQueryTypeTSIG DNSSummaryResponseTTLParamsQueryType = "TSIG"` - `const DNSSummaryResponseTTLParamsQueryTypeTXT DNSSummaryResponseTTLParamsQueryType = "TXT"` - `const DNSSummaryResponseTTLParamsQueryTypeUinfo DNSSummaryResponseTTLParamsQueryType = "UINFO"` - `const DNSSummaryResponseTTLParamsQueryTypeUID DNSSummaryResponseTTLParamsQueryType = "UID"` - `const DNSSummaryResponseTTLParamsQueryTypeUnspec DNSSummaryResponseTTLParamsQueryType = "UNSPEC"` - `const DNSSummaryResponseTTLParamsQueryTypeURI DNSSummaryResponseTTLParamsQueryType = "URI"` - `const DNSSummaryResponseTTLParamsQueryTypeWks DNSSummaryResponseTTLParamsQueryType = "WKS"` - `const DNSSummaryResponseTTLParamsQueryTypeX25 DNSSummaryResponseTTLParamsQueryType = "X25"` - `const DNSSummaryResponseTTLParamsQueryTypeZonemd DNSSummaryResponseTTLParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSSummaryResponseTTLParamsResponseCode]` Filters results by DNS response code. - `const DNSSummaryResponseTTLParamsResponseCodeNoerror DNSSummaryResponseTTLParamsResponseCode = "NOERROR"` - `const DNSSummaryResponseTTLParamsResponseCodeFormerr DNSSummaryResponseTTLParamsResponseCode = "FORMERR"` - `const DNSSummaryResponseTTLParamsResponseCodeServfail DNSSummaryResponseTTLParamsResponseCode = "SERVFAIL"` - `const DNSSummaryResponseTTLParamsResponseCodeNxdomain DNSSummaryResponseTTLParamsResponseCode = "NXDOMAIN"` - `const DNSSummaryResponseTTLParamsResponseCodeNotimp DNSSummaryResponseTTLParamsResponseCode = "NOTIMP"` - `const DNSSummaryResponseTTLParamsResponseCodeRefused DNSSummaryResponseTTLParamsResponseCode = "REFUSED"` - `const DNSSummaryResponseTTLParamsResponseCodeYxdomain DNSSummaryResponseTTLParamsResponseCode = "YXDOMAIN"` - `const DNSSummaryResponseTTLParamsResponseCodeYxrrset DNSSummaryResponseTTLParamsResponseCode = "YXRRSET"` - `const DNSSummaryResponseTTLParamsResponseCodeNxrrset DNSSummaryResponseTTLParamsResponseCode = "NXRRSET"` - `const DNSSummaryResponseTTLParamsResponseCodeNotauth DNSSummaryResponseTTLParamsResponseCode = "NOTAUTH"` - `const DNSSummaryResponseTTLParamsResponseCodeNotzone DNSSummaryResponseTTLParamsResponseCode = "NOTZONE"` - `const DNSSummaryResponseTTLParamsResponseCodeBadsig DNSSummaryResponseTTLParamsResponseCode = "BADSIG"` - `const DNSSummaryResponseTTLParamsResponseCodeBadkey DNSSummaryResponseTTLParamsResponseCode = "BADKEY"` - `const DNSSummaryResponseTTLParamsResponseCodeBadtime DNSSummaryResponseTTLParamsResponseCode = "BADTIME"` - `const DNSSummaryResponseTTLParamsResponseCodeBadmode DNSSummaryResponseTTLParamsResponseCode = "BADMODE"` - `const DNSSummaryResponseTTLParamsResponseCodeBadname DNSSummaryResponseTTLParamsResponseCode = "BADNAME"` - `const DNSSummaryResponseTTLParamsResponseCodeBadalg DNSSummaryResponseTTLParamsResponseCode = "BADALG"` - `const DNSSummaryResponseTTLParamsResponseCodeBadtrunc DNSSummaryResponseTTLParamsResponseCode = "BADTRUNC"` - `const DNSSummaryResponseTTLParamsResponseCodeBadcookie DNSSummaryResponseTTLParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSSummaryResponseTTLResponse struct{…}` - `Meta DNSSummaryResponseTTLResponseMeta` Metadata for the results. - `ConfidenceInfo DNSSummaryResponseTTLResponseMetaConfidenceInfo` - `Annotations []DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotation` - `DataSource DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSSummaryResponseTTLResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSSummaryResponseTTLResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSSummaryResponseTTLResponseMetaNormalizationPercentage DNSSummaryResponseTTLResponseMetaNormalization = "PERCENTAGE"` - `const DNSSummaryResponseTTLResponseMetaNormalizationMin0Max DNSSummaryResponseTTLResponseMetaNormalization = "MIN0_MAX"` - `const DNSSummaryResponseTTLResponseMetaNormalizationMinMax DNSSummaryResponseTTLResponseMetaNormalization = "MIN_MAX"` - `const DNSSummaryResponseTTLResponseMetaNormalizationRawValues DNSSummaryResponseTTLResponseMetaNormalization = "RAW_VALUES"` - `const DNSSummaryResponseTTLResponseMetaNormalizationPercentageChange DNSSummaryResponseTTLResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSSummaryResponseTTLResponseMetaNormalizationRollingAverage DNSSummaryResponseTTLResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSSummaryResponseTTLResponseMetaNormalizationOverlappedPercentage DNSSummaryResponseTTLResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSSummaryResponseTTLResponseMetaNormalizationRatio DNSSummaryResponseTTLResponseMetaNormalization = "RATIO"` - `Units []DNSSummaryResponseTTLResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Summary0 DNSSummaryResponseTTLResponseSummary0` - `Gt15mLte1h string` A numeric string. - `Gt1dLte1w string` A numeric string. - `Gt1hLte1d string` A numeric string. - `Gt1mLte5m string` A numeric string. - `Gt1w string` A numeric string. - `Gt5mLte15m string` A numeric string. - `Lte1m string` A numeric string. ### Example ```go 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.Summary.ResponseTTL(context.TODO(), radar.DNSSummaryResponseTTLParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "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" } ] }, "summary_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 } ``` # Timeseries Groups ## Get DNS queries by cache status time series `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. ### Parameters - `query DNSTimeseriesGroupCacheHitParams` - `AggInterval param.Field[DNSTimeseriesGroupCacheHitParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupCacheHitParamsAggInterval15m DNSTimeseriesGroupCacheHitParamsAggInterval = "15m"` - `const DNSTimeseriesGroupCacheHitParamsAggInterval1h DNSTimeseriesGroupCacheHitParamsAggInterval = "1h"` - `const DNSTimeseriesGroupCacheHitParamsAggInterval1d DNSTimeseriesGroupCacheHitParamsAggInterval = "1d"` - `const DNSTimeseriesGroupCacheHitParamsAggInterval1w DNSTimeseriesGroupCacheHitParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupCacheHitParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupCacheHitParamsFormatJson DNSTimeseriesGroupCacheHitParamsFormat = "JSON"` - `const DNSTimeseriesGroupCacheHitParamsFormatCsv DNSTimeseriesGroupCacheHitParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupCacheHitParamsProtocol]` 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]` 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]` 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]` 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`). ### Returns - `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](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `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. - `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` - `EventType DNSTimeseriesGroupCacheHitResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `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` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupCacheHitResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupCacheHitResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `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` ### Example ```go 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.CacheHit(context.TODO(), radar.DNSTimeseriesGroupCacheHitParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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 } ``` ## Get DNS queries by DNSSEC support time series `client.Radar.DNS.TimeseriesGroups.DNSSEC(ctx, query) (*DNSTimeseriesGroupDNSSECResponse, error)` **get** `/radar/dns/timeseries_groups/dnssec` Retrieves the distribution of DNS responses by DNSSEC (DNS Security Extensions) support over time. ### Parameters - `query DNSTimeseriesGroupDNSSECParams` - `AggInterval param.Field[DNSTimeseriesGroupDNSSECParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupDNSSECParamsAggInterval15m DNSTimeseriesGroupDNSSECParamsAggInterval = "15m"` - `const DNSTimeseriesGroupDNSSECParamsAggInterval1h DNSTimeseriesGroupDNSSECParamsAggInterval = "1h"` - `const DNSTimeseriesGroupDNSSECParamsAggInterval1d DNSTimeseriesGroupDNSSECParamsAggInterval = "1d"` - `const DNSTimeseriesGroupDNSSECParamsAggInterval1w DNSTimeseriesGroupDNSSECParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupDNSSECParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupDNSSECParamsFormatJson DNSTimeseriesGroupDNSSECParamsFormat = "JSON"` - `const DNSTimeseriesGroupDNSSECParamsFormatCsv DNSTimeseriesGroupDNSSECParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupDNSSECParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupDNSSECParamsProtocolUdp DNSTimeseriesGroupDNSSECParamsProtocol = "UDP"` - `const DNSTimeseriesGroupDNSSECParamsProtocolTCP DNSTimeseriesGroupDNSSECParamsProtocol = "TCP"` - `const DNSTimeseriesGroupDNSSECParamsProtocolHTTPS DNSTimeseriesGroupDNSSECParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupDNSSECParamsProtocolTLS DNSTimeseriesGroupDNSSECParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesGroupDNSSECParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupDNSSECParamsQueryTypeA DNSTimeseriesGroupDNSSECParamsQueryType = "A"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeAAAA DNSTimeseriesGroupDNSSECParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeA6 DNSTimeseriesGroupDNSSECParamsQueryType = "A6"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeAfsdb DNSTimeseriesGroupDNSSECParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeAny DNSTimeseriesGroupDNSSECParamsQueryType = "ANY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeApl DNSTimeseriesGroupDNSSECParamsQueryType = "APL"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeAtma DNSTimeseriesGroupDNSSECParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeAXFR DNSTimeseriesGroupDNSSECParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeCAA DNSTimeseriesGroupDNSSECParamsQueryType = "CAA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeCdnskey DNSTimeseriesGroupDNSSECParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeCds DNSTimeseriesGroupDNSSECParamsQueryType = "CDS"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeCERT DNSTimeseriesGroupDNSSECParamsQueryType = "CERT"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeCNAME DNSTimeseriesGroupDNSSECParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeCsync DNSTimeseriesGroupDNSSECParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeDhcid DNSTimeseriesGroupDNSSECParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeDlv DNSTimeseriesGroupDNSSECParamsQueryType = "DLV"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeDname DNSTimeseriesGroupDNSSECParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeDNSKEY DNSTimeseriesGroupDNSSECParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeDoa DNSTimeseriesGroupDNSSECParamsQueryType = "DOA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeDS DNSTimeseriesGroupDNSSECParamsQueryType = "DS"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeEid DNSTimeseriesGroupDNSSECParamsQueryType = "EID"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeEui48 DNSTimeseriesGroupDNSSECParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeEui64 DNSTimeseriesGroupDNSSECParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeGpos DNSTimeseriesGroupDNSSECParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeGid DNSTimeseriesGroupDNSSECParamsQueryType = "GID"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeHinfo DNSTimeseriesGroupDNSSECParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeHip DNSTimeseriesGroupDNSSECParamsQueryType = "HIP"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeHTTPS DNSTimeseriesGroupDNSSECParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeIpseckey DNSTimeseriesGroupDNSSECParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeIsdn DNSTimeseriesGroupDNSSECParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeIxfr DNSTimeseriesGroupDNSSECParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeKey DNSTimeseriesGroupDNSSECParamsQueryType = "KEY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeKx DNSTimeseriesGroupDNSSECParamsQueryType = "KX"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeL32 DNSTimeseriesGroupDNSSECParamsQueryType = "L32"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeL64 DNSTimeseriesGroupDNSSECParamsQueryType = "L64"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeLOC DNSTimeseriesGroupDNSSECParamsQueryType = "LOC"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeLp DNSTimeseriesGroupDNSSECParamsQueryType = "LP"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMaila DNSTimeseriesGroupDNSSECParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMailb DNSTimeseriesGroupDNSSECParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMB DNSTimeseriesGroupDNSSECParamsQueryType = "MB"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMd DNSTimeseriesGroupDNSSECParamsQueryType = "MD"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMf DNSTimeseriesGroupDNSSECParamsQueryType = "MF"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMg DNSTimeseriesGroupDNSSECParamsQueryType = "MG"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMinfo DNSTimeseriesGroupDNSSECParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMr DNSTimeseriesGroupDNSSECParamsQueryType = "MR"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeMX DNSTimeseriesGroupDNSSECParamsQueryType = "MX"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNAPTR DNSTimeseriesGroupDNSSECParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNb DNSTimeseriesGroupDNSSECParamsQueryType = "NB"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNbstat DNSTimeseriesGroupDNSSECParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNid DNSTimeseriesGroupDNSSECParamsQueryType = "NID"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNimloc DNSTimeseriesGroupDNSSECParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNinfo DNSTimeseriesGroupDNSSECParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNS DNSTimeseriesGroupDNSSECParamsQueryType = "NS"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNsap DNSTimeseriesGroupDNSSECParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNsec DNSTimeseriesGroupDNSSECParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNsec3 DNSTimeseriesGroupDNSSECParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNsec3Param DNSTimeseriesGroupDNSSECParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNull DNSTimeseriesGroupDNSSECParamsQueryType = "NULL"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeNxt DNSTimeseriesGroupDNSSECParamsQueryType = "NXT"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeOpenpgpkey DNSTimeseriesGroupDNSSECParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeOpt DNSTimeseriesGroupDNSSECParamsQueryType = "OPT"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypePTR DNSTimeseriesGroupDNSSECParamsQueryType = "PTR"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypePx DNSTimeseriesGroupDNSSECParamsQueryType = "PX"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeRkey DNSTimeseriesGroupDNSSECParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeRp DNSTimeseriesGroupDNSSECParamsQueryType = "RP"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeRrsig DNSTimeseriesGroupDNSSECParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeRt DNSTimeseriesGroupDNSSECParamsQueryType = "RT"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSig DNSTimeseriesGroupDNSSECParamsQueryType = "SIG"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSink DNSTimeseriesGroupDNSSECParamsQueryType = "SINK"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSMIMEA DNSTimeseriesGroupDNSSECParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSOA DNSTimeseriesGroupDNSSECParamsQueryType = "SOA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSPF DNSTimeseriesGroupDNSSECParamsQueryType = "SPF"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSRV DNSTimeseriesGroupDNSSECParamsQueryType = "SRV"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSSHFP DNSTimeseriesGroupDNSSECParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeSVCB DNSTimeseriesGroupDNSSECParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeTa DNSTimeseriesGroupDNSSECParamsQueryType = "TA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeTalink DNSTimeseriesGroupDNSSECParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeTkey DNSTimeseriesGroupDNSSECParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeTLSA DNSTimeseriesGroupDNSSECParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeTSIG DNSTimeseriesGroupDNSSECParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeTXT DNSTimeseriesGroupDNSSECParamsQueryType = "TXT"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeUinfo DNSTimeseriesGroupDNSSECParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeUID DNSTimeseriesGroupDNSSECParamsQueryType = "UID"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeUnspec DNSTimeseriesGroupDNSSECParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeURI DNSTimeseriesGroupDNSSECParamsQueryType = "URI"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeWks DNSTimeseriesGroupDNSSECParamsQueryType = "WKS"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeX25 DNSTimeseriesGroupDNSSECParamsQueryType = "X25"` - `const DNSTimeseriesGroupDNSSECParamsQueryTypeZonemd DNSTimeseriesGroupDNSSECParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesGroupDNSSECParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupDNSSECParamsResponseCodeNoerror DNSTimeseriesGroupDNSSECParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeFormerr DNSTimeseriesGroupDNSSECParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeServfail DNSTimeseriesGroupDNSSECParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeNxdomain DNSTimeseriesGroupDNSSECParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeNotimp DNSTimeseriesGroupDNSSECParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeRefused DNSTimeseriesGroupDNSSECParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeYxdomain DNSTimeseriesGroupDNSSECParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeYxrrset DNSTimeseriesGroupDNSSECParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeNxrrset DNSTimeseriesGroupDNSSECParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeNotauth DNSTimeseriesGroupDNSSECParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeNotzone DNSTimeseriesGroupDNSSECParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadsig DNSTimeseriesGroupDNSSECParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadkey DNSTimeseriesGroupDNSSECParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadtime DNSTimeseriesGroupDNSSECParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadmode DNSTimeseriesGroupDNSSECParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadname DNSTimeseriesGroupDNSSECParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadalg DNSTimeseriesGroupDNSSECParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadtrunc DNSTimeseriesGroupDNSSECParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupDNSSECParamsResponseCodeBadcookie DNSTimeseriesGroupDNSSECParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupDNSSECResponse struct{…}` - `Meta DNSTimeseriesGroupDNSSECResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupDNSSECResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupDNSSECResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupDNSSECResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupDNSSECResponseMetaAggIntervalOneHour DNSTimeseriesGroupDNSSECResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupDNSSECResponseMetaAggIntervalOneDay DNSTimeseriesGroupDNSSECResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupDNSSECResponseMetaAggIntervalOneWeek DNSTimeseriesGroupDNSSECResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupDNSSECResponseMetaAggIntervalOneMonth DNSTimeseriesGroupDNSSECResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupDNSSECResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupDNSSECResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupDNSSECResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationPercentage DNSTimeseriesGroupDNSSECResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationMin0Max DNSTimeseriesGroupDNSSECResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationMinMax DNSTimeseriesGroupDNSSECResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationRawValues DNSTimeseriesGroupDNSSECResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationPercentageChange DNSTimeseriesGroupDNSSECResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationRollingAverage DNSTimeseriesGroupDNSSECResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupDNSSECResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupDNSSECResponseMetaNormalizationRatio DNSTimeseriesGroupDNSSECResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupDNSSECResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupDNSSECResponseSerie0` - `Insecure []string` - `Invalid []string` - `Other []string` - `Secure []string` ### Example ```go 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.DNSSEC(context.TODO(), radar.DNSTimeseriesGroupDNSSECParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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": { "INSECURE": [ "10" ], "INVALID": [ "10" ], "OTHER": [ "10" ], "SECURE": [ "10" ] } }, "success": true } ``` ## Get DNS queries by DNSSEC awareness time series `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. ### Parameters - `query DNSTimeseriesGroupDNSSECAwareParams` - `AggInterval param.Field[DNSTimeseriesGroupDNSSECAwareParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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]` Format in which results will be returned. - `const DNSTimeseriesGroupDNSSECAwareParamsFormatJson DNSTimeseriesGroupDNSSECAwareParamsFormat = "JSON"` - `const DNSTimeseriesGroupDNSSECAwareParamsFormatCsv DNSTimeseriesGroupDNSSECAwareParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupDNSSECAwareParamsProtocol]` 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]` 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]` 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]` 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`). ### Returns - `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](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `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. - `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` - `EventType DNSTimeseriesGroupDNSSECAwareResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `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` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupDNSSECAwareResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupDNSSECAwareResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `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` ### Example ```go 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) } ``` #### Response ```json { "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 } ``` ## Get DNS queries by DNSSEC end-to-end time series `client.Radar.DNS.TimeseriesGroups.DNSSECE2E(ctx, query) (*DNSTimeseriesGroupDnssece2EResponse, error)` **get** `/radar/dns/timeseries_groups/dnssec_e2e` Retrieves the distribution of DNSSEC-validated answers by end-to-end security status over time. ### Parameters - `query DNSTimeseriesGroupDNSSECE2EParams` - `AggInterval param.Field[DNSTimeseriesGroupDnssece2EParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupDnssece2EParamsAggInterval15m DNSTimeseriesGroupDnssece2EParamsAggInterval = "15m"` - `const DNSTimeseriesGroupDnssece2EParamsAggInterval1h DNSTimeseriesGroupDnssece2EParamsAggInterval = "1h"` - `const DNSTimeseriesGroupDnssece2EParamsAggInterval1d DNSTimeseriesGroupDnssece2EParamsAggInterval = "1d"` - `const DNSTimeseriesGroupDnssece2EParamsAggInterval1w DNSTimeseriesGroupDnssece2EParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupDnssece2EParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupDnssece2EParamsFormatJson DNSTimeseriesGroupDnssece2EParamsFormat = "JSON"` - `const DNSTimeseriesGroupDnssece2EParamsFormatCsv DNSTimeseriesGroupDnssece2EParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupDnssece2EParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupDnssece2EParamsProtocolUdp DNSTimeseriesGroupDnssece2EParamsProtocol = "UDP"` - `const DNSTimeseriesGroupDnssece2EParamsProtocolTCP DNSTimeseriesGroupDnssece2EParamsProtocol = "TCP"` - `const DNSTimeseriesGroupDnssece2EParamsProtocolHTTPS DNSTimeseriesGroupDnssece2EParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupDnssece2EParamsProtocolTLS DNSTimeseriesGroupDnssece2EParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesGroupDnssece2EParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeA DNSTimeseriesGroupDnssece2EParamsQueryType = "A"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeAAAA DNSTimeseriesGroupDnssece2EParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeA6 DNSTimeseriesGroupDnssece2EParamsQueryType = "A6"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeAfsdb DNSTimeseriesGroupDnssece2EParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeAny DNSTimeseriesGroupDnssece2EParamsQueryType = "ANY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeApl DNSTimeseriesGroupDnssece2EParamsQueryType = "APL"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeAtma DNSTimeseriesGroupDnssece2EParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeAXFR DNSTimeseriesGroupDnssece2EParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeCAA DNSTimeseriesGroupDnssece2EParamsQueryType = "CAA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeCdnskey DNSTimeseriesGroupDnssece2EParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeCds DNSTimeseriesGroupDnssece2EParamsQueryType = "CDS"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeCERT DNSTimeseriesGroupDnssece2EParamsQueryType = "CERT"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeCNAME DNSTimeseriesGroupDnssece2EParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeCsync DNSTimeseriesGroupDnssece2EParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeDhcid DNSTimeseriesGroupDnssece2EParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeDlv DNSTimeseriesGroupDnssece2EParamsQueryType = "DLV"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeDname DNSTimeseriesGroupDnssece2EParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeDNSKEY DNSTimeseriesGroupDnssece2EParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeDoa DNSTimeseriesGroupDnssece2EParamsQueryType = "DOA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeDS DNSTimeseriesGroupDnssece2EParamsQueryType = "DS"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeEid DNSTimeseriesGroupDnssece2EParamsQueryType = "EID"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeEui48 DNSTimeseriesGroupDnssece2EParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeEui64 DNSTimeseriesGroupDnssece2EParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeGpos DNSTimeseriesGroupDnssece2EParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeGid DNSTimeseriesGroupDnssece2EParamsQueryType = "GID"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeHinfo DNSTimeseriesGroupDnssece2EParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeHip DNSTimeseriesGroupDnssece2EParamsQueryType = "HIP"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeHTTPS DNSTimeseriesGroupDnssece2EParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeIpseckey DNSTimeseriesGroupDnssece2EParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeIsdn DNSTimeseriesGroupDnssece2EParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeIxfr DNSTimeseriesGroupDnssece2EParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeKey DNSTimeseriesGroupDnssece2EParamsQueryType = "KEY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeKx DNSTimeseriesGroupDnssece2EParamsQueryType = "KX"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeL32 DNSTimeseriesGroupDnssece2EParamsQueryType = "L32"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeL64 DNSTimeseriesGroupDnssece2EParamsQueryType = "L64"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeLOC DNSTimeseriesGroupDnssece2EParamsQueryType = "LOC"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeLp DNSTimeseriesGroupDnssece2EParamsQueryType = "LP"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMaila DNSTimeseriesGroupDnssece2EParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMailb DNSTimeseriesGroupDnssece2EParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMB DNSTimeseriesGroupDnssece2EParamsQueryType = "MB"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMd DNSTimeseriesGroupDnssece2EParamsQueryType = "MD"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMf DNSTimeseriesGroupDnssece2EParamsQueryType = "MF"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMg DNSTimeseriesGroupDnssece2EParamsQueryType = "MG"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMinfo DNSTimeseriesGroupDnssece2EParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMr DNSTimeseriesGroupDnssece2EParamsQueryType = "MR"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeMX DNSTimeseriesGroupDnssece2EParamsQueryType = "MX"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNAPTR DNSTimeseriesGroupDnssece2EParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNb DNSTimeseriesGroupDnssece2EParamsQueryType = "NB"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNbstat DNSTimeseriesGroupDnssece2EParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNid DNSTimeseriesGroupDnssece2EParamsQueryType = "NID"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNimloc DNSTimeseriesGroupDnssece2EParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNinfo DNSTimeseriesGroupDnssece2EParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNS DNSTimeseriesGroupDnssece2EParamsQueryType = "NS"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNsap DNSTimeseriesGroupDnssece2EParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNsec DNSTimeseriesGroupDnssece2EParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNsec3 DNSTimeseriesGroupDnssece2EParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNsec3Param DNSTimeseriesGroupDnssece2EParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNull DNSTimeseriesGroupDnssece2EParamsQueryType = "NULL"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeNxt DNSTimeseriesGroupDnssece2EParamsQueryType = "NXT"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeOpenpgpkey DNSTimeseriesGroupDnssece2EParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeOpt DNSTimeseriesGroupDnssece2EParamsQueryType = "OPT"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypePTR DNSTimeseriesGroupDnssece2EParamsQueryType = "PTR"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypePx DNSTimeseriesGroupDnssece2EParamsQueryType = "PX"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeRkey DNSTimeseriesGroupDnssece2EParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeRp DNSTimeseriesGroupDnssece2EParamsQueryType = "RP"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeRrsig DNSTimeseriesGroupDnssece2EParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeRt DNSTimeseriesGroupDnssece2EParamsQueryType = "RT"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSig DNSTimeseriesGroupDnssece2EParamsQueryType = "SIG"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSink DNSTimeseriesGroupDnssece2EParamsQueryType = "SINK"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSMIMEA DNSTimeseriesGroupDnssece2EParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSOA DNSTimeseriesGroupDnssece2EParamsQueryType = "SOA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSPF DNSTimeseriesGroupDnssece2EParamsQueryType = "SPF"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSRV DNSTimeseriesGroupDnssece2EParamsQueryType = "SRV"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSSHFP DNSTimeseriesGroupDnssece2EParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeSVCB DNSTimeseriesGroupDnssece2EParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeTa DNSTimeseriesGroupDnssece2EParamsQueryType = "TA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeTalink DNSTimeseriesGroupDnssece2EParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeTkey DNSTimeseriesGroupDnssece2EParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeTLSA DNSTimeseriesGroupDnssece2EParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeTSIG DNSTimeseriesGroupDnssece2EParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeTXT DNSTimeseriesGroupDnssece2EParamsQueryType = "TXT"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeUinfo DNSTimeseriesGroupDnssece2EParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeUID DNSTimeseriesGroupDnssece2EParamsQueryType = "UID"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeUnspec DNSTimeseriesGroupDnssece2EParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeURI DNSTimeseriesGroupDnssece2EParamsQueryType = "URI"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeWks DNSTimeseriesGroupDnssece2EParamsQueryType = "WKS"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeX25 DNSTimeseriesGroupDnssece2EParamsQueryType = "X25"` - `const DNSTimeseriesGroupDnssece2EParamsQueryTypeZonemd DNSTimeseriesGroupDnssece2EParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesGroupDnssece2EParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeNoerror DNSTimeseriesGroupDnssece2EParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeFormerr DNSTimeseriesGroupDnssece2EParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeServfail DNSTimeseriesGroupDnssece2EParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeNxdomain DNSTimeseriesGroupDnssece2EParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeNotimp DNSTimeseriesGroupDnssece2EParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeRefused DNSTimeseriesGroupDnssece2EParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeYxdomain DNSTimeseriesGroupDnssece2EParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeYxrrset DNSTimeseriesGroupDnssece2EParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeNxrrset DNSTimeseriesGroupDnssece2EParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeNotauth DNSTimeseriesGroupDnssece2EParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeNotzone DNSTimeseriesGroupDnssece2EParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadsig DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadkey DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadtime DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadmode DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadname DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadalg DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadtrunc DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupDnssece2EParamsResponseCodeBadcookie DNSTimeseriesGroupDnssece2EParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupDnssece2EResponse struct{…}` - `Meta DNSTimeseriesGroupDnssece2EResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupDnssece2EResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupDnssece2EResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupDnssece2EResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupDnssece2EResponseMetaAggIntervalOneHour DNSTimeseriesGroupDnssece2EResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupDnssece2EResponseMetaAggIntervalOneDay DNSTimeseriesGroupDnssece2EResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupDnssece2EResponseMetaAggIntervalOneWeek DNSTimeseriesGroupDnssece2EResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupDnssece2EResponseMetaAggIntervalOneMonth DNSTimeseriesGroupDnssece2EResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupDnssece2EResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupDnssece2EResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupDnssece2EResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationPercentage DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationMin0Max DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationMinMax DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationRawValues DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationPercentageChange DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationRollingAverage DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupDnssece2EResponseMetaNormalizationRatio DNSTimeseriesGroupDnssece2EResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupDnssece2EResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupDnssece2EResponseSerie0` - `Negative []string` - `Positive []string` ### Example ```go 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.DNSSECE2E(context.TODO(), radar.DNSTimeseriesGroupDNSSECE2EParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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 } ``` ## Get DNS queries by IP version time series `client.Radar.DNS.TimeseriesGroups.IPVersion(ctx, query) (*DNSTimeseriesGroupIPVersionResponse, error)` **get** `/radar/dns/timeseries_groups/ip_version` Retrieves the distribution of DNS queries by IP version over time. ### Parameters - `query DNSTimeseriesGroupIPVersionParams` - `AggInterval param.Field[DNSTimeseriesGroupIPVersionParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupIPVersionParamsAggInterval15m DNSTimeseriesGroupIPVersionParamsAggInterval = "15m"` - `const DNSTimeseriesGroupIPVersionParamsAggInterval1h DNSTimeseriesGroupIPVersionParamsAggInterval = "1h"` - `const DNSTimeseriesGroupIPVersionParamsAggInterval1d DNSTimeseriesGroupIPVersionParamsAggInterval = "1d"` - `const DNSTimeseriesGroupIPVersionParamsAggInterval1w DNSTimeseriesGroupIPVersionParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupIPVersionParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupIPVersionParamsFormatJson DNSTimeseriesGroupIPVersionParamsFormat = "JSON"` - `const DNSTimeseriesGroupIPVersionParamsFormatCsv DNSTimeseriesGroupIPVersionParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupIPVersionParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupIPVersionParamsProtocolUdp DNSTimeseriesGroupIPVersionParamsProtocol = "UDP"` - `const DNSTimeseriesGroupIPVersionParamsProtocolTCP DNSTimeseriesGroupIPVersionParamsProtocol = "TCP"` - `const DNSTimeseriesGroupIPVersionParamsProtocolHTTPS DNSTimeseriesGroupIPVersionParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupIPVersionParamsProtocolTLS DNSTimeseriesGroupIPVersionParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesGroupIPVersionParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupIPVersionParamsQueryTypeA DNSTimeseriesGroupIPVersionParamsQueryType = "A"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeAAAA DNSTimeseriesGroupIPVersionParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeA6 DNSTimeseriesGroupIPVersionParamsQueryType = "A6"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeAfsdb DNSTimeseriesGroupIPVersionParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeAny DNSTimeseriesGroupIPVersionParamsQueryType = "ANY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeApl DNSTimeseriesGroupIPVersionParamsQueryType = "APL"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeAtma DNSTimeseriesGroupIPVersionParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeAXFR DNSTimeseriesGroupIPVersionParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeCAA DNSTimeseriesGroupIPVersionParamsQueryType = "CAA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeCdnskey DNSTimeseriesGroupIPVersionParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeCds DNSTimeseriesGroupIPVersionParamsQueryType = "CDS"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeCERT DNSTimeseriesGroupIPVersionParamsQueryType = "CERT"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeCNAME DNSTimeseriesGroupIPVersionParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeCsync DNSTimeseriesGroupIPVersionParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeDhcid DNSTimeseriesGroupIPVersionParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeDlv DNSTimeseriesGroupIPVersionParamsQueryType = "DLV"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeDname DNSTimeseriesGroupIPVersionParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeDNSKEY DNSTimeseriesGroupIPVersionParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeDoa DNSTimeseriesGroupIPVersionParamsQueryType = "DOA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeDS DNSTimeseriesGroupIPVersionParamsQueryType = "DS"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeEid DNSTimeseriesGroupIPVersionParamsQueryType = "EID"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeEui48 DNSTimeseriesGroupIPVersionParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeEui64 DNSTimeseriesGroupIPVersionParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeGpos DNSTimeseriesGroupIPVersionParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeGid DNSTimeseriesGroupIPVersionParamsQueryType = "GID"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeHinfo DNSTimeseriesGroupIPVersionParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeHip DNSTimeseriesGroupIPVersionParamsQueryType = "HIP"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeHTTPS DNSTimeseriesGroupIPVersionParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeIpseckey DNSTimeseriesGroupIPVersionParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeIsdn DNSTimeseriesGroupIPVersionParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeIxfr DNSTimeseriesGroupIPVersionParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeKey DNSTimeseriesGroupIPVersionParamsQueryType = "KEY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeKx DNSTimeseriesGroupIPVersionParamsQueryType = "KX"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeL32 DNSTimeseriesGroupIPVersionParamsQueryType = "L32"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeL64 DNSTimeseriesGroupIPVersionParamsQueryType = "L64"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeLOC DNSTimeseriesGroupIPVersionParamsQueryType = "LOC"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeLp DNSTimeseriesGroupIPVersionParamsQueryType = "LP"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMaila DNSTimeseriesGroupIPVersionParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMailb DNSTimeseriesGroupIPVersionParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMB DNSTimeseriesGroupIPVersionParamsQueryType = "MB"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMd DNSTimeseriesGroupIPVersionParamsQueryType = "MD"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMf DNSTimeseriesGroupIPVersionParamsQueryType = "MF"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMg DNSTimeseriesGroupIPVersionParamsQueryType = "MG"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMinfo DNSTimeseriesGroupIPVersionParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMr DNSTimeseriesGroupIPVersionParamsQueryType = "MR"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeMX DNSTimeseriesGroupIPVersionParamsQueryType = "MX"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNAPTR DNSTimeseriesGroupIPVersionParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNb DNSTimeseriesGroupIPVersionParamsQueryType = "NB"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNbstat DNSTimeseriesGroupIPVersionParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNid DNSTimeseriesGroupIPVersionParamsQueryType = "NID"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNimloc DNSTimeseriesGroupIPVersionParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNinfo DNSTimeseriesGroupIPVersionParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNS DNSTimeseriesGroupIPVersionParamsQueryType = "NS"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNsap DNSTimeseriesGroupIPVersionParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNsec DNSTimeseriesGroupIPVersionParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNsec3 DNSTimeseriesGroupIPVersionParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNsec3Param DNSTimeseriesGroupIPVersionParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNull DNSTimeseriesGroupIPVersionParamsQueryType = "NULL"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeNxt DNSTimeseriesGroupIPVersionParamsQueryType = "NXT"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeOpenpgpkey DNSTimeseriesGroupIPVersionParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeOpt DNSTimeseriesGroupIPVersionParamsQueryType = "OPT"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypePTR DNSTimeseriesGroupIPVersionParamsQueryType = "PTR"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypePx DNSTimeseriesGroupIPVersionParamsQueryType = "PX"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeRkey DNSTimeseriesGroupIPVersionParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeRp DNSTimeseriesGroupIPVersionParamsQueryType = "RP"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeRrsig DNSTimeseriesGroupIPVersionParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeRt DNSTimeseriesGroupIPVersionParamsQueryType = "RT"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSig DNSTimeseriesGroupIPVersionParamsQueryType = "SIG"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSink DNSTimeseriesGroupIPVersionParamsQueryType = "SINK"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSMIMEA DNSTimeseriesGroupIPVersionParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSOA DNSTimeseriesGroupIPVersionParamsQueryType = "SOA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSPF DNSTimeseriesGroupIPVersionParamsQueryType = "SPF"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSRV DNSTimeseriesGroupIPVersionParamsQueryType = "SRV"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSSHFP DNSTimeseriesGroupIPVersionParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeSVCB DNSTimeseriesGroupIPVersionParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeTa DNSTimeseriesGroupIPVersionParamsQueryType = "TA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeTalink DNSTimeseriesGroupIPVersionParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeTkey DNSTimeseriesGroupIPVersionParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeTLSA DNSTimeseriesGroupIPVersionParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeTSIG DNSTimeseriesGroupIPVersionParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeTXT DNSTimeseriesGroupIPVersionParamsQueryType = "TXT"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeUinfo DNSTimeseriesGroupIPVersionParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeUID DNSTimeseriesGroupIPVersionParamsQueryType = "UID"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeUnspec DNSTimeseriesGroupIPVersionParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeURI DNSTimeseriesGroupIPVersionParamsQueryType = "URI"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeWks DNSTimeseriesGroupIPVersionParamsQueryType = "WKS"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeX25 DNSTimeseriesGroupIPVersionParamsQueryType = "X25"` - `const DNSTimeseriesGroupIPVersionParamsQueryTypeZonemd DNSTimeseriesGroupIPVersionParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesGroupIPVersionParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupIPVersionParamsResponseCodeNoerror DNSTimeseriesGroupIPVersionParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeFormerr DNSTimeseriesGroupIPVersionParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeServfail DNSTimeseriesGroupIPVersionParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeNxdomain DNSTimeseriesGroupIPVersionParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeNotimp DNSTimeseriesGroupIPVersionParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeRefused DNSTimeseriesGroupIPVersionParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeYxdomain DNSTimeseriesGroupIPVersionParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeYxrrset DNSTimeseriesGroupIPVersionParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeNxrrset DNSTimeseriesGroupIPVersionParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeNotauth DNSTimeseriesGroupIPVersionParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeNotzone DNSTimeseriesGroupIPVersionParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadsig DNSTimeseriesGroupIPVersionParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadkey DNSTimeseriesGroupIPVersionParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadtime DNSTimeseriesGroupIPVersionParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadmode DNSTimeseriesGroupIPVersionParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadname DNSTimeseriesGroupIPVersionParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadalg DNSTimeseriesGroupIPVersionParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadtrunc DNSTimeseriesGroupIPVersionParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupIPVersionParamsResponseCodeBadcookie DNSTimeseriesGroupIPVersionParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupIPVersionResponse struct{…}` - `Meta DNSTimeseriesGroupIPVersionResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupIPVersionResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupIPVersionResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupIPVersionResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupIPVersionResponseMetaAggIntervalOneHour DNSTimeseriesGroupIPVersionResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupIPVersionResponseMetaAggIntervalOneDay DNSTimeseriesGroupIPVersionResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupIPVersionResponseMetaAggIntervalOneWeek DNSTimeseriesGroupIPVersionResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupIPVersionResponseMetaAggIntervalOneMonth DNSTimeseriesGroupIPVersionResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupIPVersionResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupIPVersionResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationPercentage DNSTimeseriesGroupIPVersionResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationMin0Max DNSTimeseriesGroupIPVersionResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationMinMax DNSTimeseriesGroupIPVersionResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationRawValues DNSTimeseriesGroupIPVersionResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationPercentageChange DNSTimeseriesGroupIPVersionResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationRollingAverage DNSTimeseriesGroupIPVersionResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupIPVersionResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupIPVersionResponseMetaNormalizationRatio DNSTimeseriesGroupIPVersionResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupIPVersionResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupIPVersionResponseSerie0` - `IPv4 []string` - `IPv6 []string` ### Example ```go 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.IPVersion(context.TODO(), radar.DNSTimeseriesGroupIPVersionParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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": { "IPv4": [ "10" ], "IPv6": [ "10" ] } }, "success": true } ``` ## Get DNS queries by matching answer time series `client.Radar.DNS.TimeseriesGroups.MatchingAnswer(ctx, query) (*DNSTimeseriesGroupMatchingAnswerResponse, error)` **get** `/radar/dns/timeseries_groups/matching_answer` Retrieves the distribution of DNS queries by matching answers over time. ### Parameters - `query DNSTimeseriesGroupMatchingAnswerParams` - `AggInterval param.Field[DNSTimeseriesGroupMatchingAnswerParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupMatchingAnswerParamsAggInterval15m DNSTimeseriesGroupMatchingAnswerParamsAggInterval = "15m"` - `const DNSTimeseriesGroupMatchingAnswerParamsAggInterval1h DNSTimeseriesGroupMatchingAnswerParamsAggInterval = "1h"` - `const DNSTimeseriesGroupMatchingAnswerParamsAggInterval1d DNSTimeseriesGroupMatchingAnswerParamsAggInterval = "1d"` - `const DNSTimeseriesGroupMatchingAnswerParamsAggInterval1w DNSTimeseriesGroupMatchingAnswerParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupMatchingAnswerParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupMatchingAnswerParamsFormatJson DNSTimeseriesGroupMatchingAnswerParamsFormat = "JSON"` - `const DNSTimeseriesGroupMatchingAnswerParamsFormatCsv DNSTimeseriesGroupMatchingAnswerParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupMatchingAnswerParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupMatchingAnswerParamsProtocolUdp DNSTimeseriesGroupMatchingAnswerParamsProtocol = "UDP"` - `const DNSTimeseriesGroupMatchingAnswerParamsProtocolTCP DNSTimeseriesGroupMatchingAnswerParamsProtocol = "TCP"` - `const DNSTimeseriesGroupMatchingAnswerParamsProtocolHTTPS DNSTimeseriesGroupMatchingAnswerParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupMatchingAnswerParamsProtocolTLS DNSTimeseriesGroupMatchingAnswerParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesGroupMatchingAnswerParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeA DNSTimeseriesGroupMatchingAnswerParamsQueryType = "A"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeAAAA DNSTimeseriesGroupMatchingAnswerParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeA6 DNSTimeseriesGroupMatchingAnswerParamsQueryType = "A6"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeAfsdb DNSTimeseriesGroupMatchingAnswerParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeAny DNSTimeseriesGroupMatchingAnswerParamsQueryType = "ANY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeApl DNSTimeseriesGroupMatchingAnswerParamsQueryType = "APL"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeAtma DNSTimeseriesGroupMatchingAnswerParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeAXFR DNSTimeseriesGroupMatchingAnswerParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeCAA DNSTimeseriesGroupMatchingAnswerParamsQueryType = "CAA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeCdnskey DNSTimeseriesGroupMatchingAnswerParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeCds DNSTimeseriesGroupMatchingAnswerParamsQueryType = "CDS"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeCERT DNSTimeseriesGroupMatchingAnswerParamsQueryType = "CERT"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeCNAME DNSTimeseriesGroupMatchingAnswerParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeCsync DNSTimeseriesGroupMatchingAnswerParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeDhcid DNSTimeseriesGroupMatchingAnswerParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeDlv DNSTimeseriesGroupMatchingAnswerParamsQueryType = "DLV"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeDname DNSTimeseriesGroupMatchingAnswerParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeDNSKEY DNSTimeseriesGroupMatchingAnswerParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeDoa DNSTimeseriesGroupMatchingAnswerParamsQueryType = "DOA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeDS DNSTimeseriesGroupMatchingAnswerParamsQueryType = "DS"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeEid DNSTimeseriesGroupMatchingAnswerParamsQueryType = "EID"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeEui48 DNSTimeseriesGroupMatchingAnswerParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeEui64 DNSTimeseriesGroupMatchingAnswerParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeGpos DNSTimeseriesGroupMatchingAnswerParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeGid DNSTimeseriesGroupMatchingAnswerParamsQueryType = "GID"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeHinfo DNSTimeseriesGroupMatchingAnswerParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeHip DNSTimeseriesGroupMatchingAnswerParamsQueryType = "HIP"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeHTTPS DNSTimeseriesGroupMatchingAnswerParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeIpseckey DNSTimeseriesGroupMatchingAnswerParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeIsdn DNSTimeseriesGroupMatchingAnswerParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeIxfr DNSTimeseriesGroupMatchingAnswerParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeKey DNSTimeseriesGroupMatchingAnswerParamsQueryType = "KEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeKx DNSTimeseriesGroupMatchingAnswerParamsQueryType = "KX"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeL32 DNSTimeseriesGroupMatchingAnswerParamsQueryType = "L32"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeL64 DNSTimeseriesGroupMatchingAnswerParamsQueryType = "L64"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeLOC DNSTimeseriesGroupMatchingAnswerParamsQueryType = "LOC"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeLp DNSTimeseriesGroupMatchingAnswerParamsQueryType = "LP"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMaila DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMailb DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMB DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MB"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMd DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MD"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMf DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MF"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMg DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MG"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMinfo DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMr DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MR"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeMX DNSTimeseriesGroupMatchingAnswerParamsQueryType = "MX"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNAPTR DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNb DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NB"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNbstat DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNid DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NID"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNimloc DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNinfo DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNS DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NS"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNsap DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNsec DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNsec3 DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNsec3Param DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNull DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NULL"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeNxt DNSTimeseriesGroupMatchingAnswerParamsQueryType = "NXT"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeOpenpgpkey DNSTimeseriesGroupMatchingAnswerParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeOpt DNSTimeseriesGroupMatchingAnswerParamsQueryType = "OPT"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypePTR DNSTimeseriesGroupMatchingAnswerParamsQueryType = "PTR"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypePx DNSTimeseriesGroupMatchingAnswerParamsQueryType = "PX"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeRkey DNSTimeseriesGroupMatchingAnswerParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeRp DNSTimeseriesGroupMatchingAnswerParamsQueryType = "RP"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeRrsig DNSTimeseriesGroupMatchingAnswerParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeRt DNSTimeseriesGroupMatchingAnswerParamsQueryType = "RT"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSig DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SIG"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSink DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SINK"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSMIMEA DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSOA DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SOA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSPF DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SPF"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSRV DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SRV"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSSHFP DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeSVCB DNSTimeseriesGroupMatchingAnswerParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeTa DNSTimeseriesGroupMatchingAnswerParamsQueryType = "TA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeTalink DNSTimeseriesGroupMatchingAnswerParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeTkey DNSTimeseriesGroupMatchingAnswerParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeTLSA DNSTimeseriesGroupMatchingAnswerParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeTSIG DNSTimeseriesGroupMatchingAnswerParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeTXT DNSTimeseriesGroupMatchingAnswerParamsQueryType = "TXT"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeUinfo DNSTimeseriesGroupMatchingAnswerParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeUID DNSTimeseriesGroupMatchingAnswerParamsQueryType = "UID"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeUnspec DNSTimeseriesGroupMatchingAnswerParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeURI DNSTimeseriesGroupMatchingAnswerParamsQueryType = "URI"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeWks DNSTimeseriesGroupMatchingAnswerParamsQueryType = "WKS"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeX25 DNSTimeseriesGroupMatchingAnswerParamsQueryType = "X25"` - `const DNSTimeseriesGroupMatchingAnswerParamsQueryTypeZonemd DNSTimeseriesGroupMatchingAnswerParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesGroupMatchingAnswerParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeNoerror DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeFormerr DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeServfail DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeNxdomain DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeNotimp DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeRefused DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeYxdomain DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeYxrrset DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeNxrrset DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeNotauth DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeNotzone DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadsig DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadkey DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadtime DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadmode DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadname DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadalg DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadtrunc DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupMatchingAnswerParamsResponseCodeBadcookie DNSTimeseriesGroupMatchingAnswerParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupMatchingAnswerResponse struct{…}` - `Meta DNSTimeseriesGroupMatchingAnswerResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupMatchingAnswerResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupMatchingAnswerResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupMatchingAnswerResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaAggIntervalOneHour DNSTimeseriesGroupMatchingAnswerResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaAggIntervalOneDay DNSTimeseriesGroupMatchingAnswerResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaAggIntervalOneWeek DNSTimeseriesGroupMatchingAnswerResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaAggIntervalOneMonth DNSTimeseriesGroupMatchingAnswerResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupMatchingAnswerResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupMatchingAnswerResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationPercentage DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationMin0Max DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationMinMax DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationRawValues DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationPercentageChange DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationRollingAverage DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupMatchingAnswerResponseMetaNormalizationRatio DNSTimeseriesGroupMatchingAnswerResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupMatchingAnswerResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupMatchingAnswerResponseSerie0` - `Negative []string` - `Positive []string` ### Example ```go 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.MatchingAnswer(context.TODO(), radar.DNSTimeseriesGroupMatchingAnswerParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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 } ``` ## Get DNS queries by protocol time series `client.Radar.DNS.TimeseriesGroups.Protocol(ctx, query) (*DNSTimeseriesGroupProtocolResponse, error)` **get** `/radar/dns/timeseries_groups/protocol` Retrieves the distribution of DNS queries by DNS transport protocol over time. ### Parameters - `query DNSTimeseriesGroupProtocolParams` - `AggInterval param.Field[DNSTimeseriesGroupProtocolParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupProtocolParamsAggInterval15m DNSTimeseriesGroupProtocolParamsAggInterval = "15m"` - `const DNSTimeseriesGroupProtocolParamsAggInterval1h DNSTimeseriesGroupProtocolParamsAggInterval = "1h"` - `const DNSTimeseriesGroupProtocolParamsAggInterval1d DNSTimeseriesGroupProtocolParamsAggInterval = "1d"` - `const DNSTimeseriesGroupProtocolParamsAggInterval1w DNSTimeseriesGroupProtocolParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupProtocolParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupProtocolParamsFormatJson DNSTimeseriesGroupProtocolParamsFormat = "JSON"` - `const DNSTimeseriesGroupProtocolParamsFormatCsv DNSTimeseriesGroupProtocolParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `QueryType param.Field[[]DNSTimeseriesGroupProtocolParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupProtocolParamsQueryTypeA DNSTimeseriesGroupProtocolParamsQueryType = "A"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeAAAA DNSTimeseriesGroupProtocolParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeA6 DNSTimeseriesGroupProtocolParamsQueryType = "A6"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeAfsdb DNSTimeseriesGroupProtocolParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeAny DNSTimeseriesGroupProtocolParamsQueryType = "ANY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeApl DNSTimeseriesGroupProtocolParamsQueryType = "APL"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeAtma DNSTimeseriesGroupProtocolParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeAXFR DNSTimeseriesGroupProtocolParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeCAA DNSTimeseriesGroupProtocolParamsQueryType = "CAA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeCdnskey DNSTimeseriesGroupProtocolParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeCds DNSTimeseriesGroupProtocolParamsQueryType = "CDS"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeCERT DNSTimeseriesGroupProtocolParamsQueryType = "CERT"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeCNAME DNSTimeseriesGroupProtocolParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeCsync DNSTimeseriesGroupProtocolParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeDhcid DNSTimeseriesGroupProtocolParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeDlv DNSTimeseriesGroupProtocolParamsQueryType = "DLV"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeDname DNSTimeseriesGroupProtocolParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeDNSKEY DNSTimeseriesGroupProtocolParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeDoa DNSTimeseriesGroupProtocolParamsQueryType = "DOA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeDS DNSTimeseriesGroupProtocolParamsQueryType = "DS"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeEid DNSTimeseriesGroupProtocolParamsQueryType = "EID"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeEui48 DNSTimeseriesGroupProtocolParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeEui64 DNSTimeseriesGroupProtocolParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeGpos DNSTimeseriesGroupProtocolParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeGid DNSTimeseriesGroupProtocolParamsQueryType = "GID"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeHinfo DNSTimeseriesGroupProtocolParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeHip DNSTimeseriesGroupProtocolParamsQueryType = "HIP"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeHTTPS DNSTimeseriesGroupProtocolParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeIpseckey DNSTimeseriesGroupProtocolParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeIsdn DNSTimeseriesGroupProtocolParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeIxfr DNSTimeseriesGroupProtocolParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeKey DNSTimeseriesGroupProtocolParamsQueryType = "KEY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeKx DNSTimeseriesGroupProtocolParamsQueryType = "KX"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeL32 DNSTimeseriesGroupProtocolParamsQueryType = "L32"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeL64 DNSTimeseriesGroupProtocolParamsQueryType = "L64"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeLOC DNSTimeseriesGroupProtocolParamsQueryType = "LOC"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeLp DNSTimeseriesGroupProtocolParamsQueryType = "LP"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMaila DNSTimeseriesGroupProtocolParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMailb DNSTimeseriesGroupProtocolParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMB DNSTimeseriesGroupProtocolParamsQueryType = "MB"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMd DNSTimeseriesGroupProtocolParamsQueryType = "MD"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMf DNSTimeseriesGroupProtocolParamsQueryType = "MF"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMg DNSTimeseriesGroupProtocolParamsQueryType = "MG"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMinfo DNSTimeseriesGroupProtocolParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMr DNSTimeseriesGroupProtocolParamsQueryType = "MR"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeMX DNSTimeseriesGroupProtocolParamsQueryType = "MX"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNAPTR DNSTimeseriesGroupProtocolParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNb DNSTimeseriesGroupProtocolParamsQueryType = "NB"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNbstat DNSTimeseriesGroupProtocolParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNid DNSTimeseriesGroupProtocolParamsQueryType = "NID"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNimloc DNSTimeseriesGroupProtocolParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNinfo DNSTimeseriesGroupProtocolParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNS DNSTimeseriesGroupProtocolParamsQueryType = "NS"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNsap DNSTimeseriesGroupProtocolParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNsec DNSTimeseriesGroupProtocolParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNsec3 DNSTimeseriesGroupProtocolParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNsec3Param DNSTimeseriesGroupProtocolParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNull DNSTimeseriesGroupProtocolParamsQueryType = "NULL"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeNxt DNSTimeseriesGroupProtocolParamsQueryType = "NXT"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeOpenpgpkey DNSTimeseriesGroupProtocolParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeOpt DNSTimeseriesGroupProtocolParamsQueryType = "OPT"` - `const DNSTimeseriesGroupProtocolParamsQueryTypePTR DNSTimeseriesGroupProtocolParamsQueryType = "PTR"` - `const DNSTimeseriesGroupProtocolParamsQueryTypePx DNSTimeseriesGroupProtocolParamsQueryType = "PX"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeRkey DNSTimeseriesGroupProtocolParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeRp DNSTimeseriesGroupProtocolParamsQueryType = "RP"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeRrsig DNSTimeseriesGroupProtocolParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeRt DNSTimeseriesGroupProtocolParamsQueryType = "RT"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSig DNSTimeseriesGroupProtocolParamsQueryType = "SIG"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSink DNSTimeseriesGroupProtocolParamsQueryType = "SINK"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSMIMEA DNSTimeseriesGroupProtocolParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSOA DNSTimeseriesGroupProtocolParamsQueryType = "SOA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSPF DNSTimeseriesGroupProtocolParamsQueryType = "SPF"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSRV DNSTimeseriesGroupProtocolParamsQueryType = "SRV"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSSHFP DNSTimeseriesGroupProtocolParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeSVCB DNSTimeseriesGroupProtocolParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeTa DNSTimeseriesGroupProtocolParamsQueryType = "TA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeTalink DNSTimeseriesGroupProtocolParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeTkey DNSTimeseriesGroupProtocolParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeTLSA DNSTimeseriesGroupProtocolParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeTSIG DNSTimeseriesGroupProtocolParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeTXT DNSTimeseriesGroupProtocolParamsQueryType = "TXT"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeUinfo DNSTimeseriesGroupProtocolParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeUID DNSTimeseriesGroupProtocolParamsQueryType = "UID"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeUnspec DNSTimeseriesGroupProtocolParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeURI DNSTimeseriesGroupProtocolParamsQueryType = "URI"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeWks DNSTimeseriesGroupProtocolParamsQueryType = "WKS"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeX25 DNSTimeseriesGroupProtocolParamsQueryType = "X25"` - `const DNSTimeseriesGroupProtocolParamsQueryTypeZonemd DNSTimeseriesGroupProtocolParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesGroupProtocolParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupProtocolParamsResponseCodeNoerror DNSTimeseriesGroupProtocolParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeFormerr DNSTimeseriesGroupProtocolParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeServfail DNSTimeseriesGroupProtocolParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeNxdomain DNSTimeseriesGroupProtocolParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeNotimp DNSTimeseriesGroupProtocolParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeRefused DNSTimeseriesGroupProtocolParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeYxdomain DNSTimeseriesGroupProtocolParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeYxrrset DNSTimeseriesGroupProtocolParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeNxrrset DNSTimeseriesGroupProtocolParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeNotauth DNSTimeseriesGroupProtocolParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeNotzone DNSTimeseriesGroupProtocolParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadsig DNSTimeseriesGroupProtocolParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadkey DNSTimeseriesGroupProtocolParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadtime DNSTimeseriesGroupProtocolParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadmode DNSTimeseriesGroupProtocolParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadname DNSTimeseriesGroupProtocolParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadalg DNSTimeseriesGroupProtocolParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadtrunc DNSTimeseriesGroupProtocolParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupProtocolParamsResponseCodeBadcookie DNSTimeseriesGroupProtocolParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupProtocolResponse struct{…}` - `Meta DNSTimeseriesGroupProtocolResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupProtocolResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupProtocolResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupProtocolResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupProtocolResponseMetaAggIntervalOneHour DNSTimeseriesGroupProtocolResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupProtocolResponseMetaAggIntervalOneDay DNSTimeseriesGroupProtocolResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupProtocolResponseMetaAggIntervalOneWeek DNSTimeseriesGroupProtocolResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupProtocolResponseMetaAggIntervalOneMonth DNSTimeseriesGroupProtocolResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupProtocolResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupProtocolResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupProtocolResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupProtocolResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationPercentage DNSTimeseriesGroupProtocolResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationMin0Max DNSTimeseriesGroupProtocolResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationMinMax DNSTimeseriesGroupProtocolResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationRawValues DNSTimeseriesGroupProtocolResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationPercentageChange DNSTimeseriesGroupProtocolResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationRollingAverage DNSTimeseriesGroupProtocolResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupProtocolResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupProtocolResponseMetaNormalizationRatio DNSTimeseriesGroupProtocolResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupProtocolResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupProtocolResponseSerie0` - `HTTPS []string` - `TCP []string` - `TLS []string` - `Udp []string` ### Example ```go 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.Protocol(context.TODO(), radar.DNSTimeseriesGroupProtocolParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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": { "HTTPS": [ "10" ], "TCP": [ "10" ], "TLS": [ "10" ], "UDP": [ "10" ] } }, "success": true } ``` ## Get DNS queries by type time series `client.Radar.DNS.TimeseriesGroups.QueryType(ctx, query) (*DNSTimeseriesGroupQueryTypeResponse, error)` **get** `/radar/dns/timeseries_groups/query_type` Retrieves the distribution of DNS queries by type over time. ### Parameters - `query DNSTimeseriesGroupQueryTypeParams` - `AggInterval param.Field[DNSTimeseriesGroupQueryTypeParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupQueryTypeParamsAggInterval15m DNSTimeseriesGroupQueryTypeParamsAggInterval = "15m"` - `const DNSTimeseriesGroupQueryTypeParamsAggInterval1h DNSTimeseriesGroupQueryTypeParamsAggInterval = "1h"` - `const DNSTimeseriesGroupQueryTypeParamsAggInterval1d DNSTimeseriesGroupQueryTypeParamsAggInterval = "1d"` - `const DNSTimeseriesGroupQueryTypeParamsAggInterval1w DNSTimeseriesGroupQueryTypeParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupQueryTypeParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupQueryTypeParamsFormatJson DNSTimeseriesGroupQueryTypeParamsFormat = "JSON"` - `const DNSTimeseriesGroupQueryTypeParamsFormatCsv DNSTimeseriesGroupQueryTypeParamsFormat = "CSV"` - `LimitPerGroup param.Field[int64]` Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category. Only supported on high-cardinality dimensions; otherwise the request is rejected. Minimum value is 2. - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupQueryTypeParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupQueryTypeParamsProtocolUdp DNSTimeseriesGroupQueryTypeParamsProtocol = "UDP"` - `const DNSTimeseriesGroupQueryTypeParamsProtocolTCP DNSTimeseriesGroupQueryTypeParamsProtocol = "TCP"` - `const DNSTimeseriesGroupQueryTypeParamsProtocolHTTPS DNSTimeseriesGroupQueryTypeParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupQueryTypeParamsProtocolTLS DNSTimeseriesGroupQueryTypeParamsProtocol = "TLS"` - `ResponseCode param.Field[[]DNSTimeseriesGroupQueryTypeParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeNoerror DNSTimeseriesGroupQueryTypeParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeFormerr DNSTimeseriesGroupQueryTypeParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeServfail DNSTimeseriesGroupQueryTypeParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeNxdomain DNSTimeseriesGroupQueryTypeParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeNotimp DNSTimeseriesGroupQueryTypeParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeRefused DNSTimeseriesGroupQueryTypeParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeYxdomain DNSTimeseriesGroupQueryTypeParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeYxrrset DNSTimeseriesGroupQueryTypeParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeNxrrset DNSTimeseriesGroupQueryTypeParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeNotauth DNSTimeseriesGroupQueryTypeParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeNotzone DNSTimeseriesGroupQueryTypeParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadsig DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadkey DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadtime DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadmode DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadname DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadalg DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadtrunc DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupQueryTypeParamsResponseCodeBadcookie DNSTimeseriesGroupQueryTypeParamsResponseCode = "BADCOOKIE"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupQueryTypeResponse struct{…}` - `Meta DNSTimeseriesGroupQueryTypeResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupQueryTypeResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupQueryTypeResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupQueryTypeResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupQueryTypeResponseMetaAggIntervalOneHour DNSTimeseriesGroupQueryTypeResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupQueryTypeResponseMetaAggIntervalOneDay DNSTimeseriesGroupQueryTypeResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupQueryTypeResponseMetaAggIntervalOneWeek DNSTimeseriesGroupQueryTypeResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupQueryTypeResponseMetaAggIntervalOneMonth DNSTimeseriesGroupQueryTypeResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupQueryTypeResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupQueryTypeResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupQueryTypeResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationPercentage DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationMin0Max DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationMinMax DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationRawValues DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationPercentageChange DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationRollingAverage DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupQueryTypeResponseMetaNormalizationRatio DNSTimeseriesGroupQueryTypeResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupQueryTypeResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupQueryTypeResponseSerie0` - `Timestamps []Time` ### Example ```go 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.QueryType(context.TODO(), radar.DNSTimeseriesGroupQueryTypeParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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": { "timestamps": [ "2023-08-08T10:15:00Z" ] } }, "success": true } ``` ## Get DNS queries by response code time series `client.Radar.DNS.TimeseriesGroups.ResponseCode(ctx, query) (*DNSTimeseriesGroupResponseCodeResponse, error)` **get** `/radar/dns/timeseries_groups/response_code` Retrieves the distribution of DNS queries by response code over time. ### Parameters - `query DNSTimeseriesGroupResponseCodeParams` - `AggInterval param.Field[DNSTimeseriesGroupResponseCodeParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupResponseCodeParamsAggInterval15m DNSTimeseriesGroupResponseCodeParamsAggInterval = "15m"` - `const DNSTimeseriesGroupResponseCodeParamsAggInterval1h DNSTimeseriesGroupResponseCodeParamsAggInterval = "1h"` - `const DNSTimeseriesGroupResponseCodeParamsAggInterval1d DNSTimeseriesGroupResponseCodeParamsAggInterval = "1d"` - `const DNSTimeseriesGroupResponseCodeParamsAggInterval1w DNSTimeseriesGroupResponseCodeParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupResponseCodeParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupResponseCodeParamsFormatJson DNSTimeseriesGroupResponseCodeParamsFormat = "JSON"` - `const DNSTimeseriesGroupResponseCodeParamsFormatCsv DNSTimeseriesGroupResponseCodeParamsFormat = "CSV"` - `LimitPerGroup param.Field[int64]` Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category. Only supported on high-cardinality dimensions; otherwise the request is rejected. Minimum value is 2. - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupResponseCodeParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupResponseCodeParamsProtocolUdp DNSTimeseriesGroupResponseCodeParamsProtocol = "UDP"` - `const DNSTimeseriesGroupResponseCodeParamsProtocolTCP DNSTimeseriesGroupResponseCodeParamsProtocol = "TCP"` - `const DNSTimeseriesGroupResponseCodeParamsProtocolHTTPS DNSTimeseriesGroupResponseCodeParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupResponseCodeParamsProtocolTLS DNSTimeseriesGroupResponseCodeParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesGroupResponseCodeParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeA DNSTimeseriesGroupResponseCodeParamsQueryType = "A"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeAAAA DNSTimeseriesGroupResponseCodeParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeA6 DNSTimeseriesGroupResponseCodeParamsQueryType = "A6"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeAfsdb DNSTimeseriesGroupResponseCodeParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeAny DNSTimeseriesGroupResponseCodeParamsQueryType = "ANY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeApl DNSTimeseriesGroupResponseCodeParamsQueryType = "APL"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeAtma DNSTimeseriesGroupResponseCodeParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeAXFR DNSTimeseriesGroupResponseCodeParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeCAA DNSTimeseriesGroupResponseCodeParamsQueryType = "CAA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeCdnskey DNSTimeseriesGroupResponseCodeParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeCds DNSTimeseriesGroupResponseCodeParamsQueryType = "CDS"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeCERT DNSTimeseriesGroupResponseCodeParamsQueryType = "CERT"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeCNAME DNSTimeseriesGroupResponseCodeParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeCsync DNSTimeseriesGroupResponseCodeParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeDhcid DNSTimeseriesGroupResponseCodeParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeDlv DNSTimeseriesGroupResponseCodeParamsQueryType = "DLV"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeDname DNSTimeseriesGroupResponseCodeParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeDNSKEY DNSTimeseriesGroupResponseCodeParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeDoa DNSTimeseriesGroupResponseCodeParamsQueryType = "DOA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeDS DNSTimeseriesGroupResponseCodeParamsQueryType = "DS"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeEid DNSTimeseriesGroupResponseCodeParamsQueryType = "EID"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeEui48 DNSTimeseriesGroupResponseCodeParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeEui64 DNSTimeseriesGroupResponseCodeParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeGpos DNSTimeseriesGroupResponseCodeParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeGid DNSTimeseriesGroupResponseCodeParamsQueryType = "GID"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeHinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeHip DNSTimeseriesGroupResponseCodeParamsQueryType = "HIP"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeHTTPS DNSTimeseriesGroupResponseCodeParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeIpseckey DNSTimeseriesGroupResponseCodeParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeIsdn DNSTimeseriesGroupResponseCodeParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeIxfr DNSTimeseriesGroupResponseCodeParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeKey DNSTimeseriesGroupResponseCodeParamsQueryType = "KEY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeKx DNSTimeseriesGroupResponseCodeParamsQueryType = "KX"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeL32 DNSTimeseriesGroupResponseCodeParamsQueryType = "L32"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeL64 DNSTimeseriesGroupResponseCodeParamsQueryType = "L64"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeLOC DNSTimeseriesGroupResponseCodeParamsQueryType = "LOC"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeLp DNSTimeseriesGroupResponseCodeParamsQueryType = "LP"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMaila DNSTimeseriesGroupResponseCodeParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMailb DNSTimeseriesGroupResponseCodeParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMB DNSTimeseriesGroupResponseCodeParamsQueryType = "MB"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMd DNSTimeseriesGroupResponseCodeParamsQueryType = "MD"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMf DNSTimeseriesGroupResponseCodeParamsQueryType = "MF"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMg DNSTimeseriesGroupResponseCodeParamsQueryType = "MG"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMr DNSTimeseriesGroupResponseCodeParamsQueryType = "MR"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeMX DNSTimeseriesGroupResponseCodeParamsQueryType = "MX"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNAPTR DNSTimeseriesGroupResponseCodeParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNb DNSTimeseriesGroupResponseCodeParamsQueryType = "NB"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNbstat DNSTimeseriesGroupResponseCodeParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNid DNSTimeseriesGroupResponseCodeParamsQueryType = "NID"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNimloc DNSTimeseriesGroupResponseCodeParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNS DNSTimeseriesGroupResponseCodeParamsQueryType = "NS"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsap DNSTimeseriesGroupResponseCodeParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsec DNSTimeseriesGroupResponseCodeParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsec3 DNSTimeseriesGroupResponseCodeParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsec3Param DNSTimeseriesGroupResponseCodeParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNull DNSTimeseriesGroupResponseCodeParamsQueryType = "NULL"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeNxt DNSTimeseriesGroupResponseCodeParamsQueryType = "NXT"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeOpenpgpkey DNSTimeseriesGroupResponseCodeParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeOpt DNSTimeseriesGroupResponseCodeParamsQueryType = "OPT"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypePTR DNSTimeseriesGroupResponseCodeParamsQueryType = "PTR"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypePx DNSTimeseriesGroupResponseCodeParamsQueryType = "PX"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeRkey DNSTimeseriesGroupResponseCodeParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeRp DNSTimeseriesGroupResponseCodeParamsQueryType = "RP"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeRrsig DNSTimeseriesGroupResponseCodeParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeRt DNSTimeseriesGroupResponseCodeParamsQueryType = "RT"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSig DNSTimeseriesGroupResponseCodeParamsQueryType = "SIG"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSink DNSTimeseriesGroupResponseCodeParamsQueryType = "SINK"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSMIMEA DNSTimeseriesGroupResponseCodeParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSOA DNSTimeseriesGroupResponseCodeParamsQueryType = "SOA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSPF DNSTimeseriesGroupResponseCodeParamsQueryType = "SPF"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSRV DNSTimeseriesGroupResponseCodeParamsQueryType = "SRV"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSSHFP DNSTimeseriesGroupResponseCodeParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeSVCB DNSTimeseriesGroupResponseCodeParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeTa DNSTimeseriesGroupResponseCodeParamsQueryType = "TA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeTalink DNSTimeseriesGroupResponseCodeParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeTkey DNSTimeseriesGroupResponseCodeParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeTLSA DNSTimeseriesGroupResponseCodeParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeTSIG DNSTimeseriesGroupResponseCodeParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeTXT DNSTimeseriesGroupResponseCodeParamsQueryType = "TXT"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeUinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeUID DNSTimeseriesGroupResponseCodeParamsQueryType = "UID"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeUnspec DNSTimeseriesGroupResponseCodeParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeURI DNSTimeseriesGroupResponseCodeParamsQueryType = "URI"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeWks DNSTimeseriesGroupResponseCodeParamsQueryType = "WKS"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeX25 DNSTimeseriesGroupResponseCodeParamsQueryType = "X25"` - `const DNSTimeseriesGroupResponseCodeParamsQueryTypeZonemd DNSTimeseriesGroupResponseCodeParamsQueryType = "ZONEMD"` - `TLD param.Field[[]string]` 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`). ### Returns - `type DNSTimeseriesGroupResponseCodeResponse struct{…}` - `Meta DNSTimeseriesGroupResponseCodeResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupResponseCodeResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneHour DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneDay DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneWeek DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneMonth DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupResponseCodeResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupResponseCodeResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationPercentage DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationMin0Max DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationMinMax DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationRawValues DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationPercentageChange DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationRollingAverage DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationRatio DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupResponseCodeResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupResponseCodeResponseSerie0` - `Timestamps []Time` ### Example ```go 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.ResponseCode(context.TODO(), radar.DNSTimeseriesGroupResponseCodeParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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": { "timestamps": [ "2023-08-08T10:15:00Z" ] } }, "success": true } ``` ## Get DNS queries by response TTL time series `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. ### Parameters - `query DNSTimeseriesGroupResponseTTLParams` - `AggInterval param.Field[DNSTimeseriesGroupResponseTTLParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/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 DNSTimeseriesGroupResponseTTLParamsAggInterval15m DNSTimeseriesGroupResponseTTLParamsAggInterval = "15m"` - `const DNSTimeseriesGroupResponseTTLParamsAggInterval1h DNSTimeseriesGroupResponseTTLParamsAggInterval = "1h"` - `const DNSTimeseriesGroupResponseTTLParamsAggInterval1d DNSTimeseriesGroupResponseTTLParamsAggInterval = "1d"` - `const DNSTimeseriesGroupResponseTTLParamsAggInterval1w DNSTimeseriesGroupResponseTTLParamsAggInterval = "1w"` - `ASN param.Field[[]string]` 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]` 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]` 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]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `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]` 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[DNSTimeseriesGroupResponseTTLParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupResponseTTLParamsFormatJson DNSTimeseriesGroupResponseTTLParamsFormat = "JSON"` - `const DNSTimeseriesGroupResponseTTLParamsFormatCsv DNSTimeseriesGroupResponseTTLParamsFormat = "CSV"` - `Location param.Field[[]string]` 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]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Protocol param.Field[[]DNSTimeseriesGroupResponseTTLParamsProtocol]` 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]` 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]` 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]` 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`). ### Returns - `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](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `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. - `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` - `EventType DNSTimeseriesGroupResponseTTLResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `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` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupResponseTTLResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupResponseTTLResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `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` ### Example ```go 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.ResponseTTL(context.TODO(), radar.DNSTimeseriesGroupResponseTTLParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "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 } ```