---
title: Spectrum
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Spectrum

##### ModelsExpand Collapse

<details>

<summary>

type DNS struct{…}

The name and type of DNS record for the Spectrum application.

</summary>

Name stringOptional

The name of the DNS record associated with the application.

formathostname

<a href="#(resource)%20spectrum%20%3E%20(model)%20dns%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

<details>

<summary>

Type DNSTypeOptional

The type of DNS record associated with the application.

</summary>

One of the following:

const DNSTypeCNAME DNSType = "CNAME"

<a href="#(resource)%20spectrum%20%3E%20(model)%20dns%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

const DNSTypeAddress DNSType = "ADDRESS"

<a href="#(resource)%20spectrum%20%3E%20(model)%20dns%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20spectrum%20%3E%20(model)%20dns%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

</details>

[Link to this property](<#(resource)%20spectrum%20%3E%20(model)%20dns%20%3E%20(schema)>)

<details>

<summary>

type EdgeIPs interface{…}

The anycast edge IP configuration for the hostname of this application.

</summary>

One of the following:

<details>

<summary>

type EdgeIPsDynamic struct{…}

</summary>

<details>

<summary>

Connectivity EdgeIPsDynamicConnectivityOptional

The IP versions supported for inbound connections on Spectrum anycast IPs.

</summary>

One of the following:

const EdgeIPsDynamicConnectivityAll EdgeIPsDynamicConnectivity = "all"

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20connectivity%20%3E%20(member)%200">Link to this property</a>

const EdgeIPsDynamicConnectivityIPV4 EdgeIPsDynamicConnectivity = "ipv4"

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20connectivity%20%3E%20(member)%201">Link to this property</a>

const EdgeIPsDynamicConnectivityIPV6 EdgeIPsDynamicConnectivity = "ipv6"

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20connectivity%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20connectivity">Link to this property</a>

Type EdgeIPsDynamicTypeOptional

The type of edge IP configuration specified. Dynamically allocated edge IPs use Spectrum anycast IPs in accordance with the connectivity you specify. Only valid with CNAME DNS names.

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

<details>

<summary>

type EdgeIPsStatic struct{…}

</summary>

IPs \[]stringOptional

The array of customer owned IPs we broadcast via anycast for this hostname and application.

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20ips">Link to this property</a>

Type EdgeIPsStaticTypeOptional

The type of edge IP configuration specified. Statically allocated edge IPs use customer IPs in accordance with the ips array you specify. Only valid with ADDRESS DNS names.

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

</details>

[Link to this property](<#(resource)%20spectrum%20%3E%20(model)%20edge_ips%20%3E%20(schema)>)

<details>

<summary>

type OriginDNS struct{…}

The name and type of DNS record for the Spectrum application.

</summary>

Name stringOptional

The name of the DNS record associated with the origin.

formathostname

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

TTL int64Optional

The TTL of our resolution of your DNS record in seconds.

minimum600

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)%20%3E%20(property)%20ttl">Link to this property</a>

<details>

<summary>

Type OriginDNSTypeOptional

The type of DNS record associated with the origin. "" is used to specify a combination of A/AAAA records.

</summary>

One of the following:

const OriginDNSTypeEmpty OriginDNSType = ""

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

const OriginDNSTypeA OriginDNSType = "A"

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

const OriginDNSTypeAAAA OriginDNSType = "AAAA"

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%202">Link to this property</a>

const OriginDNSTypeSRV OriginDNSType = "SRV"

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

</details>

[Link to this property](<#(resource)%20spectrum%20%3E%20(model)%20origin_dns%20%3E%20(schema)>)

<details>

<summary>

type OriginPortUnion interface{…}

The destination port at the origin. Only specified in conjunction with origin\_dns. May use an integer to specify a single origin port, for example <code>1000</code>, or a string to specify a range of origin ports, for example <code>"1000-2000"</code>. Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the “protocol” field.

</summary>

One of the following:

UnionInt

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_port%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

UnionString

<a href="#(resource)%20spectrum%20%3E%20(model)%20origin_port%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

</details>

[Link to this property](<#(resource)%20spectrum%20%3E%20(model)%20origin_port%20%3E%20(schema)>)

#### SpectrumAnalytics

#### SpectrumAnalyticsAggregates

#### SpectrumAnalyticsAggregatesCurrents

##### [Get current aggregated analytics](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/analytics/subresources/aggregates/subresources/currents/methods/get)

client.Spectrum.Analytics.Aggregates.Currents.Get(ctx, params) (\*\[] [AnalyticsAggregateCurrentGetResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.analytics.aggregates.currents%20%3E%20(model)%20AnalyticsAggregateCurrentGetResponse%20%3E%20(schema)>), error)

GET/zones/{zone\_id}/spectrum/analytics/aggregate/current

#### SpectrumAnalyticsEvents

##### ModelsExpand Collapse

<details>

<summary>

type Dimension string

</summary>

One of the following:

const DimensionEvent <a href="https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)">Dimension</a> = "event"

<a href="#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

const DimensionAppID <a href="https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)">Dimension</a> = "appID"

<a href="#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

const DimensionColoName <a href="https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)">Dimension</a> = "coloName"

<a href="#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

const DimensionIPVersion <a href="https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)">Dimension</a> = "ipVersion"

<a href="#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)%20%3E%20(member)%203">Link to this property</a>

</details>

[Link to this property](<#(resource)%20spectrum.analytics.events%20%3E%20(model)%20dimension%20%3E%20(schema)>)

#### SpectrumAnalyticsEventsBytimes

##### [Get analytics by time](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/analytics/subresources/events/subresources/bytimes/methods/get)

client.Spectrum.Analytics.Events.Bytimes.Get(ctx, params) (\*[AnalyticsEventBytimeGetResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.analytics.events.bytimes%20%3E%20(model)%20AnalyticsEventBytimeGetResponse%20%3E%20(schema)>), error)

GET/zones/{zone\_id}/spectrum/analytics/events/bytime

#### SpectrumAnalyticsEventsSummaries

##### [Get analytics summary](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/analytics/subresources/events/subresources/summaries/methods/get)

client.Spectrum.Analytics.Events.Summaries.Get(ctx, params) (\*[AnalyticsEventSummaryGetResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.analytics.events.summaries%20%3E%20(model)%20AnalyticsEventSummaryGetResponse%20%3E%20(schema)>), error)

GET/zones/{zone\_id}/spectrum/analytics/events/summary

#### SpectrumApps

##### [List Spectrum applications](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/apps/methods/list)

client.Spectrum.Apps.List(ctx, params) (\*V4PagePaginationArray\[[AppListResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.apps%20%3E%20(model)%20AppListResponse%20%3E%20(schema)>)], error)

GET/zones/{zone\_id}/spectrum/apps

##### [Get Spectrum application configuration](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/apps/methods/get)

client.Spectrum.Apps.Get(ctx, appID, query) (\*[AppGetResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.apps%20%3E%20(model)%20AppGetResponse%20%3E%20(schema)>), error)

GET/zones/{zone\_id}/spectrum/apps/{app\_id}

##### [Create Spectrum application using a name for the origin](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/apps/methods/create)

client.Spectrum.Apps.New(ctx, params) (\*[AppNewResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.apps%20%3E%20(model)%20AppNewResponse%20%3E%20(schema)>), error)

POST/zones/{zone\_id}/spectrum/apps

##### [Update Spectrum application configuration using a name for the origin](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/apps/methods/update)

client.Spectrum.Apps.Update(ctx, appID, params) (\*[AppUpdateResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.apps%20%3E%20(model)%20AppUpdateResponse%20%3E%20(schema)>), error)

PUT/zones/{zone\_id}/spectrum/apps/{app\_id}

##### [Delete Spectrum application](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/apps/methods/delete)

client.Spectrum.Apps.Delete(ctx, appID, body) (\*[AppDeleteResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.apps%20%3E%20(model)%20AppDeleteResponse%20%3E%20(schema)>), error)

DELETE/zones/{zone\_id}/spectrum/apps/{app\_id}

#### SpectrumProtocols

##### [List Spectrum application protocols](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/protocols/methods/list)

client.Spectrum.Protocols.List(ctx, query) (\*SinglePage\[[ProtocolListResponse](<https://developers.cloudflare.com/api/go/resources/spectrum#(resource)%20spectrum.protocols%20%3E%20(model)%20ProtocolListResponse%20%3E%20(schema)>)], error)

GET/zones/{zone\_id}/spectrum/protocols