Get DNS queries by cache status summary

Deprecated

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

DateRange param.Field[[]string]optional

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

DateStart param.Field[[]Time]optional

Start of the date range.

Format param.Field[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.

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

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"
          }
        ],
        "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"
          }
        ],
        "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
}