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 response code 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.ResponseCode(ctx, query) (*DNSTimeseriesGroupResponseCodeResponse, error)

GET/radar/dns/timeseries_groups/response_code

Retrieves the distribution of DNS queries by response code 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 DNSTimeseriesGroupResponseCodeParams

AggInterval param.Field[DNSTimeseriesGroupResponseCodeParamsAggInterval]Optional

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

const DNSTimeseriesGroupResponseCodeParamsAggInterval15m DNSTimeseriesGroupResponseCodeParamsAggInterval = "15m"

const DNSTimeseriesGroupResponseCodeParamsAggInterval1h DNSTimeseriesGroupResponseCodeParamsAggInterval = "1h"

const DNSTimeseriesGroupResponseCodeParamsAggInterval1d DNSTimeseriesGroupResponseCodeParamsAggInterval = "1d"

const DNSTimeseriesGroupResponseCodeParamsAggInterval1w DNSTimeseriesGroupResponseCodeParamsAggInterval = "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[DNSTimeseriesGroupResponseCodeParamsFormat]Optional

Format in which results will be returned.

const DNSTimeseriesGroupResponseCodeParamsFormatJson DNSTimeseriesGroupResponseCodeParamsFormat = "JSON"

const DNSTimeseriesGroupResponseCodeParamsFormatCsv DNSTimeseriesGroupResponseCodeParamsFormat = "CSV"

LimitPerGroup param.Field[int64]Optional

Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an “other” category.

Location param.Field[[]string]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[[]DNSTimeseriesGroupResponseCodeParamsProtocol]Optional

Filters results by DNS transport protocol.

const DNSTimeseriesGroupResponseCodeParamsProtocolUdp DNSTimeseriesGroupResponseCodeParamsProtocol = "UDP"

const DNSTimeseriesGroupResponseCodeParamsProtocolTCP DNSTimeseriesGroupResponseCodeParamsProtocol = "TCP"

const DNSTimeseriesGroupResponseCodeParamsProtocolHTTPS DNSTimeseriesGroupResponseCodeParamsProtocol = "HTTPS"

const DNSTimeseriesGroupResponseCodeParamsProtocolTLS DNSTimeseriesGroupResponseCodeParamsProtocol = "TLS"

QueryType param.Field[[]DNSTimeseriesGroupResponseCodeParamsQueryType]Optional

Filters results by DNS query type.

const DNSTimeseriesGroupResponseCodeParamsQueryTypeA DNSTimeseriesGroupResponseCodeParamsQueryType = "A"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeAAAA DNSTimeseriesGroupResponseCodeParamsQueryType = "AAAA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeA6 DNSTimeseriesGroupResponseCodeParamsQueryType = "A6"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeAfsdb DNSTimeseriesGroupResponseCodeParamsQueryType = "AFSDB"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeAny DNSTimeseriesGroupResponseCodeParamsQueryType = "ANY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeApl DNSTimeseriesGroupResponseCodeParamsQueryType = "APL"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeAtma DNSTimeseriesGroupResponseCodeParamsQueryType = "ATMA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeAXFR DNSTimeseriesGroupResponseCodeParamsQueryType = "AXFR"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeCAA DNSTimeseriesGroupResponseCodeParamsQueryType = "CAA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeCdnskey DNSTimeseriesGroupResponseCodeParamsQueryType = "CDNSKEY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeCds DNSTimeseriesGroupResponseCodeParamsQueryType = "CDS"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeCERT DNSTimeseriesGroupResponseCodeParamsQueryType = "CERT"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeCNAME DNSTimeseriesGroupResponseCodeParamsQueryType = "CNAME"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeCsync DNSTimeseriesGroupResponseCodeParamsQueryType = "CSYNC"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeDhcid DNSTimeseriesGroupResponseCodeParamsQueryType = "DHCID"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeDlv DNSTimeseriesGroupResponseCodeParamsQueryType = "DLV"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeDname DNSTimeseriesGroupResponseCodeParamsQueryType = "DNAME"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeDNSKEY DNSTimeseriesGroupResponseCodeParamsQueryType = "DNSKEY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeDoa DNSTimeseriesGroupResponseCodeParamsQueryType = "DOA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeDS DNSTimeseriesGroupResponseCodeParamsQueryType = "DS"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeEid DNSTimeseriesGroupResponseCodeParamsQueryType = "EID"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeEui48 DNSTimeseriesGroupResponseCodeParamsQueryType = "EUI48"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeEui64 DNSTimeseriesGroupResponseCodeParamsQueryType = "EUI64"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeGpos DNSTimeseriesGroupResponseCodeParamsQueryType = "GPOS"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeGid DNSTimeseriesGroupResponseCodeParamsQueryType = "GID"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeHinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "HINFO"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeHip DNSTimeseriesGroupResponseCodeParamsQueryType = "HIP"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeHTTPS DNSTimeseriesGroupResponseCodeParamsQueryType = "HTTPS"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeIpseckey DNSTimeseriesGroupResponseCodeParamsQueryType = "IPSECKEY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeIsdn DNSTimeseriesGroupResponseCodeParamsQueryType = "ISDN"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeIxfr DNSTimeseriesGroupResponseCodeParamsQueryType = "IXFR"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeKey DNSTimeseriesGroupResponseCodeParamsQueryType = "KEY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeKx DNSTimeseriesGroupResponseCodeParamsQueryType = "KX"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeL32 DNSTimeseriesGroupResponseCodeParamsQueryType = "L32"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeL64 DNSTimeseriesGroupResponseCodeParamsQueryType = "L64"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeLOC DNSTimeseriesGroupResponseCodeParamsQueryType = "LOC"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeLp DNSTimeseriesGroupResponseCodeParamsQueryType = "LP"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMaila DNSTimeseriesGroupResponseCodeParamsQueryType = "MAILA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMailb DNSTimeseriesGroupResponseCodeParamsQueryType = "MAILB"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMB DNSTimeseriesGroupResponseCodeParamsQueryType = "MB"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMd DNSTimeseriesGroupResponseCodeParamsQueryType = "MD"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMf DNSTimeseriesGroupResponseCodeParamsQueryType = "MF"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMg DNSTimeseriesGroupResponseCodeParamsQueryType = "MG"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "MINFO"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMr DNSTimeseriesGroupResponseCodeParamsQueryType = "MR"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeMX DNSTimeseriesGroupResponseCodeParamsQueryType = "MX"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNAPTR DNSTimeseriesGroupResponseCodeParamsQueryType = "NAPTR"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNb DNSTimeseriesGroupResponseCodeParamsQueryType = "NB"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNbstat DNSTimeseriesGroupResponseCodeParamsQueryType = "NBSTAT"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNid DNSTimeseriesGroupResponseCodeParamsQueryType = "NID"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNimloc DNSTimeseriesGroupResponseCodeParamsQueryType = "NIMLOC"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "NINFO"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNS DNSTimeseriesGroupResponseCodeParamsQueryType = "NS"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsap DNSTimeseriesGroupResponseCodeParamsQueryType = "NSAP"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsec DNSTimeseriesGroupResponseCodeParamsQueryType = "NSEC"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsec3 DNSTimeseriesGroupResponseCodeParamsQueryType = "NSEC3"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNsec3Param DNSTimeseriesGroupResponseCodeParamsQueryType = "NSEC3PARAM"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNull DNSTimeseriesGroupResponseCodeParamsQueryType = "NULL"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeNxt DNSTimeseriesGroupResponseCodeParamsQueryType = "NXT"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeOpenpgpkey DNSTimeseriesGroupResponseCodeParamsQueryType = "OPENPGPKEY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeOpt DNSTimeseriesGroupResponseCodeParamsQueryType = "OPT"

const DNSTimeseriesGroupResponseCodeParamsQueryTypePTR DNSTimeseriesGroupResponseCodeParamsQueryType = "PTR"

const DNSTimeseriesGroupResponseCodeParamsQueryTypePx DNSTimeseriesGroupResponseCodeParamsQueryType = "PX"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeRkey DNSTimeseriesGroupResponseCodeParamsQueryType = "RKEY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeRp DNSTimeseriesGroupResponseCodeParamsQueryType = "RP"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeRrsig DNSTimeseriesGroupResponseCodeParamsQueryType = "RRSIG"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeRt DNSTimeseriesGroupResponseCodeParamsQueryType = "RT"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSig DNSTimeseriesGroupResponseCodeParamsQueryType = "SIG"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSink DNSTimeseriesGroupResponseCodeParamsQueryType = "SINK"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSMIMEA DNSTimeseriesGroupResponseCodeParamsQueryType = "SMIMEA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSOA DNSTimeseriesGroupResponseCodeParamsQueryType = "SOA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSPF DNSTimeseriesGroupResponseCodeParamsQueryType = "SPF"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSRV DNSTimeseriesGroupResponseCodeParamsQueryType = "SRV"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSSHFP DNSTimeseriesGroupResponseCodeParamsQueryType = "SSHFP"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeSVCB DNSTimeseriesGroupResponseCodeParamsQueryType = "SVCB"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeTa DNSTimeseriesGroupResponseCodeParamsQueryType = "TA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeTalink DNSTimeseriesGroupResponseCodeParamsQueryType = "TALINK"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeTkey DNSTimeseriesGroupResponseCodeParamsQueryType = "TKEY"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeTLSA DNSTimeseriesGroupResponseCodeParamsQueryType = "TLSA"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeTSIG DNSTimeseriesGroupResponseCodeParamsQueryType = "TSIG"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeTXT DNSTimeseriesGroupResponseCodeParamsQueryType = "TXT"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeUinfo DNSTimeseriesGroupResponseCodeParamsQueryType = "UINFO"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeUID DNSTimeseriesGroupResponseCodeParamsQueryType = "UID"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeUnspec DNSTimeseriesGroupResponseCodeParamsQueryType = "UNSPEC"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeURI DNSTimeseriesGroupResponseCodeParamsQueryType = "URI"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeWks DNSTimeseriesGroupResponseCodeParamsQueryType = "WKS"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeX25 DNSTimeseriesGroupResponseCodeParamsQueryType = "X25"

const DNSTimeseriesGroupResponseCodeParamsQueryTypeZonemd DNSTimeseriesGroupResponseCodeParamsQueryType = "ZONEMD"

TLD param.Field[[]string]Optional

Filters results by top-level domain.

ReturnsExpand Collapse

type DNSTimeseriesGroupResponseCodeResponse struct{…}

Meta DNSTimeseriesGroupResponseCodeResponseMeta

Metadata for the results.

AggInterval DNSTimeseriesGroupResponseCodeResponseMetaAggInterval

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

One of the following:

const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "FIFTEEN_MINUTES"

const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneHour DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_HOUR"

const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneDay DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_DAY"

const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneWeek DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_WEEK"

const DNSTimeseriesGroupResponseCodeResponseMetaAggIntervalOneMonth DNSTimeseriesGroupResponseCodeResponseMetaAggInterval = "ONE_MONTH"

ConfidenceInfo DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfo

Annotations []DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotation

DataSource DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupResponseCodeResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"

IsInstantaneous bool

Whether event is a single point in time or a time range.

LinkedURL string

formaturi

StartDate Time

formatdate-time

Tags []stringOptional

Level int64

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

DateRange []DNSTimeseriesGroupResponseCodeResponseMetaDateRange

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 DNSTimeseriesGroupResponseCodeResponseMetaNormalization

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

One of the following:

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationPercentage DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "PERCENTAGE"

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationMin0Max DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "MIN0_MAX"

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationMinMax DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "MIN_MAX"

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationRawValues DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "RAW_VALUES"

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationPercentageChange DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "PERCENTAGE_CHANGE"

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationRollingAverage DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "ROLLING_AVERAGE"

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const DNSTimeseriesGroupResponseCodeResponseMetaNormalizationRatio DNSTimeseriesGroupResponseCodeResponseMetaNormalization = "RATIO"

Units []DNSTimeseriesGroupResponseCodeResponseMetaUnit

Measurement units for the results.

Name string

Value string

Serie0 DNSTimeseriesGroupResponseCodeResponseSerie0

Timestamps []Time

Get DNS queries by response code 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.ResponseCode(context.TODO(), radar.DNSTimeseriesGroupResponseCodeParams{

  })
  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": {
      "timestamps": [
        "2023-08-08T10:15:00Z"
      ]
    }
  },
  "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": {
      "timestamps": [
        "2023-08-08T10:15:00Z"
      ]
    }
  },
  "success": true
}