API Reference

Radar

DNS

Summary

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get DNS queries by response TTL summary

Deprecated: Use [Radar DNS Summary By Dimension](https://developers.cloudflare.com/api/resources/radar/subresources/dns/methods/summary_v2/) instead.

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.

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 DNSSummaryResponseTTLParams

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

Format in which results will be returned.

const DNSSummaryResponseTTLParamsFormatJson DNSSummaryResponseTTLParamsFormat = "JSON"

const DNSSummaryResponseTTLParamsFormatCsv DNSSummaryResponseTTLParamsFormat = "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[[]DNSSummaryResponseTTLParamsProtocol]Optional

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

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

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

Filters results by top-level domain.

ReturnsExpand Collapse

type DNSSummaryResponseTTLResponse struct{…}

Meta DNSSummaryResponseTTLResponseMeta

Metadata for the results.

ConfidenceInfo DNSSummaryResponseTTLResponseMetaConfidenceInfo

Annotations []DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotation

DataSource DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

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

formatdate-time

EventType DNSSummaryResponseTTLResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

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

formaturi

StartDate Time

formatdate-time

Tags []stringOptional

Level int64

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

DateRange []DNSSummaryResponseTTLResponseMetaDateRange

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 DNSSummaryResponseTTLResponseMetaNormalization

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

One of the following:

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.

Get DNS queries by response TTL summary

Go

HTTP

TypeScript

Python

Go

Terraform

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/option"
  "github.com/stainless-sdks/cloudflare-go/radar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.Radar.DNS.Summary.ResponseTTL(context.TODO(), radar.DNSSummaryResponseTTLParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Meta)
}

200 example

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

Returns Examples

200 example

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