API Reference

Radar

DNS

Timeseries Groups

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get DNS queries by IP version time series

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

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.

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 DNSTimeseriesGroupIPVersionParams

AggInterval param.Field[DNSTimeseriesGroupIPVersionParamsAggInterval]Optional

Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

const DNSTimeseriesGroupIPVersionParamsAggInterval15m DNSTimeseriesGroupIPVersionParamsAggInterval = "15m"

const DNSTimeseriesGroupIPVersionParamsAggInterval1h DNSTimeseriesGroupIPVersionParamsAggInterval = "1h"

const DNSTimeseriesGroupIPVersionParamsAggInterval1d DNSTimeseriesGroupIPVersionParamsAggInterval = "1d"

const DNSTimeseriesGroupIPVersionParamsAggInterval1w DNSTimeseriesGroupIPVersionParamsAggInterval = "1w"

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

Format in which results will be returned.

const DNSTimeseriesGroupIPVersionParamsFormatJson DNSTimeseriesGroupIPVersionParamsFormat = "JSON"

const DNSTimeseriesGroupIPVersionParamsFormatCsv DNSTimeseriesGroupIPVersionParamsFormat = "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[[]DNSTimeseriesGroupIPVersionParamsProtocol]Optional

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

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

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

Filters results by top-level domain.

ReturnsExpand Collapse

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.

One of the following:

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.

One of the following:

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

formatdate-time

EventType DNSTimeseriesGroupIPVersionResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

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

formaturi

StartDate Time

formatdate-time

Tags []stringOptional

Level int64

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

DateRange []DNSTimeseriesGroupIPVersionResponseMetaDateRange

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 DNSTimeseriesGroupIPVersionResponseMetaNormalization

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

One of the following:

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

Get DNS queries by IP version time series

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.TimeseriesGroups.IPVersion(context.TODO(), radar.DNSTimeseriesGroupIPVersionParams{

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

200 example

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

Returns Examples

200 example

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