Cloudflare v6.1.2, Apr 28 25

Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

cloudflare.Record

Explore with Pulumi AI

Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

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 Record Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Record(name: string, args: RecordArgs, opts?: CustomResourceOptions);

@overload
def Record(resource_name: str,
           args: RecordArgs,
           opts: Optional[ResourceOptions] = None)

@overload
def Record(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           comment: Optional[str] = None,
           content: Optional[str] = None,
           data: Optional[RecordDataArgs] = None,
           name: Optional[str] = None,
           priority: Optional[float] = None,
           proxied: Optional[bool] = None,
           settings: Optional[RecordSettingsArgs] = None,
           tags: Optional[Sequence[str]] = None,
           ttl: Optional[float] = None,
           type: Optional[str] = None,
           zone_id: Optional[str] = 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.

Parameters

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

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The Record 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".
ZoneId 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 RecordData: 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 RecordSettings: Settings for the DNS record.
Tags 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".
ZoneId 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 RecordDataArgs: 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 RecordSettingsArgs: Settings for the DNS record.
Tags []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".
zoneId 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 RecordData: 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 RecordSettings: Settings for the DNS record.
tags 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".
zoneId 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 RecordData: 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 RecordSettings: Settings for the DNS record.
tags 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 RecordDataArgs: 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 RecordSettingsArgs: Settings for the DNS record.
tags 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".
zoneId 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.
tags 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 Record resource produces the following output properties:

CommentModifiedOn string: When the record comment was last modified. Omitted if there is no comment.
CreatedOn 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.
ModifiedOn string: When the record was last modified.
Proxiable bool: Whether the record can be proxied by Cloudflare or not.
TagsModifiedOn string: When the record tags were last modified. Omitted if there are no tags.

CommentModifiedOn string: When the record comment was last modified. Omitted if there is no comment.
CreatedOn 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.
ModifiedOn string: When the record was last modified.
Proxiable bool: Whether the record can be proxied by Cloudflare or not.
TagsModifiedOn string: When the record tags were last modified. Omitted if there are no tags.

commentModifiedOn String: When the record comment was last modified. Omitted if there is no comment.
createdOn 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.
modifiedOn String: When the record was last modified.
proxiable Boolean: Whether the record can be proxied by Cloudflare or not.
tagsModifiedOn String: When the record tags were last modified. Omitted if there are no tags.

commentModifiedOn string: When the record comment was last modified. Omitted if there is no comment.
createdOn 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.
modifiedOn string: When the record was last modified.
proxiable boolean: Whether the record can be proxied by Cloudflare or not.
tagsModifiedOn string: When the record tags were last modified. Omitted if there are no tags.

comment_modified_on str: 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.
tags_modified_on str: When the record tags were last modified. Omitted if there are no tags.

commentModifiedOn String: When the record comment was last modified. Omitted if there is no comment.
createdOn 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.
modifiedOn String: When the record was last modified.
proxiable Boolean: Whether the record can be proxied by Cloudflare or not.
tagsModifiedOn String: When the record tags were last modified. Omitted if there are no tags.

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,
        comment: Optional[str] = None,
        comment_modified_on: Optional[str] = None,
        content: Optional[str] = None,
        created_on: Optional[str] = None,
        data: Optional[RecordDataArgs] = 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[RecordSettingsArgs] = 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) -> 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)

resources:  _:    type: cloudflare:Record    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.

The following state arguments are supported:

Comment string: Comments or notes about the DNS record. This field has no effect on DNS responses.
CommentModifiedOn string: When the record comment was last modified. Omitted if there is no comment.
Content string: A valid IPv4 address.
CreatedOn string: When the record was created.
Data RecordData: Components of a CAA record.
Meta string: Extra Cloudflare-specific information about the record.
ModifiedOn 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 RecordSettings: Settings for the DNS record.
Tags List<string>: Custom tags for the DNS record. This field has no effect on DNS responses.
TagsModifiedOn 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".
ZoneId string: Identifier.

Comment string: Comments or notes about the DNS record. This field has no effect on DNS responses.
CommentModifiedOn string: When the record comment was last modified. Omitted if there is no comment.
Content string: A valid IPv4 address.
CreatedOn string: When the record was created.
Data RecordDataArgs: Components of a CAA record.
Meta string: Extra Cloudflare-specific information about the record.
ModifiedOn 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 RecordSettingsArgs: Settings for the DNS record.
Tags []string: Custom tags for the DNS record. This field has no effect on DNS responses.
TagsModifiedOn 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".
ZoneId string: Identifier.

comment String: Comments or notes about the DNS record. This field has no effect on DNS responses.
commentModifiedOn String: When the record comment was last modified. Omitted if there is no comment.
content String: A valid IPv4 address.
createdOn String: When the record was created.
data RecordData: Components of a CAA record.
meta String: Extra Cloudflare-specific information about the record.
modifiedOn 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 RecordSettings: Settings for the DNS record.
tags List<String>: Custom tags for the DNS record. This field has no effect on DNS responses.
tagsModifiedOn 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".
zoneId String: Identifier.

comment string: Comments or notes about the DNS record. This field has no effect on DNS responses.
commentModifiedOn string: When the record comment was last modified. Omitted if there is no comment.
content string: A valid IPv4 address.
createdOn string: When the record was created.
data RecordData: Components of a CAA record.
meta string: Extra Cloudflare-specific information about the record.
modifiedOn 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 RecordSettings: Settings for the DNS record.
tags string[]: Custom tags for the DNS record. This field has no effect on DNS responses.
tagsModifiedOn 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".
zoneId string: Identifier.

comment str: Comments or notes about the DNS record. This field has no effect on DNS responses.
comment_modified_on str: 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 RecordDataArgs: 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 RecordSettingsArgs: Settings for the DNS record.
tags Sequence[str]: Custom tags for the DNS record. This field has no effect on DNS responses.
tags_modified_on 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.
commentModifiedOn String: When the record comment was last modified. Omitted if there is no comment.
content String: A valid IPv4 address.
createdOn String: When the record was created.
data Property Map: Components of a CAA record.
meta String: Extra Cloudflare-specific information about the record.
modifiedOn 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.
tags List<String>: Custom tags for the DNS record. This field has no effect on DNS responses.
tagsModifiedOn 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".
zoneId String: Identifier.

Supporting Types

RecordData, RecordDataArgs

Algorithm double: Algorithm.
Altitude double: Altitude of location in meters.
Certificate string: Certificate.
Digest string: Digest.
DigestType double: Digest Type.
Fingerprint string: fingerprint.
Flags double: Flags for the CAA record.
KeyTag double: Key Tag.
LatDegrees double: Degrees of latitude.
LatDirection string: Latitude direction. Available values: "N", "S".
LatMinutes double: Minutes of latitude.
LatSeconds double: Seconds of latitude.
LongDegrees double: Degrees of longitude.
LongDirection string: Longitude direction. Available values: "E", "W".
LongMinutes double: Minutes of longitude.
LongSeconds double: Seconds of longitude.
MatchingType double: Matching Type.
Order double: Order.
Port double: The port of the service.
PrecisionHorz double: Horizontal precision of location.
PrecisionVert double: Vertical precision of location.
Preference double: Preference.
Priority double: priority.
Protocol double: Protocol.
PublicKey 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.
DigestType float64: Digest Type.
Fingerprint string: fingerprint.
Flags float64: Flags for the CAA record.
KeyTag float64: Key Tag.
LatDegrees float64: Degrees of latitude.
LatDirection string: Latitude direction. Available values: "N", "S".
LatMinutes float64: Minutes of latitude.
LatSeconds float64: Seconds of latitude.
LongDegrees float64: Degrees of longitude.
LongDirection string: Longitude direction. Available values: "E", "W".
LongMinutes float64: Minutes of longitude.
LongSeconds float64: Seconds of longitude.
MatchingType float64: Matching Type.
Order float64: Order.
Port float64: The port of the service.
PrecisionHorz float64: Horizontal precision of location.
PrecisionVert float64: Vertical precision of location.
Preference float64: Preference.
Priority float64: priority.
Protocol float64: Protocol.
PublicKey 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.
digestType Double: Digest Type.
fingerprint String: fingerprint.
flags Double: Flags for the CAA record.
keyTag Double: Key Tag.
latDegrees Double: Degrees of latitude.
latDirection String: Latitude direction. Available values: "N", "S".
latMinutes Double: Minutes of latitude.
latSeconds Double: Seconds of latitude.
longDegrees Double: Degrees of longitude.
longDirection String: Longitude direction. Available values: "E", "W".
longMinutes Double: Minutes of longitude.
longSeconds Double: Seconds of longitude.
matchingType Double: Matching Type.
order Double: Order.
port Double: The port of the service.
precisionHorz Double: Horizontal precision of location.
precisionVert Double: Vertical precision of location.
preference Double: Preference.
priority Double: priority.
protocol Double: Protocol.
publicKey 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.
digestType number: Digest Type.
fingerprint string: fingerprint.
flags number: Flags for the CAA record.
keyTag number: Key Tag.
latDegrees number: Degrees of latitude.
latDirection string: Latitude direction. Available values: "N", "S".
latMinutes number: Minutes of latitude.
latSeconds number: Seconds of latitude.
longDegrees number: Degrees of longitude.
longDirection string: Longitude direction. Available values: "E", "W".
longMinutes number: Minutes of longitude.
longSeconds number: Seconds of longitude.
matchingType number: Matching Type.
order number: Order.
port number: The port of the service.
precisionHorz number: Horizontal precision of location.
precisionVert number: Vertical precision of location.
preference number: Preference.
priority number: priority.
protocol number: Protocol.
publicKey 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.
digestType Number: Digest Type.
fingerprint String: fingerprint.
flags Number: Flags for the CAA record.
keyTag Number: Key Tag.
latDegrees Number: Degrees of latitude.
latDirection String: Latitude direction. Available values: "N", "S".
latMinutes Number: Minutes of latitude.
latSeconds Number: Seconds of latitude.
longDegrees Number: Degrees of longitude.
longDirection String: Longitude direction. Available values: "E", "W".
longMinutes Number: Minutes of longitude.
longSeconds Number: Seconds of longitude.
matchingType Number: Matching Type.
order Number: Order.
port Number: The port of the service.
precisionHorz Number: Horizontal precision of location.
precisionVert Number: Vertical precision of location.
preference Number: Preference.
priority Number: priority.
protocol Number: Protocol.
publicKey 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.

RecordSettings, RecordSettingsArgs

FlattenCname 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.

FlattenCname 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.

flattenCname 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.

flattenCname 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.

flattenCname 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/record:Record 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.

Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

pulumi/pulumi-cloudflare

cloudflare.Record

On this page

On this page

Example Usage

Create Record Resource

Constructor syntax

Parameters

Record Resource Properties

Inputs

Outputs

Look up Existing Record Resource

Supporting Types

RecordData, RecordDataArgs

RecordSettings, RecordSettingsArgs

Import

Package Details

On this page

On this page