1. Packages
  2. Cloudflare Provider
  3. API Docs
  4. DnsRecord
Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

cloudflare.DnsRecord

Explore with Pulumi AI

cloudflare logo
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 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".
    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 DnsRecordData
    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 DnsRecordSettings
    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 DnsRecordDataArgs
    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 DnsRecordSettingsArgs
    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 DnsRecordData
    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 DnsRecordSettings
    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 DnsRecordData
    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 DnsRecordSettings
    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 DnsRecordDataArgs
    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 DnsRecordSettingsArgs
    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 DnsRecord 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 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.
    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 DnsRecordData
    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 DnsRecordSettings
    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 DnsRecordDataArgs
    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 DnsRecordSettingsArgs
    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 DnsRecordData
    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 DnsRecordSettings
    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 DnsRecordData
    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 DnsRecordSettings
    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 DnsRecordDataArgs
    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 DnsRecordSettingsArgs
    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

    DnsRecordData, DnsRecordDataArgs

    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.

    DnsRecordSettings, DnsRecordSettingsArgs

    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/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.
    cloudflare logo
    Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi