# 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. - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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. - `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"` - `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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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://developers.cloudflare.com/radar/concepts/normalization/). - `const DNSTimeseriesGroupsV2ParamsNormalizationPercentage DNSTimeseriesGroupsV2ParamsNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupsV2ParamsNormalizationMin0Max DNSTimeseriesGroupsV2ParamsNormalization = "MIN0_MAX"` - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `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. ### 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://developers.cloudflare.com/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` - `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://developers.cloudflare.com/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" } ], "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 } ```