1. Packages
  2. Cloudflare
  3. API Docs
  4. Record
Cloudflare v5.11.0 published on Wednesday, Sep 20, 2023 by Pulumi

cloudflare.Record

Explore with Pulumi AI

cloudflare logo
Cloudflare v5.11.0 published on Wednesday, Sep 20, 2023 by Pulumi

    Provides a Cloudflare record resource.

    Example Usage

    using System.Collections.Generic;
    using System.Linq;
    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, SVCB. 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 RecordData

    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, SVCB. 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, SVCB. 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 RecordData

    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, SVCB. 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 RecordData

    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, SVCB. 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, SVCB. 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 RecordData

    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, SVCB. 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, SVCB. 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 RecordData

    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, SVCB. 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 RecordData

    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, SVCB. 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, SVCB. 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, SVCB. 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, RecordDataArgs

    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, SVCB. 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, SVCB. 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, SVCB. 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, SVCB. 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, SVCB. 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, SVCB. 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.

    cloudflare logo
    Cloudflare v5.11.0 published on Wednesday, Sep 20, 2023 by Pulumi