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.

Security

API Token

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

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

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

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

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

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

User Details WriteUser Details Read

ParametersExpand Collapse

query DNSSummaryCacheHitParams

ASN param.Field[[]string]Optional

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

Continent param.Field[[]string]Optional

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

DateEnd param.Field[[]Time]Optional

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

DateRange param.Field[[]string]Optional

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

DateStart param.Field[[]Time]Optional

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

Format param.Field[DNSSummaryCacheHitParamsFormat]Optional

Format in which results will be returned.

const DNSSummaryCacheHitParamsFormatJson DNSSummaryCacheHitParamsFormat = "JSON"

const DNSSummaryCacheHitParamsFormatCsv DNSSummaryCacheHitParamsFormat = "CSV"

Location param.Field[[]string]Optional

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

Name param.Field[[]string]Optional

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

Nodata param.Field[[]bool]Optional

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

Protocol param.Field[[]DNSSummaryCacheHitParamsProtocol]Optional

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]Optional

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]Optional

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]Optional

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

ReturnsExpand Collapse

type DNSSummaryCacheHitResponse struct{…}

Meta DNSSummaryCacheHitResponseMeta

Metadata for the results.

ConfidenceInfo DNSSummaryCacheHitResponseMetaConfidenceInfo

Annotations []DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotation

DataSource DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

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

formatdate-time

EventType DNSSummaryCacheHitResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

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

formaturi

StartDate Time

formatdate-time

Tags []stringOptional

Level int64

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

DateRange []DNSSummaryCacheHitResponseMetaDateRange

EndTime Time

Adjusted end of date range.

formatdate-time

StartTime Time

Adjusted start of date range.

formatdate-time

LastUpdated Time

Timestamp of the last dataset update.

formatdate-time

Normalization DNSSummaryCacheHitResponseMetaNormalization

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

One of the following:

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.

Get DNS queries by cache status summary

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)
}

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

Returns Examples

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