Cloudflare v6.1.2, Apr 28 25

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

cloudflare.AccountDnsSettings

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:
  exampleAccountDnsSettings:
    type: cloudflare:AccountDnsSettings
    name: example_account_dns_settings
    properties:
      accountId: 023e105f4ecef8ad9ca31a8372d0c353
      zoneDefaults:
        flatten_all_cnames: false
        foundation_dns: false
        internal_dns:
          referenceZoneId: reference_zone_id
        multi_provider: false
        nameservers:
          type: cloudflare.standard
        ns_ttl: 86400
        secondary_overrides: false
        soa:
          expire: 604800
          minTtl: 1800
          mname: kristina.ns.cloudflare.com
          refresh: 10000
          retry: 2400
          rname: admin.example.com
          ttl: 3600
        zone_mode: dns_only

Create AccountDnsSettings Resource

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

Constructor syntax

new AccountDnsSettings(name: string, args: AccountDnsSettingsArgs, opts?: CustomResourceOptions);

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

@overload
def AccountDnsSettings(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       account_id: Optional[str] = None,
                       zone_defaults: Optional[AccountDnsSettingsZoneDefaultsArgs] = None)

func NewAccountDnsSettings(ctx *Context, name string, args AccountDnsSettingsArgs, opts ...ResourceOption) (*AccountDnsSettings, error)

public AccountDnsSettings(string name, AccountDnsSettingsArgs args, CustomResourceOptions? opts = null)

public AccountDnsSettings(String name, AccountDnsSettingsArgs args)
public AccountDnsSettings(String name, AccountDnsSettingsArgs args, CustomResourceOptions options)

type: cloudflare:AccountDnsSettings
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 AccountDnsSettingsArgs: 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 AccountDnsSettingsArgs: 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 AccountDnsSettingsArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args AccountDnsSettingsArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args AccountDnsSettingsArgs: 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 accountDnsSettingsResource = new Cloudflare.AccountDnsSettings("accountDnsSettingsResource", new()
{
    AccountId = "string",
    ZoneDefaults = new Cloudflare.Inputs.AccountDnsSettingsZoneDefaultsArgs
    {
        FlattenAllCnames = false,
        FoundationDns = false,
        InternalDns = new Cloudflare.Inputs.AccountDnsSettingsZoneDefaultsInternalDnsArgs
        {
            ReferenceZoneId = "string",
        },
        MultiProvider = false,
        Nameservers = new Cloudflare.Inputs.AccountDnsSettingsZoneDefaultsNameserversArgs
        {
            Type = "string",
        },
        NsTtl = 0,
        SecondaryOverrides = false,
        Soa = new Cloudflare.Inputs.AccountDnsSettingsZoneDefaultsSoaArgs
        {
            Expire = 0,
            MinTtl = 0,
            Mname = "string",
            Refresh = 0,
            Retry = 0,
            Rname = "string",
            Ttl = 0,
        },
        ZoneMode = "string",
    },
});

example, err := cloudflare.NewAccountDnsSettings(ctx, "accountDnsSettingsResource", &cloudflare.AccountDnsSettingsArgs{
	AccountId: pulumi.String("string"),
	ZoneDefaults: &cloudflare.AccountDnsSettingsZoneDefaultsArgs{
		FlattenAllCnames: pulumi.Bool(false),
		FoundationDns:    pulumi.Bool(false),
		InternalDns: &cloudflare.AccountDnsSettingsZoneDefaultsInternalDnsArgs{
			ReferenceZoneId: pulumi.String("string"),
		},
		MultiProvider: pulumi.Bool(false),
		Nameservers: &cloudflare.AccountDnsSettingsZoneDefaultsNameserversArgs{
			Type: pulumi.String("string"),
		},
		NsTtl:              pulumi.Float64(0),
		SecondaryOverrides: pulumi.Bool(false),
		Soa: &cloudflare.AccountDnsSettingsZoneDefaultsSoaArgs{
			Expire:  pulumi.Float64(0),
			MinTtl:  pulumi.Float64(0),
			Mname:   pulumi.String("string"),
			Refresh: pulumi.Float64(0),
			Retry:   pulumi.Float64(0),
			Rname:   pulumi.String("string"),
			Ttl:     pulumi.Float64(0),
		},
		ZoneMode: pulumi.String("string"),
	},
})

var accountDnsSettingsResource = new AccountDnsSettings("accountDnsSettingsResource", AccountDnsSettingsArgs.builder()
    .accountId("string")
    .zoneDefaults(AccountDnsSettingsZoneDefaultsArgs.builder()
        .flattenAllCnames(false)
        .foundationDns(false)
        .internalDns(AccountDnsSettingsZoneDefaultsInternalDnsArgs.builder()
            .referenceZoneId("string")
            .build())
        .multiProvider(false)
        .nameservers(AccountDnsSettingsZoneDefaultsNameserversArgs.builder()
            .type("string")
            .build())
        .nsTtl(0)
        .secondaryOverrides(false)
        .soa(AccountDnsSettingsZoneDefaultsSoaArgs.builder()
            .expire(0)
            .minTtl(0)
            .mname("string")
            .refresh(0)
            .retry(0)
            .rname("string")
            .ttl(0)
            .build())
        .zoneMode("string")
        .build())
    .build());

account_dns_settings_resource = cloudflare.AccountDnsSettings("accountDnsSettingsResource",
    account_id="string",
    zone_defaults={
        "flatten_all_cnames": False,
        "foundation_dns": False,
        "internal_dns": {
            "reference_zone_id": "string",
        },
        "multi_provider": False,
        "nameservers": {
            "type": "string",
        },
        "ns_ttl": 0,
        "secondary_overrides": False,
        "soa": {
            "expire": 0,
            "min_ttl": 0,
            "mname": "string",
            "refresh": 0,
            "retry": 0,
            "rname": "string",
            "ttl": 0,
        },
        "zone_mode": "string",
    })

const accountDnsSettingsResource = new cloudflare.AccountDnsSettings("accountDnsSettingsResource", {
    accountId: "string",
    zoneDefaults: {
        flattenAllCnames: false,
        foundationDns: false,
        internalDns: {
            referenceZoneId: "string",
        },
        multiProvider: false,
        nameservers: {
            type: "string",
        },
        nsTtl: 0,
        secondaryOverrides: false,
        soa: {
            expire: 0,
            minTtl: 0,
            mname: "string",
            refresh: 0,
            retry: 0,
            rname: "string",
            ttl: 0,
        },
        zoneMode: "string",
    },
});

type: cloudflare:AccountDnsSettings
properties:
    accountId: string
    zoneDefaults:
        flattenAllCnames: false
        foundationDns: false
        internalDns:
            referenceZoneId: string
        multiProvider: false
        nameservers:
            type: string
        nsTtl: 0
        secondaryOverrides: false
        soa:
            expire: 0
            minTtl: 0
            mname: string
            refresh: 0
            retry: 0
            rname: string
            ttl: 0
        zoneMode: string

AccountDnsSettings 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 AccountDnsSettings resource accepts the following input properties:

AccountId string: Identifier
ZoneDefaults AccountDnsSettingsZoneDefaults

AccountId string: Identifier
ZoneDefaults AccountDnsSettingsZoneDefaultsArgs

accountId String: Identifier
zoneDefaults AccountDnsSettingsZoneDefaults

accountId string: Identifier
zoneDefaults AccountDnsSettingsZoneDefaults

account_id str: Identifier
zone_defaults AccountDnsSettingsZoneDefaultsArgs

accountId String: Identifier
zoneDefaults Property Map

Outputs

All input properties are implicitly available as output properties. Additionally, the AccountDnsSettings resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.

Id string: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

id string: The provider-assigned unique ID for this managed resource.

id str: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

Look up Existing AccountDnsSettings Resource

Get an existing AccountDnsSettings 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?: AccountDnsSettingsState, opts?: CustomResourceOptions): AccountDnsSettings

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[str] = None,
        zone_defaults: Optional[AccountDnsSettingsZoneDefaultsArgs] = None) -> AccountDnsSettings

func GetAccountDnsSettings(ctx *Context, name string, id IDInput, state *AccountDnsSettingsState, opts ...ResourceOption) (*AccountDnsSettings, error)

public static AccountDnsSettings Get(string name, Input<string> id, AccountDnsSettingsState? state, CustomResourceOptions? opts = null)

public static AccountDnsSettings get(String name, Output<String> id, AccountDnsSettingsState state, CustomResourceOptions options)

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

AccountId string: Identifier
ZoneDefaults AccountDnsSettingsZoneDefaults

AccountId string: Identifier
ZoneDefaults AccountDnsSettingsZoneDefaultsArgs

accountId String: Identifier
zoneDefaults AccountDnsSettingsZoneDefaults

accountId string: Identifier
zoneDefaults AccountDnsSettingsZoneDefaults

account_id str: Identifier
zone_defaults AccountDnsSettingsZoneDefaultsArgs

accountId String: Identifier
zoneDefaults Property Map

Supporting Types

AccountDnsSettingsZoneDefaults, AccountDnsSettingsZoneDefaultsArgs

FlattenAllCnames bool: Whether to flatten all CNAME records in the zone. Note that, due to DNS limitations, a CNAME record at the zone apex will always be flattened.
FoundationDns bool: Whether to enable Foundation DNS Advanced Nameservers on the zone.
InternalDns AccountDnsSettingsZoneDefaultsInternalDns: Settings for this internal zone.
MultiProvider bool: Whether to enable multi-provider DNS, which causes Cloudflare to activate the zone even when non-Cloudflare NS records exist, and to respect NS records at the zone apex during outbound zone transfers.
Nameservers AccountDnsSettingsZoneDefaultsNameservers: Settings determining the nameservers through which the zone should be available.
NsTtl double: The time to live (TTL) of the zone's nameserver (NS) records.
SecondaryOverrides bool: Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
Soa AccountDnsSettingsZoneDefaultsSoa: Components of the zone's SOA record.
ZoneMode string: Whether the zone mode is a regular or CDN/DNS only zone. Available values: "standard", "cdnonly", "dnsonly".

FlattenAllCnames bool: Whether to flatten all CNAME records in the zone. Note that, due to DNS limitations, a CNAME record at the zone apex will always be flattened.
FoundationDns bool: Whether to enable Foundation DNS Advanced Nameservers on the zone.
InternalDns AccountDnsSettingsZoneDefaultsInternalDns: Settings for this internal zone.
MultiProvider bool: Whether to enable multi-provider DNS, which causes Cloudflare to activate the zone even when non-Cloudflare NS records exist, and to respect NS records at the zone apex during outbound zone transfers.
Nameservers AccountDnsSettingsZoneDefaultsNameservers: Settings determining the nameservers through which the zone should be available.
NsTtl float64: The time to live (TTL) of the zone's nameserver (NS) records.
SecondaryOverrides bool: Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
Soa AccountDnsSettingsZoneDefaultsSoa: Components of the zone's SOA record.
ZoneMode string: Whether the zone mode is a regular or CDN/DNS only zone. Available values: "standard", "cdnonly", "dnsonly".

flattenAllCnames Boolean: Whether to flatten all CNAME records in the zone. Note that, due to DNS limitations, a CNAME record at the zone apex will always be flattened.
foundationDns Boolean: Whether to enable Foundation DNS Advanced Nameservers on the zone.
internalDns AccountDnsSettingsZoneDefaultsInternalDns: Settings for this internal zone.
multiProvider Boolean: Whether to enable multi-provider DNS, which causes Cloudflare to activate the zone even when non-Cloudflare NS records exist, and to respect NS records at the zone apex during outbound zone transfers.
nameservers AccountDnsSettingsZoneDefaultsNameservers: Settings determining the nameservers through which the zone should be available.
nsTtl Double: The time to live (TTL) of the zone's nameserver (NS) records.
secondaryOverrides Boolean: Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa AccountDnsSettingsZoneDefaultsSoa: Components of the zone's SOA record.
zoneMode String: Whether the zone mode is a regular or CDN/DNS only zone. Available values: "standard", "cdnonly", "dnsonly".

flattenAllCnames boolean: Whether to flatten all CNAME records in the zone. Note that, due to DNS limitations, a CNAME record at the zone apex will always be flattened.
foundationDns boolean: Whether to enable Foundation DNS Advanced Nameservers on the zone.
internalDns AccountDnsSettingsZoneDefaultsInternalDns: Settings for this internal zone.
multiProvider boolean: Whether to enable multi-provider DNS, which causes Cloudflare to activate the zone even when non-Cloudflare NS records exist, and to respect NS records at the zone apex during outbound zone transfers.
nameservers AccountDnsSettingsZoneDefaultsNameservers: Settings determining the nameservers through which the zone should be available.
nsTtl number: The time to live (TTL) of the zone's nameserver (NS) records.
secondaryOverrides boolean: Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa AccountDnsSettingsZoneDefaultsSoa: Components of the zone's SOA record.
zoneMode string: Whether the zone mode is a regular or CDN/DNS only zone. Available values: "standard", "cdnonly", "dnsonly".

flatten_all_cnames bool: Whether to flatten all CNAME records in the zone. Note that, due to DNS limitations, a CNAME record at the zone apex will always be flattened.
foundation_dns bool: Whether to enable Foundation DNS Advanced Nameservers on the zone.
internal_dns AccountDnsSettingsZoneDefaultsInternalDns: Settings for this internal zone.
multi_provider bool: Whether to enable multi-provider DNS, which causes Cloudflare to activate the zone even when non-Cloudflare NS records exist, and to respect NS records at the zone apex during outbound zone transfers.
nameservers AccountDnsSettingsZoneDefaultsNameservers: Settings determining the nameservers through which the zone should be available.
ns_ttl float: The time to live (TTL) of the zone's nameserver (NS) records.
secondary_overrides bool: Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa AccountDnsSettingsZoneDefaultsSoa: Components of the zone's SOA record.
zone_mode str: Whether the zone mode is a regular or CDN/DNS only zone. Available values: "standard", "cdnonly", "dnsonly".

flattenAllCnames Boolean: Whether to flatten all CNAME records in the zone. Note that, due to DNS limitations, a CNAME record at the zone apex will always be flattened.
foundationDns Boolean: Whether to enable Foundation DNS Advanced Nameservers on the zone.
internalDns Property Map: Settings for this internal zone.
multiProvider Boolean: Whether to enable multi-provider DNS, which causes Cloudflare to activate the zone even when non-Cloudflare NS records exist, and to respect NS records at the zone apex during outbound zone transfers.
nameservers Property Map: Settings determining the nameservers through which the zone should be available.
nsTtl Number: The time to live (TTL) of the zone's nameserver (NS) records.
secondaryOverrides Boolean: Allows a Secondary DNS zone to use (proxied) override records and CNAME flattening at the zone apex.
soa Property Map: Components of the zone's SOA record.
zoneMode String: Whether the zone mode is a regular or CDN/DNS only zone. Available values: "standard", "cdnonly", "dnsonly".

AccountDnsSettingsZoneDefaultsInternalDns, AccountDnsSettingsZoneDefaultsInternalDnsArgs

ReferenceZoneId string: The ID of the zone to fallback to.

ReferenceZoneId string: The ID of the zone to fallback to.

referenceZoneId String: The ID of the zone to fallback to.

referenceZoneId string: The ID of the zone to fallback to.

reference_zone_id str: The ID of the zone to fallback to.

referenceZoneId String: The ID of the zone to fallback to.

AccountDnsSettingsZoneDefaultsNameservers, AccountDnsSettingsZoneDefaultsNameserversArgs

Type string: Nameserver type Available values: "cloudflare.standard", "cloudflare.standard.random", "custom.account", "custom.tenant".

Type string: Nameserver type Available values: "cloudflare.standard", "cloudflare.standard.random", "custom.account", "custom.tenant".

type String: Nameserver type Available values: "cloudflare.standard", "cloudflare.standard.random", "custom.account", "custom.tenant".

type string: Nameserver type Available values: "cloudflare.standard", "cloudflare.standard.random", "custom.account", "custom.tenant".

type str: Nameserver type Available values: "cloudflare.standard", "cloudflare.standard.random", "custom.account", "custom.tenant".

type String: Nameserver type Available values: "cloudflare.standard", "cloudflare.standard.random", "custom.account", "custom.tenant".

AccountDnsSettingsZoneDefaultsSoa, AccountDnsSettingsZoneDefaultsSoaArgs

Expire double: Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
MinTtl double: The time to live (TTL) for negative caching of records within the zone.
Mname string: The primary nameserver, which may be used for outbound zone transfers.
Refresh double: Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
Retry double: Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
Rname string: The email address of the zone administrator, with the first label representing the local part of the email address.
Ttl double: The time to live (TTL) of the SOA record itself.

Expire float64: Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
MinTtl float64: The time to live (TTL) for negative caching of records within the zone.
Mname string: The primary nameserver, which may be used for outbound zone transfers.
Refresh float64: Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
Retry float64: Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
Rname string: The email address of the zone administrator, with the first label representing the local part of the email address.
Ttl float64: The time to live (TTL) of the SOA record itself.

expire Double: Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
minTtl Double: The time to live (TTL) for negative caching of records within the zone.
mname String: The primary nameserver, which may be used for outbound zone transfers.
refresh Double: Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
retry Double: Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
rname String: The email address of the zone administrator, with the first label representing the local part of the email address.
ttl Double: The time to live (TTL) of the SOA record itself.

expire number: Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
minTtl number: The time to live (TTL) for negative caching of records within the zone.
mname string: The primary nameserver, which may be used for outbound zone transfers.
refresh number: Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
retry number: Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
rname string: The email address of the zone administrator, with the first label representing the local part of the email address.
ttl number: The time to live (TTL) of the SOA record itself.

expire float: Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
min_ttl float: The time to live (TTL) for negative caching of records within the zone.
mname str: The primary nameserver, which may be used for outbound zone transfers.
refresh float: Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
retry float: Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
rname str: The email address of the zone administrator, with the first label representing the local part of the email address.
ttl float: The time to live (TTL) of the SOA record itself.

expire Number: Time in seconds of being unable to query the primary server after which secondary servers should stop serving the zone.
minTtl Number: The time to live (TTL) for negative caching of records within the zone.
mname String: The primary nameserver, which may be used for outbound zone transfers.
refresh Number: Time in seconds after which secondary servers should re-check the SOA record to see if the zone has been updated.
retry Number: Time in seconds after which secondary servers should retry queries after the primary server was unresponsive.
rname String: The email address of the zone administrator, with the first label representing the local part of the email address.
ttl Number: The time to live (TTL) of the SOA record itself.

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

On this page

On this page

Example Usage

Create AccountDnsSettings Resource

Constructor syntax

Parameters

Constructor example

AccountDnsSettings Resource Properties

Inputs

Outputs

Look up Existing AccountDnsSettings Resource

Supporting Types

AccountDnsSettingsZoneDefaults, AccountDnsSettingsZoneDefaultsArgs

AccountDnsSettingsZoneDefaultsInternalDns, AccountDnsSettingsZoneDefaultsInternalDnsArgs

AccountDnsSettingsZoneDefaultsNameservers, AccountDnsSettingsZoneDefaultsNameserversArgs

AccountDnsSettingsZoneDefaultsSoa, AccountDnsSettingsZoneDefaultsSoaArgs

Package Details

On this page

On this page