1. Packages
  2. Databricks Provider
  3. API Docs
  4. DisableLegacyDbfsSetting
Viewing docs for Databricks v1.88.0
published on Thursday, Feb 26, 2026 by Pulumi
databricks logo
Viewing docs for Databricks v1.88.0
published on Thursday, Feb 26, 2026 by Pulumi

    The databricks.DisableLegacyDbfsSetting resource allows you to disable legacy DBFS.

    This resource can only be used with a workspace-level provider!

    Disabling legacy DBFS has the following implications:

    1. Access to DBFS root and DBFS mounts is disallowed (as well as the creation of new mounts).
    2. Disables Databricks Runtime versions prior to 13.3LTS.

    When the setting is off, all DBFS functionality is enabled and no restrictions are imposed on Databricks Runtime versions. This setting can take up to 20 minutes to take effect and requires a manual restart of all-purpose compute clusters and SQL warehouses.

    Refer to official docs for more details:

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as databricks from "@pulumi/databricks";
    
    const _this = new databricks.DisableLegacyDbfsSetting("this", {disableLegacyDbfs: {
        value: true,
    }});
    
    import pulumi
    import pulumi_databricks as databricks
    
    this = databricks.DisableLegacyDbfsSetting("this", disable_legacy_dbfs={
        "value": True,
    })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-databricks/sdk/go/databricks"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := databricks.NewDisableLegacyDbfsSetting(ctx, "this", &databricks.DisableLegacyDbfsSettingArgs{
    			DisableLegacyDbfs: &databricks.DisableLegacyDbfsSettingDisableLegacyDbfsArgs{
    				Value: pulumi.Bool(true),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Databricks = Pulumi.Databricks;
    
    return await Deployment.RunAsync(() => 
    {
        var @this = new Databricks.DisableLegacyDbfsSetting("this", new()
        {
            DisableLegacyDbfs = new Databricks.Inputs.DisableLegacyDbfsSettingDisableLegacyDbfsArgs
            {
                Value = true,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.databricks.DisableLegacyDbfsSetting;
    import com.pulumi.databricks.DisableLegacyDbfsSettingArgs;
    import com.pulumi.databricks.inputs.DisableLegacyDbfsSettingDisableLegacyDbfsArgs;
    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 this_ = new DisableLegacyDbfsSetting("this", DisableLegacyDbfsSettingArgs.builder()
                .disableLegacyDbfs(DisableLegacyDbfsSettingDisableLegacyDbfsArgs.builder()
                    .value(true)
                    .build())
                .build());
    
        }
    }
    
    resources:
      this:
        type: databricks:DisableLegacyDbfsSetting
        properties:
          disableLegacyDbfs:
            value: true
    

    Create DisableLegacyDbfsSetting Resource

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

    Constructor syntax

    new DisableLegacyDbfsSetting(name: string, args: DisableLegacyDbfsSettingArgs, opts?: CustomResourceOptions);
    @overload
    def DisableLegacyDbfsSetting(resource_name: str,
                                 args: DisableLegacyDbfsSettingArgs,
                                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def DisableLegacyDbfsSetting(resource_name: str,
                                 opts: Optional[ResourceOptions] = None,
                                 disable_legacy_dbfs: Optional[DisableLegacyDbfsSettingDisableLegacyDbfsArgs] = None,
                                 etag: Optional[str] = None,
                                 provider_config: Optional[DisableLegacyDbfsSettingProviderConfigArgs] = None,
                                 setting_name: Optional[str] = None)
    func NewDisableLegacyDbfsSetting(ctx *Context, name string, args DisableLegacyDbfsSettingArgs, opts ...ResourceOption) (*DisableLegacyDbfsSetting, error)
    public DisableLegacyDbfsSetting(string name, DisableLegacyDbfsSettingArgs args, CustomResourceOptions? opts = null)
    public DisableLegacyDbfsSetting(String name, DisableLegacyDbfsSettingArgs args)
    public DisableLegacyDbfsSetting(String name, DisableLegacyDbfsSettingArgs args, CustomResourceOptions options)
    
    type: databricks:DisableLegacyDbfsSetting
    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 DisableLegacyDbfsSettingArgs
    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 DisableLegacyDbfsSettingArgs
    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 DisableLegacyDbfsSettingArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DisableLegacyDbfsSettingArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DisableLegacyDbfsSettingArgs
    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 disableLegacyDbfsSettingResource = new Databricks.DisableLegacyDbfsSetting("disableLegacyDbfsSettingResource", new()
    {
        DisableLegacyDbfs = new Databricks.Inputs.DisableLegacyDbfsSettingDisableLegacyDbfsArgs
        {
            Value = false,
        },
        Etag = "string",
        ProviderConfig = new Databricks.Inputs.DisableLegacyDbfsSettingProviderConfigArgs
        {
            WorkspaceId = "string",
        },
        SettingName = "string",
    });
    
    example, err := databricks.NewDisableLegacyDbfsSetting(ctx, "disableLegacyDbfsSettingResource", &databricks.DisableLegacyDbfsSettingArgs{
    	DisableLegacyDbfs: &databricks.DisableLegacyDbfsSettingDisableLegacyDbfsArgs{
    		Value: pulumi.Bool(false),
    	},
    	Etag: pulumi.String("string"),
    	ProviderConfig: &databricks.DisableLegacyDbfsSettingProviderConfigArgs{
    		WorkspaceId: pulumi.String("string"),
    	},
    	SettingName: pulumi.String("string"),
    })
    
    var disableLegacyDbfsSettingResource = new DisableLegacyDbfsSetting("disableLegacyDbfsSettingResource", DisableLegacyDbfsSettingArgs.builder()
        .disableLegacyDbfs(DisableLegacyDbfsSettingDisableLegacyDbfsArgs.builder()
            .value(false)
            .build())
        .etag("string")
        .providerConfig(DisableLegacyDbfsSettingProviderConfigArgs.builder()
            .workspaceId("string")
            .build())
        .settingName("string")
        .build());
    
    disable_legacy_dbfs_setting_resource = databricks.DisableLegacyDbfsSetting("disableLegacyDbfsSettingResource",
        disable_legacy_dbfs={
            "value": False,
        },
        etag="string",
        provider_config={
            "workspace_id": "string",
        },
        setting_name="string")
    
    const disableLegacyDbfsSettingResource = new databricks.DisableLegacyDbfsSetting("disableLegacyDbfsSettingResource", {
        disableLegacyDbfs: {
            value: false,
        },
        etag: "string",
        providerConfig: {
            workspaceId: "string",
        },
        settingName: "string",
    });
    
    type: databricks:DisableLegacyDbfsSetting
    properties:
        disableLegacyDbfs:
            value: false
        etag: string
        providerConfig:
            workspaceId: string
        settingName: string
    

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

    DisableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfs
    block with following attributes:
    Etag string
    ProviderConfig DisableLegacyDbfsSettingProviderConfig
    Configure the provider for management through account provider. This block consists of the following fields:
    SettingName string
    DisableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfsArgs
    block with following attributes:
    Etag string
    ProviderConfig DisableLegacyDbfsSettingProviderConfigArgs
    Configure the provider for management through account provider. This block consists of the following fields:
    SettingName string
    disableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfs
    block with following attributes:
    etag String
    providerConfig DisableLegacyDbfsSettingProviderConfig
    Configure the provider for management through account provider. This block consists of the following fields:
    settingName String
    disableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfs
    block with following attributes:
    etag string
    providerConfig DisableLegacyDbfsSettingProviderConfig
    Configure the provider for management through account provider. This block consists of the following fields:
    settingName string
    disable_legacy_dbfs DisableLegacyDbfsSettingDisableLegacyDbfsArgs
    block with following attributes:
    etag str
    provider_config DisableLegacyDbfsSettingProviderConfigArgs
    Configure the provider for management through account provider. This block consists of the following fields:
    setting_name str
    disableLegacyDbfs Property Map
    block with following attributes:
    etag String
    providerConfig Property Map
    Configure the provider for management through account provider. This block consists of the following fields:
    settingName String

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DisableLegacyDbfsSetting 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 DisableLegacyDbfsSetting Resource

    Get an existing DisableLegacyDbfsSetting 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?: DisableLegacyDbfsSettingState, opts?: CustomResourceOptions): DisableLegacyDbfsSetting
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            disable_legacy_dbfs: Optional[DisableLegacyDbfsSettingDisableLegacyDbfsArgs] = None,
            etag: Optional[str] = None,
            provider_config: Optional[DisableLegacyDbfsSettingProviderConfigArgs] = None,
            setting_name: Optional[str] = None) -> DisableLegacyDbfsSetting
    func GetDisableLegacyDbfsSetting(ctx *Context, name string, id IDInput, state *DisableLegacyDbfsSettingState, opts ...ResourceOption) (*DisableLegacyDbfsSetting, error)
    public static DisableLegacyDbfsSetting Get(string name, Input<string> id, DisableLegacyDbfsSettingState? state, CustomResourceOptions? opts = null)
    public static DisableLegacyDbfsSetting get(String name, Output<String> id, DisableLegacyDbfsSettingState state, CustomResourceOptions options)
    resources:  _:    type: databricks:DisableLegacyDbfsSetting    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:
    DisableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfs
    block with following attributes:
    Etag string
    ProviderConfig DisableLegacyDbfsSettingProviderConfig
    Configure the provider for management through account provider. This block consists of the following fields:
    SettingName string
    DisableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfsArgs
    block with following attributes:
    Etag string
    ProviderConfig DisableLegacyDbfsSettingProviderConfigArgs
    Configure the provider for management through account provider. This block consists of the following fields:
    SettingName string
    disableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfs
    block with following attributes:
    etag String
    providerConfig DisableLegacyDbfsSettingProviderConfig
    Configure the provider for management through account provider. This block consists of the following fields:
    settingName String
    disableLegacyDbfs DisableLegacyDbfsSettingDisableLegacyDbfs
    block with following attributes:
    etag string
    providerConfig DisableLegacyDbfsSettingProviderConfig
    Configure the provider for management through account provider. This block consists of the following fields:
    settingName string
    disable_legacy_dbfs DisableLegacyDbfsSettingDisableLegacyDbfsArgs
    block with following attributes:
    etag str
    provider_config DisableLegacyDbfsSettingProviderConfigArgs
    Configure the provider for management through account provider. This block consists of the following fields:
    setting_name str
    disableLegacyDbfs Property Map
    block with following attributes:
    etag String
    providerConfig Property Map
    Configure the provider for management through account provider. This block consists of the following fields:
    settingName String

    Supporting Types

    DisableLegacyDbfsSettingDisableLegacyDbfs, DisableLegacyDbfsSettingDisableLegacyDbfsArgs

    Value bool
    The boolean value for the setting.
    Value bool
    The boolean value for the setting.
    value Boolean
    The boolean value for the setting.
    value boolean
    The boolean value for the setting.
    value bool
    The boolean value for the setting.
    value Boolean
    The boolean value for the setting.

    DisableLegacyDbfsSettingProviderConfig, DisableLegacyDbfsSettingProviderConfigArgs

    WorkspaceId string
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    WorkspaceId string
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspaceId String
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspaceId string
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspace_id str
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.
    workspaceId String
    Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.

    Package Details

    Repository
    databricks pulumi/pulumi-databricks
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the databricks Terraform Provider.
    databricks logo
    Viewing docs for Databricks v1.88.0
    published on Thursday, Feb 26, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.