cloudflare.DnsRecord
Explore with Pulumi AI
Example Usage
Coming soon!
Coming soon!
Coming soon!
Coming soon!
Coming soon!
resources:
exampleDnsRecord:
type: cloudflare:DnsRecord
name: example_dns_record
properties:
zoneId: 023e105f4ecef8ad9ca31a8372d0c353
comment: Domain verification record
content: 198.51.100.4
name: example.com
proxied: true
settings:
ipv4_only: true
ipv6_only: true
tags:
- owner:dns-team
ttl: 3600
type: A
Create DnsRecord Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DnsRecord(name: string, args: DnsRecordArgs, opts?: CustomResourceOptions);
@overload
def DnsRecord(resource_name: str,
args: DnsRecordArgs,
opts: Optional[ResourceOptions] = None)
@overload
def DnsRecord(resource_name: str,
opts: Optional[ResourceOptions] = None,
name: Optional[str] = None,
ttl: Optional[float] = None,
type: Optional[str] = None,
zone_id: Optional[str] = None,
comment: Optional[str] = None,
content: Optional[str] = None,
data: Optional[DnsRecordDataArgs] = None,
priority: Optional[float] = None,
proxied: Optional[bool] = None,
settings: Optional[DnsRecordSettingsArgs] = None,
tags: Optional[Sequence[str]] = None)
func NewDnsRecord(ctx *Context, name string, args DnsRecordArgs, opts ...ResourceOption) (*DnsRecord, error)
public DnsRecord(string name, DnsRecordArgs args, CustomResourceOptions? opts = null)
public DnsRecord(String name, DnsRecordArgs args)
public DnsRecord(String name, DnsRecordArgs args, CustomResourceOptions options)
type: cloudflare:DnsRecord
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DnsRecordArgs
- 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 DnsRecordArgs
- 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 DnsRecordArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DnsRecordArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DnsRecordArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var dnsRecordResource = new Cloudflare.DnsRecord("dnsRecordResource", new()
{
Name = "string",
Ttl = 0,
Type = "string",
ZoneId = "string",
Comment = "string",
Content = "string",
Data = new Cloudflare.Inputs.DnsRecordDataArgs
{
Algorithm = 0,
Altitude = 0,
Certificate = "string",
Digest = "string",
DigestType = 0,
Fingerprint = "string",
Flags = 0,
KeyTag = 0,
LatDegrees = 0,
LatDirection = "string",
LatMinutes = 0,
LatSeconds = 0,
LongDegrees = 0,
LongDirection = "string",
LongMinutes = 0,
LongSeconds = 0,
MatchingType = 0,
Order = 0,
Port = 0,
PrecisionHorz = 0,
PrecisionVert = 0,
Preference = 0,
Priority = 0,
Protocol = 0,
PublicKey = "string",
Regex = "string",
Replacement = "string",
Selector = 0,
Service = "string",
Size = 0,
Tag = "string",
Target = "string",
Type = 0,
Usage = 0,
Value = "string",
Weight = 0,
},
Priority = 0,
Proxied = false,
Settings = new Cloudflare.Inputs.DnsRecordSettingsArgs
{
FlattenCname = false,
Ipv4Only = false,
Ipv6Only = false,
},
Tags = new[]
{
"string",
},
});
example, err := cloudflare.NewDnsRecord(ctx, "dnsRecordResource", &cloudflare.DnsRecordArgs{
Name: pulumi.String("string"),
Ttl: pulumi.Float64(0),
Type: pulumi.String("string"),
ZoneId: pulumi.String("string"),
Comment: pulumi.String("string"),
Content: pulumi.String("string"),
Data: &cloudflare.DnsRecordDataArgs{
Algorithm: pulumi.Float64(0),
Altitude: pulumi.Float64(0),
Certificate: pulumi.String("string"),
Digest: pulumi.String("string"),
DigestType: pulumi.Float64(0),
Fingerprint: pulumi.String("string"),
Flags: pulumi.Float64(0),
KeyTag: pulumi.Float64(0),
LatDegrees: pulumi.Float64(0),
LatDirection: pulumi.String("string"),
LatMinutes: pulumi.Float64(0),
LatSeconds: pulumi.Float64(0),
LongDegrees: pulumi.Float64(0),
LongDirection: pulumi.String("string"),
LongMinutes: pulumi.Float64(0),
LongSeconds: pulumi.Float64(0),
MatchingType: pulumi.Float64(0),
Order: pulumi.Float64(0),
Port: pulumi.Float64(0),
PrecisionHorz: pulumi.Float64(0),
PrecisionVert: pulumi.Float64(0),
Preference: pulumi.Float64(0),
Priority: pulumi.Float64(0),
Protocol: pulumi.Float64(0),
PublicKey: pulumi.String("string"),
Regex: pulumi.String("string"),
Replacement: pulumi.String("string"),
Selector: pulumi.Float64(0),
Service: pulumi.String("string"),
Size: pulumi.Float64(0),
Tag: pulumi.String("string"),
Target: pulumi.String("string"),
Type: pulumi.Float64(0),
Usage: pulumi.Float64(0),
Value: pulumi.String("string"),
Weight: pulumi.Float64(0),
},
Priority: pulumi.Float64(0),
Proxied: pulumi.Bool(false),
Settings: &cloudflare.DnsRecordSettingsArgs{
FlattenCname: pulumi.Bool(false),
Ipv4Only: pulumi.Bool(false),
Ipv6Only: pulumi.Bool(false),
},
Tags: pulumi.StringArray{
pulumi.String("string"),
},
})
var dnsRecordResource = new DnsRecord("dnsRecordResource", DnsRecordArgs.builder()
.name("string")
.ttl(0)
.type("string")
.zoneId("string")
.comment("string")
.content("string")
.data(DnsRecordDataArgs.builder()
.algorithm(0)
.altitude(0)
.certificate("string")
.digest("string")
.digestType(0)
.fingerprint("string")
.flags(0)
.keyTag(0)
.latDegrees(0)
.latDirection("string")
.latMinutes(0)
.latSeconds(0)
.longDegrees(0)
.longDirection("string")
.longMinutes(0)
.longSeconds(0)
.matchingType(0)
.order(0)
.port(0)
.precisionHorz(0)
.precisionVert(0)
.preference(0)
.priority(0)
.protocol(0)
.publicKey("string")
.regex("string")
.replacement("string")
.selector(0)
.service("string")
.size(0)
.tag("string")
.target("string")
.type(0)
.usage(0)
.value("string")
.weight(0)
.build())
.priority(0)
.proxied(false)
.settings(DnsRecordSettingsArgs.builder()
.flattenCname(false)
.ipv4Only(false)
.ipv6Only(false)
.build())
.tags("string")
.build());
dns_record_resource = cloudflare.DnsRecord("dnsRecordResource",
name="string",
ttl=0,
type="string",
zone_id="string",
comment="string",
content="string",
data={
"algorithm": 0,
"altitude": 0,
"certificate": "string",
"digest": "string",
"digest_type": 0,
"fingerprint": "string",
"flags": 0,
"key_tag": 0,
"lat_degrees": 0,
"lat_direction": "string",
"lat_minutes": 0,
"lat_seconds": 0,
"long_degrees": 0,
"long_direction": "string",
"long_minutes": 0,
"long_seconds": 0,
"matching_type": 0,
"order": 0,
"port": 0,
"precision_horz": 0,
"precision_vert": 0,
"preference": 0,
"priority": 0,
"protocol": 0,
"public_key": "string",
"regex": "string",
"replacement": "string",
"selector": 0,
"service": "string",
"size": 0,
"tag": "string",
"target": "string",
"type": 0,
"usage": 0,
"value": "string",
"weight": 0,
},
priority=0,
proxied=False,
settings={
"flatten_cname": False,
"ipv4_only": False,
"ipv6_only": False,
},
tags=["string"])
const dnsRecordResource = new cloudflare.DnsRecord("dnsRecordResource", {
name: "string",
ttl: 0,
type: "string",
zoneId: "string",
comment: "string",
content: "string",
data: {
algorithm: 0,
altitude: 0,
certificate: "string",
digest: "string",
digestType: 0,
fingerprint: "string",
flags: 0,
keyTag: 0,
latDegrees: 0,
latDirection: "string",
latMinutes: 0,
latSeconds: 0,
longDegrees: 0,
longDirection: "string",
longMinutes: 0,
longSeconds: 0,
matchingType: 0,
order: 0,
port: 0,
precisionHorz: 0,
precisionVert: 0,
preference: 0,
priority: 0,
protocol: 0,
publicKey: "string",
regex: "string",
replacement: "string",
selector: 0,
service: "string",
size: 0,
tag: "string",
target: "string",
type: 0,
usage: 0,
value: "string",
weight: 0,
},
priority: 0,
proxied: false,
settings: {
flattenCname: false,
ipv4Only: false,
ipv6Only: false,
},
tags: ["string"],
});
type: cloudflare:DnsRecord
properties:
comment: string
content: string
data:
algorithm: 0
altitude: 0
certificate: string
digest: string
digestType: 0
fingerprint: string
flags: 0
keyTag: 0
latDegrees: 0
latDirection: string
latMinutes: 0
latSeconds: 0
longDegrees: 0
longDirection: string
longMinutes: 0
longSeconds: 0
matchingType: 0
order: 0
port: 0
precisionHorz: 0
precisionVert: 0
preference: 0
priority: 0
protocol: 0
publicKey: string
regex: string
replacement: string
selector: 0
service: string
size: 0
tag: string
target: string
type: 0
usage: 0
value: string
weight: 0
name: string
priority: 0
proxied: false
settings:
flattenCname: false
ipv4Only: false
ipv6Only: false
tags:
- string
ttl: 0
type: string
zoneId: string
DnsRecord Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The DnsRecord resource accepts the following input properties:
- Name string
- DNS record name (or @ for the zone apex) in Punycode.
- Ttl double
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- Type string
- Record type. Available values: "A".
- Zone
Id string - Identifier.
- Comment string
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- Content string
- A valid IPv4 address.
- Data
Dns
Record Data - Components of a CAA record.
- Priority double
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- Proxied bool
- Whether the record is receiving the performance and security benefits of Cloudflare.
- Settings
Dns
Record Settings - Settings for the DNS record.
- List<string>
- Custom tags for the DNS record. This field has no effect on DNS responses.
- Name string
- DNS record name (or @ for the zone apex) in Punycode.
- Ttl float64
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- Type string
- Record type. Available values: "A".
- Zone
Id string - Identifier.
- Comment string
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- Content string
- A valid IPv4 address.
- Data
Dns
Record Data Args - Components of a CAA record.
- Priority float64
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- Proxied bool
- Whether the record is receiving the performance and security benefits of Cloudflare.
- Settings
Dns
Record Settings Args - Settings for the DNS record.
- []string
- Custom tags for the DNS record. This field has no effect on DNS responses.
- name String
- DNS record name (or @ for the zone apex) in Punycode.
- ttl Double
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type String
- Record type. Available values: "A".
- zone
Id String - Identifier.
- comment String
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- content String
- A valid IPv4 address.
- data
Dns
Record Data - Components of a CAA record.
- priority Double
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxied Boolean
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings
Dns
Record Settings - Settings for the DNS record.
- List<String>
- Custom tags for the DNS record. This field has no effect on DNS responses.
- name string
- DNS record name (or @ for the zone apex) in Punycode.
- ttl number
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type string
- Record type. Available values: "A".
- zone
Id string - Identifier.
- comment string
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- content string
- A valid IPv4 address.
- data
Dns
Record Data - Components of a CAA record.
- priority number
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxied boolean
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings
Dns
Record Settings - Settings for the DNS record.
- string[]
- Custom tags for the DNS record. This field has no effect on DNS responses.
- name str
- DNS record name (or @ for the zone apex) in Punycode.
- ttl float
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type str
- Record type. Available values: "A".
- zone_
id str - Identifier.
- comment str
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- content str
- A valid IPv4 address.
- data
Dns
Record Data Args - Components of a CAA record.
- priority float
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxied bool
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings
Dns
Record Settings Args - Settings for the DNS record.
- Sequence[str]
- Custom tags for the DNS record. This field has no effect on DNS responses.
- name String
- DNS record name (or @ for the zone apex) in Punycode.
- ttl Number
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type String
- Record type. Available values: "A".
- zone
Id String - Identifier.
- comment String
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- content String
- A valid IPv4 address.
- data Property Map
- Components of a CAA record.
- priority Number
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxied Boolean
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings Property Map
- Settings for the DNS record.
- List<String>
- Custom tags for the DNS record. This field has no effect on DNS responses.
Outputs
All input properties are implicitly available as output properties. Additionally, the DnsRecord resource produces the following output properties:
- Comment
Modified stringOn - When the record comment was last modified. Omitted if there is no comment.
- Created
On string - When the record was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Meta string
- Extra Cloudflare-specific information about the record.
- Modified
On string - When the record was last modified.
- Proxiable bool
- Whether the record can be proxied by Cloudflare or not.
- string
- When the record tags were last modified. Omitted if there are no tags.
- Comment
Modified stringOn - When the record comment was last modified. Omitted if there is no comment.
- Created
On string - When the record was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Meta string
- Extra Cloudflare-specific information about the record.
- Modified
On string - When the record was last modified.
- Proxiable bool
- Whether the record can be proxied by Cloudflare or not.
- string
- When the record tags were last modified. Omitted if there are no tags.
- comment
Modified StringOn - When the record comment was last modified. Omitted if there is no comment.
- created
On String - When the record was created.
- id String
- The provider-assigned unique ID for this managed resource.
- meta String
- Extra Cloudflare-specific information about the record.
- modified
On String - When the record was last modified.
- proxiable Boolean
- Whether the record can be proxied by Cloudflare or not.
- String
- When the record tags were last modified. Omitted if there are no tags.
- comment
Modified stringOn - When the record comment was last modified. Omitted if there is no comment.
- created
On string - When the record was created.
- id string
- The provider-assigned unique ID for this managed resource.
- meta string
- Extra Cloudflare-specific information about the record.
- modified
On string - When the record was last modified.
- proxiable boolean
- Whether the record can be proxied by Cloudflare or not.
- string
- When the record tags were last modified. Omitted if there are no tags.
- comment_
modified_ stron - When the record comment was last modified. Omitted if there is no comment.
- created_
on str - When the record was created.
- id str
- The provider-assigned unique ID for this managed resource.
- meta str
- Extra Cloudflare-specific information about the record.
- modified_
on str - When the record was last modified.
- proxiable bool
- Whether the record can be proxied by Cloudflare or not.
- str
- When the record tags were last modified. Omitted if there are no tags.
- comment
Modified StringOn - When the record comment was last modified. Omitted if there is no comment.
- created
On String - When the record was created.
- id String
- The provider-assigned unique ID for this managed resource.
- meta String
- Extra Cloudflare-specific information about the record.
- modified
On String - When the record was last modified.
- proxiable Boolean
- Whether the record can be proxied by Cloudflare or not.
- String
- When the record tags were last modified. Omitted if there are no tags.
Look up Existing DnsRecord Resource
Get an existing DnsRecord 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?: DnsRecordState, opts?: CustomResourceOptions): DnsRecord
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
comment: Optional[str] = None,
comment_modified_on: Optional[str] = None,
content: Optional[str] = None,
created_on: Optional[str] = None,
data: Optional[DnsRecordDataArgs] = None,
meta: Optional[str] = None,
modified_on: Optional[str] = None,
name: Optional[str] = None,
priority: Optional[float] = None,
proxiable: Optional[bool] = None,
proxied: Optional[bool] = None,
settings: Optional[DnsRecordSettingsArgs] = None,
tags: Optional[Sequence[str]] = None,
tags_modified_on: Optional[str] = None,
ttl: Optional[float] = None,
type: Optional[str] = None,
zone_id: Optional[str] = None) -> DnsRecord
func GetDnsRecord(ctx *Context, name string, id IDInput, state *DnsRecordState, opts ...ResourceOption) (*DnsRecord, error)
public static DnsRecord Get(string name, Input<string> id, DnsRecordState? state, CustomResourceOptions? opts = null)
public static DnsRecord get(String name, Output<String> id, DnsRecordState state, CustomResourceOptions options)
resources: _: type: cloudflare:DnsRecord get: id: ${id}
- 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.
- Comment string
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- Comment
Modified stringOn - When the record comment was last modified. Omitted if there is no comment.
- Content string
- A valid IPv4 address.
- Created
On string - When the record was created.
- Data
Dns
Record Data - Components of a CAA record.
- Meta string
- Extra Cloudflare-specific information about the record.
- Modified
On string - When the record was last modified.
- Name string
- DNS record name (or @ for the zone apex) in Punycode.
- Priority double
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- Proxiable bool
- Whether the record can be proxied by Cloudflare or not.
- Proxied bool
- Whether the record is receiving the performance and security benefits of Cloudflare.
- Settings
Dns
Record Settings - Settings for the DNS record.
- List<string>
- Custom tags for the DNS record. This field has no effect on DNS responses.
- string
- When the record tags were last modified. Omitted if there are no tags.
- Ttl double
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- Type string
- Record type. Available values: "A".
- Zone
Id string - Identifier.
- Comment string
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- Comment
Modified stringOn - When the record comment was last modified. Omitted if there is no comment.
- Content string
- A valid IPv4 address.
- Created
On string - When the record was created.
- Data
Dns
Record Data Args - Components of a CAA record.
- Meta string
- Extra Cloudflare-specific information about the record.
- Modified
On string - When the record was last modified.
- Name string
- DNS record name (or @ for the zone apex) in Punycode.
- Priority float64
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- Proxiable bool
- Whether the record can be proxied by Cloudflare or not.
- Proxied bool
- Whether the record is receiving the performance and security benefits of Cloudflare.
- Settings
Dns
Record Settings Args - Settings for the DNS record.
- []string
- Custom tags for the DNS record. This field has no effect on DNS responses.
- string
- When the record tags were last modified. Omitted if there are no tags.
- Ttl float64
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- Type string
- Record type. Available values: "A".
- Zone
Id string - Identifier.
- comment String
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- comment
Modified StringOn - When the record comment was last modified. Omitted if there is no comment.
- content String
- A valid IPv4 address.
- created
On String - When the record was created.
- data
Dns
Record Data - Components of a CAA record.
- meta String
- Extra Cloudflare-specific information about the record.
- modified
On String - When the record was last modified.
- name String
- DNS record name (or @ for the zone apex) in Punycode.
- priority Double
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxiable Boolean
- Whether the record can be proxied by Cloudflare or not.
- proxied Boolean
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings
Dns
Record Settings - Settings for the DNS record.
- List<String>
- Custom tags for the DNS record. This field has no effect on DNS responses.
- String
- When the record tags were last modified. Omitted if there are no tags.
- ttl Double
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type String
- Record type. Available values: "A".
- zone
Id String - Identifier.
- comment string
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- comment
Modified stringOn - When the record comment was last modified. Omitted if there is no comment.
- content string
- A valid IPv4 address.
- created
On string - When the record was created.
- data
Dns
Record Data - Components of a CAA record.
- meta string
- Extra Cloudflare-specific information about the record.
- modified
On string - When the record was last modified.
- name string
- DNS record name (or @ for the zone apex) in Punycode.
- priority number
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxiable boolean
- Whether the record can be proxied by Cloudflare or not.
- proxied boolean
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings
Dns
Record Settings - Settings for the DNS record.
- string[]
- Custom tags for the DNS record. This field has no effect on DNS responses.
- string
- When the record tags were last modified. Omitted if there are no tags.
- ttl number
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type string
- Record type. Available values: "A".
- zone
Id string - Identifier.
- comment str
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- comment_
modified_ stron - When the record comment was last modified. Omitted if there is no comment.
- content str
- A valid IPv4 address.
- created_
on str - When the record was created.
- data
Dns
Record Data Args - Components of a CAA record.
- meta str
- Extra Cloudflare-specific information about the record.
- modified_
on str - When the record was last modified.
- name str
- DNS record name (or @ for the zone apex) in Punycode.
- priority float
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxiable bool
- Whether the record can be proxied by Cloudflare or not.
- proxied bool
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings
Dns
Record Settings Args - Settings for the DNS record.
- Sequence[str]
- Custom tags for the DNS record. This field has no effect on DNS responses.
- str
- When the record tags were last modified. Omitted if there are no tags.
- ttl float
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type str
- Record type. Available values: "A".
- zone_
id str - Identifier.
- comment String
- Comments or notes about the DNS record. This field has no effect on DNS responses.
- comment
Modified StringOn - When the record comment was last modified. Omitted if there is no comment.
- content String
- A valid IPv4 address.
- created
On String - When the record was created.
- data Property Map
- Components of a CAA record.
- meta String
- Extra Cloudflare-specific information about the record.
- modified
On String - When the record was last modified.
- name String
- DNS record name (or @ for the zone apex) in Punycode.
- priority Number
- Required for MX, SRV and URI records; unused by other record types. Records with lower priorities are preferred.
- proxiable Boolean
- Whether the record can be proxied by Cloudflare or not.
- proxied Boolean
- Whether the record is receiving the performance and security benefits of Cloudflare.
- settings Property Map
- Settings for the DNS record.
- List<String>
- Custom tags for the DNS record. This field has no effect on DNS responses.
- String
- When the record tags were last modified. Omitted if there are no tags.
- ttl Number
- Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.
- type String
- Record type. Available values: "A".
- zone
Id String - Identifier.
Supporting Types
DnsRecordData, DnsRecordDataArgs
- Algorithm double
- Algorithm.
- Altitude double
- Altitude of location in meters.
- Certificate string
- Certificate.
- Digest string
- Digest.
- Digest
Type double - Digest Type.
- Fingerprint string
- fingerprint.
- Flags double
- Flags for the CAA record.
- Key
Tag double - Key Tag.
- Lat
Degrees double - Degrees of latitude.
- Lat
Direction string - Latitude direction. Available values: "N", "S".
- Lat
Minutes double - Minutes of latitude.
- Lat
Seconds double - Seconds of latitude.
- Long
Degrees double - Degrees of longitude.
- Long
Direction string - Longitude direction. Available values: "E", "W".
- Long
Minutes double - Minutes of longitude.
- Long
Seconds double - Seconds of longitude.
- Matching
Type double - Matching Type.
- Order double
- Order.
- Port double
- The port of the service.
- Precision
Horz double - Horizontal precision of location.
- Precision
Vert double - Vertical precision of location.
- Preference double
- Preference.
- Priority double
- priority.
- Protocol double
- Protocol.
- Public
Key string - Public Key.
- Regex string
- Regex.
- Replacement string
- Replacement.
- Selector double
- Selector.
- Service string
- Service.
- Size double
- Size of location in meters.
- Tag string
- Name of the property controlled by this record (e.g.: issue, issuewild, iodef).
- Target string
- target.
- Type double
- Type.
- Usage double
- Usage.
- Value string
- Value of the record. This field's semantics depend on the chosen tag.
- Weight double
- The record weight.
- Algorithm float64
- Algorithm.
- Altitude float64
- Altitude of location in meters.
- Certificate string
- Certificate.
- Digest string
- Digest.
- Digest
Type float64 - Digest Type.
- Fingerprint string
- fingerprint.
- Flags float64
- Flags for the CAA record.
- Key
Tag float64 - Key Tag.
- Lat
Degrees float64 - Degrees of latitude.
- Lat
Direction string - Latitude direction. Available values: "N", "S".
- Lat
Minutes float64 - Minutes of latitude.
- Lat
Seconds float64 - Seconds of latitude.
- Long
Degrees float64 - Degrees of longitude.
- Long
Direction string - Longitude direction. Available values: "E", "W".
- Long
Minutes float64 - Minutes of longitude.
- Long
Seconds float64 - Seconds of longitude.
- Matching
Type float64 - Matching Type.
- Order float64
- Order.
- Port float64
- The port of the service.
- Precision
Horz float64 - Horizontal precision of location.
- Precision
Vert float64 - Vertical precision of location.
- Preference float64
- Preference.
- Priority float64
- priority.
- Protocol float64
- Protocol.
- Public
Key string - Public Key.
- Regex string
- Regex.
- Replacement string
- Replacement.
- Selector float64
- Selector.
- Service string
- Service.
- Size float64
- Size of location in meters.
- Tag string
- Name of the property controlled by this record (e.g.: issue, issuewild, iodef).
- Target string
- target.
- Type float64
- Type.
- Usage float64
- Usage.
- Value string
- Value of the record. This field's semantics depend on the chosen tag.
- Weight float64
- The record weight.
- algorithm Double
- Algorithm.
- altitude Double
- Altitude of location in meters.
- certificate String
- Certificate.
- digest String
- Digest.
- digest
Type Double - Digest Type.
- fingerprint String
- fingerprint.
- flags Double
- Flags for the CAA record.
- key
Tag Double - Key Tag.
- lat
Degrees Double - Degrees of latitude.
- lat
Direction String - Latitude direction. Available values: "N", "S".
- lat
Minutes Double - Minutes of latitude.
- lat
Seconds Double - Seconds of latitude.
- long
Degrees Double - Degrees of longitude.
- long
Direction String - Longitude direction. Available values: "E", "W".
- long
Minutes Double - Minutes of longitude.
- long
Seconds Double - Seconds of longitude.
- matching
Type Double - Matching Type.
- order Double
- Order.
- port Double
- The port of the service.
- precision
Horz Double - Horizontal precision of location.
- precision
Vert Double - Vertical precision of location.
- preference Double
- Preference.
- priority Double
- priority.
- protocol Double
- Protocol.
- public
Key String - Public Key.
- regex String
- Regex.
- replacement String
- Replacement.
- selector Double
- Selector.
- service String
- Service.
- size Double
- Size of location in meters.
- tag String
- Name of the property controlled by this record (e.g.: issue, issuewild, iodef).
- target String
- target.
- type Double
- Type.
- usage Double
- Usage.
- value String
- Value of the record. This field's semantics depend on the chosen tag.
- weight Double
- The record weight.
- algorithm number
- Algorithm.
- altitude number
- Altitude of location in meters.
- certificate string
- Certificate.
- digest string
- Digest.
- digest
Type number - Digest Type.
- fingerprint string
- fingerprint.
- flags number
- Flags for the CAA record.
- key
Tag number - Key Tag.
- lat
Degrees number - Degrees of latitude.
- lat
Direction string - Latitude direction. Available values: "N", "S".
- lat
Minutes number - Minutes of latitude.
- lat
Seconds number - Seconds of latitude.
- long
Degrees number - Degrees of longitude.
- long
Direction string - Longitude direction. Available values: "E", "W".
- long
Minutes number - Minutes of longitude.
- long
Seconds number - Seconds of longitude.
- matching
Type number - Matching Type.
- order number
- Order.
- port number
- The port of the service.
- precision
Horz number - Horizontal precision of location.
- precision
Vert number - Vertical precision of location.
- preference number
- Preference.
- priority number
- priority.
- protocol number
- Protocol.
- public
Key string - Public Key.
- regex string
- Regex.
- replacement string
- Replacement.
- selector number
- Selector.
- service string
- Service.
- size number
- Size of location in meters.
- tag string
- Name of the property controlled by this record (e.g.: issue, issuewild, iodef).
- target string
- target.
- type number
- Type.
- usage number
- Usage.
- value string
- Value of the record. This field's semantics depend on the chosen tag.
- weight number
- The record weight.
- algorithm float
- Algorithm.
- altitude float
- Altitude of location in meters.
- certificate str
- Certificate.
- digest str
- Digest.
- digest_
type float - Digest Type.
- fingerprint str
- fingerprint.
- flags float
- Flags for the CAA record.
- key_
tag float - Key Tag.
- lat_
degrees float - Degrees of latitude.
- lat_
direction str - Latitude direction. Available values: "N", "S".
- lat_
minutes float - Minutes of latitude.
- lat_
seconds float - Seconds of latitude.
- long_
degrees float - Degrees of longitude.
- long_
direction str - Longitude direction. Available values: "E", "W".
- long_
minutes float - Minutes of longitude.
- long_
seconds float - Seconds of longitude.
- matching_
type float - Matching Type.
- order float
- Order.
- port float
- The port of the service.
- precision_
horz float - Horizontal precision of location.
- precision_
vert float - Vertical precision of location.
- preference float
- Preference.
- priority float
- priority.
- protocol float
- Protocol.
- public_
key str - Public Key.
- regex str
- Regex.
- replacement str
- Replacement.
- selector float
- Selector.
- service str
- Service.
- size float
- Size of location in meters.
- tag str
- Name of the property controlled by this record (e.g.: issue, issuewild, iodef).
- target str
- target.
- type float
- Type.
- usage float
- Usage.
- value str
- Value of the record. This field's semantics depend on the chosen tag.
- weight float
- The record weight.
- algorithm Number
- Algorithm.
- altitude Number
- Altitude of location in meters.
- certificate String
- Certificate.
- digest String
- Digest.
- digest
Type Number - Digest Type.
- fingerprint String
- fingerprint.
- flags Number
- Flags for the CAA record.
- key
Tag Number - Key Tag.
- lat
Degrees Number - Degrees of latitude.
- lat
Direction String - Latitude direction. Available values: "N", "S".
- lat
Minutes Number - Minutes of latitude.
- lat
Seconds Number - Seconds of latitude.
- long
Degrees Number - Degrees of longitude.
- long
Direction String - Longitude direction. Available values: "E", "W".
- long
Minutes Number - Minutes of longitude.
- long
Seconds Number - Seconds of longitude.
- matching
Type Number - Matching Type.
- order Number
- Order.
- port Number
- The port of the service.
- precision
Horz Number - Horizontal precision of location.
- precision
Vert Number - Vertical precision of location.
- preference Number
- Preference.
- priority Number
- priority.
- protocol Number
- Protocol.
- public
Key String - Public Key.
- regex String
- Regex.
- replacement String
- Replacement.
- selector Number
- Selector.
- service String
- Service.
- size Number
- Size of location in meters.
- tag String
- Name of the property controlled by this record (e.g.: issue, issuewild, iodef).
- target String
- target.
- type Number
- Type.
- usage Number
- Usage.
- value String
- Value of the record. This field's semantics depend on the chosen tag.
- weight Number
- The record weight.
DnsRecordSettings, DnsRecordSettingsArgs
- Flatten
Cname bool - If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
- Ipv4Only bool
- When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- Ipv6Only bool
- When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- Flatten
Cname bool - If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
- Ipv4Only bool
- When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- Ipv6Only bool
- When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- flatten
Cname Boolean - If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
- ipv4Only Boolean
- When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- ipv6Only Boolean
- When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- flatten
Cname boolean - If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
- ipv4Only boolean
- When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- ipv6Only boolean
- When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- flatten_
cname bool - If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
- ipv4_
only bool - When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- ipv6_
only bool - When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- flatten
Cname Boolean - If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.
- ipv4Only Boolean
- When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
- ipv6Only Boolean
- When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.
Import
$ pulumi import cloudflare:index/dnsRecord:DnsRecord example '<zone_id>/<dns_record_id>'
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Cloudflare pulumi/pulumi-cloudflare
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
cloudflare
Terraform Provider.