1. Packages
  2. Cloudflare Provider
  3. API Docs
  4. ZoneSetting
Cloudflare v6.10.1 published on Wednesday, Oct 22, 2025 by Pulumi
pulumi/pulumi-cloudflare

cloudflare.ZoneSetting

Get Started
cloudflare logo
Cloudflare v6.10.1 published on Wednesday, Oct 22, 2025 by Pulumi
pulumi/pulumi-cloudflare

    If using the ssl_recommender zone setting, use the enabled attribute instead of value.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";

const exampleZoneSetting = new cloudflare.ZoneSetting("example_zone_setting", {
    zoneId: "023e105f4ecef8ad9ca31a8372d0c353",
    settingId: "always_online",
    value: "on",
});

    import pulumi
import pulumi_cloudflare as cloudflare

example_zone_setting = cloudflare.ZoneSetting("example_zone_setting",
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    setting_id="always_online",
    value="on")

    package main

import (
	"github.com/pulumi/pulumi-cloudflare/sdk/v6/go/cloudflare"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudflare.NewZoneSetting(ctx, "example_zone_setting", &cloudflare.ZoneSettingArgs{
			ZoneId:    pulumi.String("023e105f4ecef8ad9ca31a8372d0c353"),
			SettingId: pulumi.String("always_online"),
			Value:     pulumi.Any("on"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Cloudflare = Pulumi.Cloudflare;

return await Deployment.RunAsync(() => 
{
    var exampleZoneSetting = new Cloudflare.ZoneSetting("example_zone_setting", new()
    {
        ZoneId = "023e105f4ecef8ad9ca31a8372d0c353",
        SettingId = "always_online",
        Value = "on",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.cloudflare.ZoneSetting;
import com.pulumi.cloudflare.ZoneSettingArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var exampleZoneSetting = new ZoneSetting("exampleZoneSetting", ZoneSettingArgs.builder()
            .zoneId("023e105f4ecef8ad9ca31a8372d0c353")
            .settingId("always_online")
            .value("on")
            .build());

    }
}

    resources:
  exampleZoneSetting:
    type: cloudflare:ZoneSetting
    name: example_zone_setting
    properties:
      zoneId: 023e105f4ecef8ad9ca31a8372d0c353
      settingId: always_online
      value: on

    Create ZoneSetting Resource

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

    Constructor syntax

    new ZoneSetting(name: string, args: ZoneSettingArgs, opts?: CustomResourceOptions);
    @overload
def ZoneSetting(resource_name: str,
                args: ZoneSettingArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def ZoneSetting(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                setting_id: Optional[str] = None,
                value: Optional[Any] = None,
                zone_id: Optional[str] = None,
                enabled: Optional[bool] = None)
    func NewZoneSetting(ctx *Context, name string, args ZoneSettingArgs, opts ...ResourceOption) (*ZoneSetting, error)
    public ZoneSetting(string name, ZoneSettingArgs args, CustomResourceOptions? opts = null)
    public ZoneSetting(String name, ZoneSettingArgs args)
public ZoneSetting(String name, ZoneSettingArgs args, CustomResourceOptions options)

    type: cloudflare:ZoneSetting
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 ZoneSettingArgs
    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 ZoneSettingArgs
    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 ZoneSettingArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ZoneSettingArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ZoneSettingArgs
    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 zoneSettingResource = new Cloudflare.ZoneSetting("zoneSettingResource", new()
{
    SettingId = "string",
    Value = "any",
    ZoneId = "string",
    Enabled = false,
});

    example, err := cloudflare.NewZoneSetting(ctx, "zoneSettingResource", &cloudflare.ZoneSettingArgs{
	SettingId: pulumi.String("string"),
	Value:     pulumi.Any("any"),
	ZoneId:    pulumi.String("string"),
	Enabled:   pulumi.Bool(false),
})

    var zoneSettingResource = new ZoneSetting("zoneSettingResource", ZoneSettingArgs.builder()
    .settingId("string")
    .value("any")
    .zoneId("string")
    .enabled(false)
    .build());

    zone_setting_resource = cloudflare.ZoneSetting("zoneSettingResource",
    setting_id="string",
    value="any",
    zone_id="string",
    enabled=False)

    const zoneSettingResource = new cloudflare.ZoneSetting("zoneSettingResource", {
    settingId: "string",
    value: "any",
    zoneId: "string",
    enabled: false,
});

    type: cloudflare:ZoneSetting
properties:
    enabled: false
    settingId: string
    value: any
    zoneId: string

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

    SettingId string
    Setting name
    Value object
    Current value of the zone setting.
    ZoneId string
    Identifier
    Enabled bool
    ssl-recommender enrollment setting.
    SettingId string
    Setting name
    Value interface{}
    Current value of the zone setting.
    ZoneId string
    Identifier
    Enabled bool
    ssl-recommender enrollment setting.
    settingId String
    Setting name
    value Object
    Current value of the zone setting.
    zoneId String
    Identifier
    enabled Boolean
    ssl-recommender enrollment setting.
    settingId string
    Setting name
    value any
    Current value of the zone setting.
    zoneId string
    Identifier
    enabled boolean
    ssl-recommender enrollment setting.
    setting_id str
    Setting name
    value Any
    Current value of the zone setting.
    zone_id str
    Identifier
    enabled bool
    ssl-recommender enrollment setting.
    settingId String
    Setting name
    value Any
    Current value of the zone setting.
    zoneId String
    Identifier
    enabled Boolean
    ssl-recommender enrollment setting.

    Outputs

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

    Editable bool
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    Id string
    The provider-assigned unique ID for this managed resource.
    ModifiedOn string
    last time this setting was modified.
    TimeRemaining double
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    Editable bool
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    Id string
    The provider-assigned unique ID for this managed resource.
    ModifiedOn string
    last time this setting was modified.
    TimeRemaining float64
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    editable Boolean
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    id String
    The provider-assigned unique ID for this managed resource.
    modifiedOn String
    last time this setting was modified.
    timeRemaining Double
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    editable boolean
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    id string
    The provider-assigned unique ID for this managed resource.
    modifiedOn string
    last time this setting was modified.
    timeRemaining number
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    editable bool
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    id str
    The provider-assigned unique ID for this managed resource.
    modified_on str
    last time this setting was modified.
    time_remaining float
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    editable Boolean
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    id String
    The provider-assigned unique ID for this managed resource.
    modifiedOn String
    last time this setting was modified.
    timeRemaining Number
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.

    Look up Existing ZoneSetting Resource

    Get an existing ZoneSetting 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?: ZoneSettingState, opts?: CustomResourceOptions): ZoneSetting
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        editable: Optional[bool] = None,
        enabled: Optional[bool] = None,
        modified_on: Optional[str] = None,
        setting_id: Optional[str] = None,
        time_remaining: Optional[float] = None,
        value: Optional[Any] = None,
        zone_id: Optional[str] = None) -> ZoneSetting
    func GetZoneSetting(ctx *Context, name string, id IDInput, state *ZoneSettingState, opts ...ResourceOption) (*ZoneSetting, error)
    public static ZoneSetting Get(string name, Input<string> id, ZoneSettingState? state, CustomResourceOptions? opts = null)
    public static ZoneSetting get(String name, Output<String> id, ZoneSettingState state, CustomResourceOptions options)
    resources:  _:    type: cloudflare:ZoneSetting    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:
    Editable bool
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    Enabled bool
    ssl-recommender enrollment setting.
    ModifiedOn string
    last time this setting was modified.
    SettingId string
    Setting name
    TimeRemaining double
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    Value object
    Current value of the zone setting.
    ZoneId string
    Identifier
    Editable bool
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    Enabled bool
    ssl-recommender enrollment setting.
    ModifiedOn string
    last time this setting was modified.
    SettingId string
    Setting name
    TimeRemaining float64
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    Value interface{}
    Current value of the zone setting.
    ZoneId string
    Identifier
    editable Boolean
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    enabled Boolean
    ssl-recommender enrollment setting.
    modifiedOn String
    last time this setting was modified.
    settingId String
    Setting name
    timeRemaining Double
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    value Object
    Current value of the zone setting.
    zoneId String
    Identifier
    editable boolean
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    enabled boolean
    ssl-recommender enrollment setting.
    modifiedOn string
    last time this setting was modified.
    settingId string
    Setting name
    timeRemaining number
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    value any
    Current value of the zone setting.
    zoneId string
    Identifier
    editable bool
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    enabled bool
    ssl-recommender enrollment setting.
    modified_on str
    last time this setting was modified.
    setting_id str
    Setting name
    time_remaining float
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    value Any
    Current value of the zone setting.
    zone_id str
    Identifier
    editable Boolean
    Whether or not this setting can be modified for this zone (based on your Cloudflare plan level).
    enabled Boolean
    ssl-recommender enrollment setting.
    modifiedOn String
    last time this setting was modified.
    settingId String
    Setting name
    timeRemaining Number
    Value of the zone setting. Notes: The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is false.
    value Any
    Current value of the zone setting.
    zoneId String
    Identifier

    Import

    $ pulumi import cloudflare:index/zoneSetting:ZoneSetting example '<zone_id>/<setting_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.10.1 published on Wednesday, Oct 22, 2025 by Pulumi
    pulumi/pulumi-cloudflare
      Meet Neo: Your AI Platform Teammate