cloudflare.Record
Explore with Pulumi AI
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.- Zone
Id 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 string
Comments or notes about the DNS record. This field has no effect on DNS responses.
- Data
Record
Data 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.
- 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.- Zone
Id 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 string
Comments or notes about the DNS record. This field has no effect on DNS responses.
- Data
Record
Data Args 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.
- []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.- zone
Id String The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.
- allow
Overwrite 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
Record
Data 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.
- 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.- zone
Id string The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.
- allow
Overwrite 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
Record
Data 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.
- 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
Record
Data Args 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.
- 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.- zone
Id String The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.
- allow
Overwrite 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.
- 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:
- Created
On 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.
- Modified
On string The RFC3339 timestamp of when the record was last modified.
- Proxiable bool
Shows whether this record can be proxied.
- Created
On 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.
- Modified
On string The RFC3339 timestamp of when the record was last modified.
- Proxiable bool
Shows whether this record can be proxied.
- created
On 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.
- modified
On String The RFC3339 timestamp of when the record was last modified.
- proxiable Boolean
Shows whether this record can be proxied.
- created
On 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.
- modified
On 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.
- created
On 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.
- modified
On 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.
- 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 string
Comments or notes about the DNS record. This field has no effect on DNS responses.
- Created
On string The RFC3339 timestamp of when the record was created.
- Data
Record
Data 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.
- Modified
On 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.
- 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
.- Zone
Id 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 string
Comments or notes about the DNS record. This field has no effect on DNS responses.
- Created
On string The RFC3339 timestamp of when the record was created.
- Data
Record
Data Args 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.
- Modified
On 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.
- []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
.- Zone
Id string The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.
- allow
Overwrite 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.
- created
On String The RFC3339 timestamp of when the record was created.
- data
Record
Data 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.
- modified
On 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.
- 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
.- zone
Id String The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.
- allow
Overwrite 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.
- created
On string The RFC3339 timestamp of when the record was created.
- data
Record
Data 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.
- modified
On 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.
- 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
.- zone
Id 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
Record
Data Args 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.
- 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.
- allow
Overwrite 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.
- created
On 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.
- modified
On 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.
- 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
.- zone
Id 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
- Digest
Type int - Fingerprint string
- Flags string
- Key
Tag int - Lat
Degrees int - Lat
Direction string - Lat
Minutes int - Lat
Seconds double - Long
Degrees int - Long
Direction string - Long
Minutes int - Long
Seconds double - Matching
Type int - Name string
The name of the record. Modifying this attribute will force creation of a new resource.
- Order int
- Port int
- Precision
Horz double - Precision
Vert double - Preference int
- Priority int
The priority of the record.
- Proto string
- Protocol int
- Public
Key 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
- Digest
Type int - Fingerprint string
- Flags string
- Key
Tag int - Lat
Degrees int - Lat
Direction string - Lat
Minutes int - Lat
Seconds float64 - Long
Degrees int - Long
Direction string - Long
Minutes int - Long
Seconds float64 - Matching
Type int - Name string
The name of the record. Modifying this attribute will force creation of a new resource.
- Order int
- Port int
- Precision
Horz float64 - Precision
Vert float64 - Preference int
- Priority int
The priority of the record.
- Proto string
- Protocol int
- Public
Key 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
- digest
Type Integer - fingerprint String
- flags String
- key
Tag Integer - lat
Degrees Integer - lat
Direction String - lat
Minutes Integer - lat
Seconds Double - long
Degrees Integer - long
Direction String - long
Minutes Integer - long
Seconds Double - matching
Type Integer - name String
The name of the record. Modifying this attribute will force creation of a new resource.
- order Integer
- port Integer
- precision
Horz Double - precision
Vert Double - preference Integer
- priority Integer
The priority of the record.
- proto String
- protocol Integer
- public
Key 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
- digest
Type number - fingerprint string
- flags string
- key
Tag number - lat
Degrees number - lat
Direction string - lat
Minutes number - lat
Seconds number - long
Degrees number - long
Direction string - long
Minutes number - long
Seconds number - matching
Type number - name string
The name of the record. Modifying this attribute will force creation of a new resource.
- order number
- port number
- precision
Horz number - precision
Vert number - preference number
- priority number
The priority of the record.
- proto string
- protocol number
- public
Key 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
- digest
Type Number - fingerprint String
- flags String
- key
Tag Number - lat
Degrees Number - lat
Direction String - lat
Minutes Number - lat
Seconds Number - long
Degrees Number - long
Direction String - long
Minutes Number - long
Seconds Number - matching
Type Number - name String
The name of the record. Modifying this attribute will force creation of a new resource.
- order Number
- port Number
- precision
Horz Number - precision
Vert Number - preference Number
- priority Number
The priority of the record.
- proto String
- protocol Number
- public
Key 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.