cloudflare logo
Cloudflare v5.0.0, Mar 13 23

cloudflare.Record

Provides a Cloudflare record resource.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Cloudflare = Pulumi.Cloudflare;

return await Deployment.RunAsync(() => 
{
    // Add a record to the domain
    var example = new Cloudflare.Record("example", new()
    {
        ZoneId = @var.Cloudflare_zone_id,
        Name = "example",
        Value = "192.0.2.1",
        Type = "A",
        Ttl = 3600,
    });

    // Add a record requiring a data map
    var _sipTls = new Cloudflare.Record("_sipTls", new()
    {
        ZoneId = @var.Cloudflare_zone_id,
        Name = "_sip._tls",
        Type = "SRV",
        Data = new Cloudflare.Inputs.RecordDataArgs
        {
            Service = "_sip",
            Proto = "_tls",
            Name = "example-srv",
            Priority = 0,
            Weight = 0,
            Port = 443,
            Target = "example.com",
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-cloudflare/sdk/v5/go/cloudflare"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudflare.NewRecord(ctx, "example", &cloudflare.RecordArgs{
			ZoneId: pulumi.Any(_var.Cloudflare_zone_id),
			Name:   pulumi.String("example"),
			Value:  pulumi.String("192.0.2.1"),
			Type:   pulumi.String("A"),
			Ttl:    pulumi.Int(3600),
		})
		if err != nil {
			return err
		}
		_, err = cloudflare.NewRecord(ctx, "_sipTls", &cloudflare.RecordArgs{
			ZoneId: pulumi.Any(_var.Cloudflare_zone_id),
			Name:   pulumi.String("_sip._tls"),
			Type:   pulumi.String("SRV"),
			Data: &cloudflare.RecordDataArgs{
				Service:  pulumi.String("_sip"),
				Proto:    pulumi.String("_tls"),
				Name:     pulumi.String("example-srv"),
				Priority: pulumi.Int(0),
				Weight:   pulumi.Int(0),
				Port:     pulumi.Int(443),
				Target:   pulumi.String("example.com"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.cloudflare.Record;
import com.pulumi.cloudflare.RecordArgs;
import com.pulumi.cloudflare.inputs.RecordDataArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new Record("example", RecordArgs.builder()        
            .zoneId(var_.cloudflare_zone_id())
            .name("example")
            .value("192.0.2.1")
            .type("A")
            .ttl(3600)
            .build());

        var _sipTls = new Record("_sipTls", RecordArgs.builder()        
            .zoneId(var_.cloudflare_zone_id())
            .name("_sip._tls")
            .type("SRV")
            .data(RecordDataArgs.builder()
                .service("_sip")
                .proto("_tls")
                .name("example-srv")
                .priority(0)
                .weight(0)
                .port(443)
                .target("example.com")
                .build())
            .build());

    }
}
import pulumi
import pulumi_cloudflare as cloudflare

# Add a record to the domain
example = cloudflare.Record("example",
    zone_id=var["cloudflare_zone_id"],
    name="example",
    value="192.0.2.1",
    type="A",
    ttl=3600)
# Add a record requiring a data map
_sip_tls = cloudflare.Record("_sipTls",
    zone_id=var["cloudflare_zone_id"],
    name="_sip._tls",
    type="SRV",
    data=cloudflare.RecordDataArgs(
        service="_sip",
        proto="_tls",
        name="example-srv",
        priority=0,
        weight=0,
        port=443,
        target="example.com",
    ))
import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";

// Add a record to the domain
const example = new cloudflare.Record("example", {
    zoneId: _var.cloudflare_zone_id,
    name: "example",
    value: "192.0.2.1",
    type: "A",
    ttl: 3600,
});
// Add a record requiring a data map
const _sipTls = new cloudflare.Record("_sipTls", {
    zoneId: _var.cloudflare_zone_id,
    name: "_sip._tls",
    type: "SRV",
    data: {
        service: "_sip",
        proto: "_tls",
        name: "example-srv",
        priority: 0,
        weight: 0,
        port: 443,
        target: "example.com",
    },
});
resources:
  # Add a record to the domain
  example:
    type: cloudflare:Record
    properties:
      zoneId: ${var.cloudflare_zone_id}
      name: example
      value: 192.0.2.1
      type: A
      ttl: 3600
  # Add a record requiring a data map
  _sipTls:
    type: cloudflare:Record
    properties:
      zoneId: ${var.cloudflare_zone_id}
      name: _sip._tls
      type: SRV
      data:
        service: _sip
        proto: _tls
        name: example-srv
        priority: 0
        weight: 0
        port: 443
        target: example.com

Create Record Resource

new Record(name: string, args: RecordArgs, opts?: CustomResourceOptions);
@overload
def Record(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           allow_overwrite: Optional[bool] = None,
           comment: Optional[str] = None,
           data: Optional[RecordDataArgs] = None,
           name: Optional[str] = None,
           priority: Optional[int] = None,
           proxied: Optional[bool] = None,
           tags: Optional[Sequence[str]] = None,
           ttl: Optional[int] = None,
           type: Optional[str] = None,
           value: Optional[str] = None,
           zone_id: Optional[str] = None)
@overload
def Record(resource_name: str,
           args: RecordArgs,
           opts: Optional[ResourceOptions] = None)
func NewRecord(ctx *Context, name string, args RecordArgs, opts ...ResourceOption) (*Record, error)
public Record(string name, RecordArgs args, CustomResourceOptions? opts = null)
public Record(String name, RecordArgs args)
public Record(String name, RecordArgs args, CustomResourceOptions options)
type: cloudflare:Record
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Record Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The Record resource accepts the following input properties:

Name string

The name of the record. Modifying this attribute will force creation of a new resource.

Type string

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

ZoneId string

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

AllowOverwrite bool

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

Data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

Priority int

The priority of the record.

Proxied bool

Whether the record gets Cloudflare's origin protection.

Tags List<string>

Custom tags for the DNS record.

Ttl int

The TTL of the record.

Value string

The value of the record. Conflicts with data.

Name string

The name of the record. Modifying this attribute will force creation of a new resource.

Type string

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

ZoneId string

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

AllowOverwrite bool

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

Data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

Priority int

The priority of the record.

Proxied bool

Whether the record gets Cloudflare's origin protection.

Tags []string

Custom tags for the DNS record.

Ttl int

The TTL of the record.

Value string

The value of the record. Conflicts with data.

name String

The name of the record. Modifying this attribute will force creation of a new resource.

type String

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

zoneId String

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allowOverwrite Boolean

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment String

Comments or notes about the DNS record. This field has no effect on DNS responses.

data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

priority Integer

The priority of the record.

proxied Boolean

Whether the record gets Cloudflare's origin protection.

tags List<String>

Custom tags for the DNS record.

ttl Integer

The TTL of the record.

value String

The value of the record. Conflicts with data.

name string

The name of the record. Modifying this attribute will force creation of a new resource.

type string

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

zoneId string

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allowOverwrite boolean

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

priority number

The priority of the record.

proxied boolean

Whether the record gets Cloudflare's origin protection.

tags string[]

Custom tags for the DNS record.

ttl number

The TTL of the record.

value string

The value of the record. Conflicts with data.

name str

The name of the record. Modifying this attribute will force creation of a new resource.

type str

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

zone_id str

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allow_overwrite bool

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment str

Comments or notes about the DNS record. This field has no effect on DNS responses.

data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

priority int

The priority of the record.

proxied bool

Whether the record gets Cloudflare's origin protection.

tags Sequence[str]

Custom tags for the DNS record.

ttl int

The TTL of the record.

value str

The value of the record. Conflicts with data.

name String

The name of the record. Modifying this attribute will force creation of a new resource.

type String

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

zoneId String

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allowOverwrite Boolean

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment String

Comments or notes about the DNS record. This field has no effect on DNS responses.

data Property Map

Map of attributes that constitute the record value. Conflicts with value.

priority Number

The priority of the record.

proxied Boolean

Whether the record gets Cloudflare's origin protection.

tags List<String>

Custom tags for the DNS record.

ttl Number

The TTL of the record.

value String

The value of the record. Conflicts with data.

Outputs

All input properties are implicitly available as output properties. Additionally, the Record resource produces the following output properties:

CreatedOn string

The RFC3339 timestamp of when the record was created.

Hostname string

The FQDN of the record.

Id string

The provider-assigned unique ID for this managed resource.

Metadata Dictionary<string, object>

A key-value map of string metadata Cloudflare associates with the record.

ModifiedOn string

The RFC3339 timestamp of when the record was last modified.

Proxiable bool

Shows whether this record can be proxied.

CreatedOn string

The RFC3339 timestamp of when the record was created.

Hostname string

The FQDN of the record.

Id string

The provider-assigned unique ID for this managed resource.

Metadata map[string]interface{}

A key-value map of string metadata Cloudflare associates with the record.

ModifiedOn string

The RFC3339 timestamp of when the record was last modified.

Proxiable bool

Shows whether this record can be proxied.

createdOn String

The RFC3339 timestamp of when the record was created.

hostname String

The FQDN of the record.

id String

The provider-assigned unique ID for this managed resource.

metadata Map<String,Object>

A key-value map of string metadata Cloudflare associates with the record.

modifiedOn String

The RFC3339 timestamp of when the record was last modified.

proxiable Boolean

Shows whether this record can be proxied.

createdOn string

The RFC3339 timestamp of when the record was created.

hostname string

The FQDN of the record.

id string

The provider-assigned unique ID for this managed resource.

metadata {[key: string]: any}

A key-value map of string metadata Cloudflare associates with the record.

modifiedOn string

The RFC3339 timestamp of when the record was last modified.

proxiable boolean

Shows whether this record can be proxied.

created_on str

The RFC3339 timestamp of when the record was created.

hostname str

The FQDN of the record.

id str

The provider-assigned unique ID for this managed resource.

metadata Mapping[str, Any]

A key-value map of string metadata Cloudflare associates with the record.

modified_on str

The RFC3339 timestamp of when the record was last modified.

proxiable bool

Shows whether this record can be proxied.

createdOn String

The RFC3339 timestamp of when the record was created.

hostname String

The FQDN of the record.

id String

The provider-assigned unique ID for this managed resource.

metadata Map<Any>

A key-value map of string metadata Cloudflare associates with the record.

modifiedOn String

The RFC3339 timestamp of when the record was last modified.

proxiable Boolean

Shows whether this record can be proxied.

Look up Existing Record Resource

Get an existing Record resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: RecordState, opts?: CustomResourceOptions): Record
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        allow_overwrite: Optional[bool] = None,
        comment: Optional[str] = None,
        created_on: Optional[str] = None,
        data: Optional[RecordDataArgs] = None,
        hostname: Optional[str] = None,
        metadata: Optional[Mapping[str, Any]] = None,
        modified_on: Optional[str] = None,
        name: Optional[str] = None,
        priority: Optional[int] = None,
        proxiable: Optional[bool] = None,
        proxied: Optional[bool] = None,
        tags: Optional[Sequence[str]] = None,
        ttl: Optional[int] = None,
        type: Optional[str] = None,
        value: Optional[str] = None,
        zone_id: Optional[str] = None) -> Record
func GetRecord(ctx *Context, name string, id IDInput, state *RecordState, opts ...ResourceOption) (*Record, error)
public static Record Get(string name, Input<string> id, RecordState? state, CustomResourceOptions? opts = null)
public static Record get(String name, Output<String> id, RecordState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
AllowOverwrite bool

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

CreatedOn string

The RFC3339 timestamp of when the record was created.

Data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

Hostname string

The FQDN of the record.

Metadata Dictionary<string, object>

A key-value map of string metadata Cloudflare associates with the record.

ModifiedOn string

The RFC3339 timestamp of when the record was last modified.

Name string

The name of the record. Modifying this attribute will force creation of a new resource.

Priority int

The priority of the record.

Proxiable bool

Shows whether this record can be proxied.

Proxied bool

Whether the record gets Cloudflare's origin protection.

Tags List<string>

Custom tags for the DNS record.

Ttl int

The TTL of the record.

Type string

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

Value string

The value of the record. Conflicts with data.

ZoneId string

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

AllowOverwrite bool

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

CreatedOn string

The RFC3339 timestamp of when the record was created.

Data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

Hostname string

The FQDN of the record.

Metadata map[string]interface{}

A key-value map of string metadata Cloudflare associates with the record.

ModifiedOn string

The RFC3339 timestamp of when the record was last modified.

Name string

The name of the record. Modifying this attribute will force creation of a new resource.

Priority int

The priority of the record.

Proxiable bool

Shows whether this record can be proxied.

Proxied bool

Whether the record gets Cloudflare's origin protection.

Tags []string

Custom tags for the DNS record.

Ttl int

The TTL of the record.

Type string

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

Value string

The value of the record. Conflicts with data.

ZoneId string

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allowOverwrite Boolean

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment String

Comments or notes about the DNS record. This field has no effect on DNS responses.

createdOn String

The RFC3339 timestamp of when the record was created.

data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

hostname String

The FQDN of the record.

metadata Map<String,Object>

A key-value map of string metadata Cloudflare associates with the record.

modifiedOn String

The RFC3339 timestamp of when the record was last modified.

name String

The name of the record. Modifying this attribute will force creation of a new resource.

priority Integer

The priority of the record.

proxiable Boolean

Shows whether this record can be proxied.

proxied Boolean

Whether the record gets Cloudflare's origin protection.

tags List<String>

Custom tags for the DNS record.

ttl Integer

The TTL of the record.

type String

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

value String

The value of the record. Conflicts with data.

zoneId String

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allowOverwrite boolean

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

createdOn string

The RFC3339 timestamp of when the record was created.

data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

hostname string

The FQDN of the record.

metadata {[key: string]: any}

A key-value map of string metadata Cloudflare associates with the record.

modifiedOn string

The RFC3339 timestamp of when the record was last modified.

name string

The name of the record. Modifying this attribute will force creation of a new resource.

priority number

The priority of the record.

proxiable boolean

Shows whether this record can be proxied.

proxied boolean

Whether the record gets Cloudflare's origin protection.

tags string[]

Custom tags for the DNS record.

ttl number

The TTL of the record.

type string

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

value string

The value of the record. Conflicts with data.

zoneId string

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allow_overwrite bool

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment str

Comments or notes about the DNS record. This field has no effect on DNS responses.

created_on str

The RFC3339 timestamp of when the record was created.

data RecordDataArgs

Map of attributes that constitute the record value. Conflicts with value.

hostname str

The FQDN of the record.

metadata Mapping[str, Any]

A key-value map of string metadata Cloudflare associates with the record.

modified_on str

The RFC3339 timestamp of when the record was last modified.

name str

The name of the record. Modifying this attribute will force creation of a new resource.

priority int

The priority of the record.

proxiable bool

Shows whether this record can be proxied.

proxied bool

Whether the record gets Cloudflare's origin protection.

tags Sequence[str]

Custom tags for the DNS record.

ttl int

The TTL of the record.

type str

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

value str

The value of the record. Conflicts with data.

zone_id str

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

allowOverwrite Boolean

Allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual changes outside Terraform from overwriting this record. This configuration is not recommended for most environments

comment String

Comments or notes about the DNS record. This field has no effect on DNS responses.

createdOn String

The RFC3339 timestamp of when the record was created.

data Property Map

Map of attributes that constitute the record value. Conflicts with value.

hostname String

The FQDN of the record.

metadata Map<Any>

A key-value map of string metadata Cloudflare associates with the record.

modifiedOn String

The RFC3339 timestamp of when the record was last modified.

name String

The name of the record. Modifying this attribute will force creation of a new resource.

priority Number

The priority of the record.

proxiable Boolean

Shows whether this record can be proxied.

proxied Boolean

Whether the record gets Cloudflare's origin protection.

tags List<String>

Custom tags for the DNS record.

ttl Number

The TTL of the record.

type String

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

value String

The value of the record. Conflicts with data.

zoneId String

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.

Supporting Types

RecordData

Algorithm int
Altitude double
Certificate string
Content string
Digest string
DigestType int
Fingerprint string
Flags string
KeyTag int
LatDegrees int
LatDirection string
LatMinutes int
LatSeconds double
LongDegrees int
LongDirection string
LongMinutes int
LongSeconds double
MatchingType int
Name string

The name of the record. Modifying this attribute will force creation of a new resource.

Order int
Port int
PrecisionHorz double
PrecisionVert double
Preference int
Priority int

The priority of the record.

Proto string
Protocol int
PublicKey string
Regex string
Replacement string
Selector int
Service string
Size double
Tag string
Target string
Type int

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

Usage int
Value string

The value of the record. Conflicts with data.

Weight int
Algorithm int
Altitude float64
Certificate string
Content string
Digest string
DigestType int
Fingerprint string
Flags string
KeyTag int
LatDegrees int
LatDirection string
LatMinutes int
LatSeconds float64
LongDegrees int
LongDirection string
LongMinutes int
LongSeconds float64
MatchingType int
Name string

The name of the record. Modifying this attribute will force creation of a new resource.

Order int
Port int
PrecisionHorz float64
PrecisionVert float64
Preference int
Priority int

The priority of the record.

Proto string
Protocol int
PublicKey string
Regex string
Replacement string
Selector int
Service string
Size float64
Tag string
Target string
Type int

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

Usage int
Value string

The value of the record. Conflicts with data.

Weight int
algorithm Integer
altitude Double
certificate String
content String
digest String
digestType Integer
fingerprint String
flags String
keyTag Integer
latDegrees Integer
latDirection String
latMinutes Integer
latSeconds Double
longDegrees Integer
longDirection String
longMinutes Integer
longSeconds Double
matchingType Integer
name String

The name of the record. Modifying this attribute will force creation of a new resource.

order Integer
port Integer
precisionHorz Double
precisionVert Double
preference Integer
priority Integer

The priority of the record.

proto String
protocol Integer
publicKey String
regex String
replacement String
selector Integer
service String
size Double
tag String
target String
type Integer

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

usage Integer
value String

The value of the record. Conflicts with data.

weight Integer
algorithm number
altitude number
certificate string
content string
digest string
digestType number
fingerprint string
flags string
keyTag number
latDegrees number
latDirection string
latMinutes number
latSeconds number
longDegrees number
longDirection string
longMinutes number
longSeconds number
matchingType number
name string

The name of the record. Modifying this attribute will force creation of a new resource.

order number
port number
precisionHorz number
precisionVert number
preference number
priority number

The priority of the record.

proto string
protocol number
publicKey string
regex string
replacement string
selector number
service string
size number
tag string
target string
type number

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

usage number
value string

The value of the record. Conflicts with data.

weight number
algorithm int
altitude float
certificate str
content str
digest str
digest_type int
fingerprint str
flags str
key_tag int
lat_degrees int
lat_direction str
lat_minutes int
lat_seconds float
long_degrees int
long_direction str
long_minutes int
long_seconds float
matching_type int
name str

The name of the record. Modifying this attribute will force creation of a new resource.

order int
port int
precision_horz float
precision_vert float
preference int
priority int

The priority of the record.

proto str
protocol int
public_key str
regex str
replacement str
selector int
service str
size float
tag str
target str
type int

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

usage int
value str

The value of the record. Conflicts with data.

weight int
algorithm Number
altitude Number
certificate String
content String
digest String
digestType Number
fingerprint String
flags String
keyTag Number
latDegrees Number
latDirection String
latMinutes Number
latSeconds Number
longDegrees Number
longDirection String
longMinutes Number
longSeconds Number
matchingType Number
name String

The name of the record. Modifying this attribute will force creation of a new resource.

order Number
port Number
precisionHorz Number
precisionVert Number
preference Number
priority Number

The priority of the record.

proto String
protocol Number
publicKey String
regex String
replacement String
selector Number
service String
size Number
tag String
target String
type Number

The type of the record. Available values: A, AAAA, CAA, CNAME, TXT, SRV, LOC, MX, NS, SPF, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, TLSA, URI, PTR, HTTPS. Modifying this attribute will force creation of a new resource.

usage Number
value String

The value of the record. Conflicts with data.

weight Number

Import

 $ pulumi import cloudflare:index/record:Record example <zone_id>/<record_id>

Package Details

Repository
Cloudflare pulumi/pulumi-cloudflare
License
Apache-2.0
Notes

This Pulumi package is based on the cloudflare Terraform Provider.