Cloudflare v5.11.0, Sep 20 23

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

cloudflare.Record

Explore with Pulumi AI

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

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 v5.11.0 published on Wednesday, Sep 20, 2023 by Pulumi

pulumi/pulumi-cloudflare

cloudflare.Record

On this page

On this page

Example Usage

Create Record Resource

Record Resource Properties

Inputs

Outputs

Look up Existing Record Resource

Supporting Types

RecordData, RecordDataArgs

Import

Package Details

On this page

On this page