1. Packages
  2. Databricks Provider
  3. API Docs
  4. PostgresBranch
Databricks v1.83.0 published on Friday, Jan 23, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-databricks

databricks.PostgresBranch

databricks logo
Databricks v1.83.0 published on Friday, Jan 23, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-databricks

    Public Beta

    Example Usage

    Basic Branch Creation

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

const _this = new databricks.PostgresProject("this", {
    projectId: "my-project",
    spec: {
        pgVersion: 17,
        displayName: "My Project",
    },
});
const dev = new databricks.PostgresBranch("dev", {
    branchId: "dev-branch",
    parent: _this.name,
    spec: {
        noExpiry: true,
    },
});

    import pulumi
import pulumi_databricks as databricks

this = databricks.PostgresProject("this",
    project_id="my-project",
    spec={
        "pg_version": 17,
        "display_name": "My Project",
    })
dev = databricks.PostgresBranch("dev",
    branch_id="dev-branch",
    parent=this.name,
    spec={
        "no_expiry": 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 {
		this, err := databricks.NewPostgresProject(ctx, "this", &databricks.PostgresProjectArgs{
			ProjectId: pulumi.String("my-project"),
			Spec: &databricks.PostgresProjectSpecArgs{
				PgVersion:   pulumi.Int(17),
				DisplayName: pulumi.String("My Project"),
			},
		})
		if err != nil {
			return err
		}
		_, err = databricks.NewPostgresBranch(ctx, "dev", &databricks.PostgresBranchArgs{
			BranchId: pulumi.String("dev-branch"),
			Parent:   this.Name,
			Spec: &databricks.PostgresBranchSpecArgs{
				NoExpiry: 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.PostgresProject("this", new()
    {
        ProjectId = "my-project",
        Spec = new Databricks.Inputs.PostgresProjectSpecArgs
        {
            PgVersion = 17,
            DisplayName = "My Project",
        },
    });

    var dev = new Databricks.PostgresBranch("dev", new()
    {
        BranchId = "dev-branch",
        Parent = @this.Name,
        Spec = new Databricks.Inputs.PostgresBranchSpecArgs
        {
            NoExpiry = true,
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.databricks.PostgresProject;
import com.pulumi.databricks.PostgresProjectArgs;
import com.pulumi.databricks.inputs.PostgresProjectSpecArgs;
import com.pulumi.databricks.PostgresBranch;
import com.pulumi.databricks.PostgresBranchArgs;
import com.pulumi.databricks.inputs.PostgresBranchSpecArgs;
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 PostgresProject("this", PostgresProjectArgs.builder()
            .projectId("my-project")
            .spec(PostgresProjectSpecArgs.builder()
                .pgVersion(17)
                .displayName("My Project")
                .build())
            .build());

        var dev = new PostgresBranch("dev", PostgresBranchArgs.builder()
            .branchId("dev-branch")
            .parent(this_.name())
            .spec(PostgresBranchSpecArgs.builder()
                .noExpiry(true)
                .build())
            .build());

    }
}

    resources:
  this:
    type: databricks:PostgresProject
    properties:
      projectId: my-project
      spec:
        pgVersion: 17
        displayName: My Project
  dev:
    type: databricks:PostgresBranch
    properties:
      branchId: dev-branch
      parent: ${this.name}
      spec:
        noExpiry: true

    Protected Branch

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

const production = new databricks.PostgresBranch("production", {
    branchId: "production",
    parent: _this.name,
    spec: {
        isProtected: true,
        noExpiry: true,
    },
});

    import pulumi
import pulumi_databricks as databricks

production = databricks.PostgresBranch("production",
    branch_id="production",
    parent=this["name"],
    spec={
        "is_protected": True,
        "no_expiry": 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.NewPostgresBranch(ctx, "production", &databricks.PostgresBranchArgs{
			BranchId: pulumi.String("production"),
			Parent:   pulumi.Any(this.Name),
			Spec: &databricks.PostgresBranchSpecArgs{
				IsProtected: pulumi.Bool(true),
				NoExpiry:    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 production = new Databricks.PostgresBranch("production", new()
    {
        BranchId = "production",
        Parent = @this.Name,
        Spec = new Databricks.Inputs.PostgresBranchSpecArgs
        {
            IsProtected = true,
            NoExpiry = true,
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.databricks.PostgresBranch;
import com.pulumi.databricks.PostgresBranchArgs;
import com.pulumi.databricks.inputs.PostgresBranchSpecArgs;
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 production = new PostgresBranch("production", PostgresBranchArgs.builder()
            .branchId("production")
            .parent(this_.name())
            .spec(PostgresBranchSpecArgs.builder()
                .isProtected(true)
                .noExpiry(true)
                .build())
            .build());

    }
}

    resources:
  production:
    type: databricks:PostgresBranch
    properties:
      branchId: production
      parent: ${this.name}
      spec:
        isProtected: true
        noExpiry: true

    Branch with Expiration (TTL)

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

const temporary = new databricks.PostgresBranch("temporary", {
    branchId: "temp-feature-test",
    parent: _this.name,
    spec: {
        ttl: "604800s",
    },
});

    import pulumi
import pulumi_databricks as databricks

temporary = databricks.PostgresBranch("temporary",
    branch_id="temp-feature-test",
    parent=this["name"],
    spec={
        "ttl": "604800s",
    })

    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.NewPostgresBranch(ctx, "temporary", &databricks.PostgresBranchArgs{
			BranchId: pulumi.String("temp-feature-test"),
			Parent:   pulumi.Any(this.Name),
			Spec: &databricks.PostgresBranchSpecArgs{
				Ttl: pulumi.String("604800s"),
			},
		})
		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 temporary = new Databricks.PostgresBranch("temporary", new()
    {
        BranchId = "temp-feature-test",
        Parent = @this.Name,
        Spec = new Databricks.Inputs.PostgresBranchSpecArgs
        {
            Ttl = "604800s",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.databricks.PostgresBranch;
import com.pulumi.databricks.PostgresBranchArgs;
import com.pulumi.databricks.inputs.PostgresBranchSpecArgs;
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 temporary = new PostgresBranch("temporary", PostgresBranchArgs.builder()
            .branchId("temp-feature-test")
            .parent(this_.name())
            .spec(PostgresBranchSpecArgs.builder()
                .ttl("604800s")
                .build())
            .build());

    }
}

    resources:
  temporary:
    type: databricks:PostgresBranch
    properties:
      branchId: temp-feature-test
      parent: ${this.name}
      spec:
        ttl: 604800s

    Create PostgresBranch Resource

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

    Constructor syntax

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

@overload
def PostgresBranch(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   branch_id: Optional[str] = None,
                   parent: Optional[str] = None,
                   spec: Optional[PostgresBranchSpecArgs] = None)
    func NewPostgresBranch(ctx *Context, name string, args PostgresBranchArgs, opts ...ResourceOption) (*PostgresBranch, error)
    public PostgresBranch(string name, PostgresBranchArgs args, CustomResourceOptions? opts = null)
    public PostgresBranch(String name, PostgresBranchArgs args)
public PostgresBranch(String name, PostgresBranchArgs args, CustomResourceOptions options)

    type: databricks:PostgresBranch
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 PostgresBranchArgs
    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 PostgresBranchArgs
    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 PostgresBranchArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args PostgresBranchArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args PostgresBranchArgs
    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 postgresBranchResource = new Databricks.PostgresBranch("postgresBranchResource", new()
{
    BranchId = "string",
    Parent = "string",
    Spec = new Databricks.Inputs.PostgresBranchSpecArgs
    {
        ExpireTime = "string",
        IsProtected = false,
        NoExpiry = false,
        SourceBranch = "string",
        SourceBranchLsn = "string",
        SourceBranchTime = "string",
        Ttl = "string",
    },
});

    example, err := databricks.NewPostgresBranch(ctx, "postgresBranchResource", &databricks.PostgresBranchArgs{
	BranchId: pulumi.String("string"),
	Parent:   pulumi.String("string"),
	Spec: &databricks.PostgresBranchSpecArgs{
		ExpireTime:       pulumi.String("string"),
		IsProtected:      pulumi.Bool(false),
		NoExpiry:         pulumi.Bool(false),
		SourceBranch:     pulumi.String("string"),
		SourceBranchLsn:  pulumi.String("string"),
		SourceBranchTime: pulumi.String("string"),
		Ttl:              pulumi.String("string"),
	},
})

    var postgresBranchResource = new PostgresBranch("postgresBranchResource", PostgresBranchArgs.builder()
    .branchId("string")
    .parent("string")
    .spec(PostgresBranchSpecArgs.builder()
        .expireTime("string")
        .isProtected(false)
        .noExpiry(false)
        .sourceBranch("string")
        .sourceBranchLsn("string")
        .sourceBranchTime("string")
        .ttl("string")
        .build())
    .build());

    postgres_branch_resource = databricks.PostgresBranch("postgresBranchResource",
    branch_id="string",
    parent="string",
    spec={
        "expire_time": "string",
        "is_protected": False,
        "no_expiry": False,
        "source_branch": "string",
        "source_branch_lsn": "string",
        "source_branch_time": "string",
        "ttl": "string",
    })

    const postgresBranchResource = new databricks.PostgresBranch("postgresBranchResource", {
    branchId: "string",
    parent: "string",
    spec: {
        expireTime: "string",
        isProtected: false,
        noExpiry: false,
        sourceBranch: "string",
        sourceBranchLsn: "string",
        sourceBranchTime: "string",
        ttl: "string",
    },
});

    type: databricks:PostgresBranch
properties:
    branchId: string
    parent: string
    spec:
        expireTime: string
        isProtected: false
        noExpiry: false
        sourceBranch: string
        sourceBranchLsn: string
        sourceBranchTime: string
        ttl: string

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

    BranchId string
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    Parent string

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    Spec PostgresBranchSpec
    The spec contains the branch configuration
    BranchId string
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    Parent string

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    Spec PostgresBranchSpecArgs
    The spec contains the branch configuration
    branchId String
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    parent String

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec PostgresBranchSpec
    The spec contains the branch configuration
    branchId string
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    parent string

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec PostgresBranchSpec
    The spec contains the branch configuration
    branch_id str
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    parent str

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec PostgresBranchSpecArgs
    The spec contains the branch configuration
    branchId String
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    parent String

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec Property Map
    The spec contains the branch configuration

    Outputs

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

    CreateTime string
    (string) - A timestamp indicating when the branch was created
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    Status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    Uid string
    (string) - System-generated unique ID for the branch
    UpdateTime string
    (string) - A timestamp indicating when the branch was last updated
    CreateTime string
    (string) - A timestamp indicating when the branch was created
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    Status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    Uid string
    (string) - System-generated unique ID for the branch
    UpdateTime string
    (string) - A timestamp indicating when the branch was last updated
    createTime String
    (string) - A timestamp indicating when the branch was created
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    uid String
    (string) - System-generated unique ID for the branch
    updateTime String
    (string) - A timestamp indicating when the branch was last updated
    createTime string
    (string) - A timestamp indicating when the branch was created
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    uid string
    (string) - System-generated unique ID for the branch
    updateTime string
    (string) - A timestamp indicating when the branch was last updated
    create_time str
    (string) - A timestamp indicating when the branch was created
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    uid str
    (string) - System-generated unique ID for the branch
    update_time str
    (string) - A timestamp indicating when the branch was last updated
    createTime String
    (string) - A timestamp indicating when the branch was created
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    status Property Map
    (BranchStatus) - The current status of a Branch
    uid String
    (string) - System-generated unique ID for the branch
    updateTime String
    (string) - A timestamp indicating when the branch was last updated

    Look up Existing PostgresBranch Resource

    Get an existing PostgresBranch 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?: PostgresBranchState, opts?: CustomResourceOptions): PostgresBranch
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        branch_id: Optional[str] = None,
        create_time: Optional[str] = None,
        name: Optional[str] = None,
        parent: Optional[str] = None,
        spec: Optional[PostgresBranchSpecArgs] = None,
        status: Optional[PostgresBranchStatusArgs] = None,
        uid: Optional[str] = None,
        update_time: Optional[str] = None) -> PostgresBranch
    func GetPostgresBranch(ctx *Context, name string, id IDInput, state *PostgresBranchState, opts ...ResourceOption) (*PostgresBranch, error)
    public static PostgresBranch Get(string name, Input<string> id, PostgresBranchState? state, CustomResourceOptions? opts = null)
    public static PostgresBranch get(String name, Output<String> id, PostgresBranchState state, CustomResourceOptions options)
    resources:  _:    type: databricks:PostgresBranch    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:
    BranchId string
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    CreateTime string
    (string) - A timestamp indicating when the branch was created
    Name string
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    Parent string

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    Spec PostgresBranchSpec
    The spec contains the branch configuration
    Status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    Uid string
    (string) - System-generated unique ID for the branch
    UpdateTime string
    (string) - A timestamp indicating when the branch was last updated
    BranchId string
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    CreateTime string
    (string) - A timestamp indicating when the branch was created
    Name string
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    Parent string

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    Spec PostgresBranchSpecArgs
    The spec contains the branch configuration
    Status PostgresBranchStatusArgs
    (BranchStatus) - The current status of a Branch
    Uid string
    (string) - System-generated unique ID for the branch
    UpdateTime string
    (string) - A timestamp indicating when the branch was last updated
    branchId String
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    createTime String
    (string) - A timestamp indicating when the branch was created
    name String
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    parent String

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec PostgresBranchSpec
    The spec contains the branch configuration
    status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    uid String
    (string) - System-generated unique ID for the branch
    updateTime String
    (string) - A timestamp indicating when the branch was last updated
    branchId string
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    createTime string
    (string) - A timestamp indicating when the branch was created
    name string
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    parent string

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec PostgresBranchSpec
    The spec contains the branch configuration
    status PostgresBranchStatus
    (BranchStatus) - The current status of a Branch
    uid string
    (string) - System-generated unique ID for the branch
    updateTime string
    (string) - A timestamp indicating when the branch was last updated
    branch_id str
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    create_time str
    (string) - A timestamp indicating when the branch was created
    name str
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    parent str

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec PostgresBranchSpecArgs
    The spec contains the branch configuration
    status PostgresBranchStatusArgs
    (BranchStatus) - The current status of a Branch
    uid str
    (string) - System-generated unique ID for the branch
    update_time str
    (string) - A timestamp indicating when the branch was last updated
    branchId String
    The ID to use for the Branch. This becomes the final component of the branch's resource name. The ID must be 1-63 characters long, start with a lowercase letter, and contain only lowercase letters, numbers, and hyphens (RFC 1123). Examples:

    • With custom ID: staging → name becomes projects/{project_id}/branches/staging
    • Without custom ID: system generates slug → name becomes projects/{project_id}/branches/br-example-name-x1y2z3a4
    createTime String
    (string) - A timestamp indicating when the branch was created
    name String
    (string) - The resource name of the branch. This field is output-only and constructed by the system. Format: projects/{project_id}/branches/{branch_id}
    parent String

    The project containing this branch (API resource hierarchy). Format: projects/{project_id}

    Note: This field indicates where the branch exists in the resource hierarchy. For point-in-time branching from another branch, see spec.source_branch

    spec Property Map
    The spec contains the branch configuration
    status Property Map
    (BranchStatus) - The current status of a Branch
    uid String
    (string) - System-generated unique ID for the branch
    updateTime String
    (string) - A timestamp indicating when the branch was last updated

    Supporting Types

    PostgresBranchSpec, PostgresBranchSpecArgs

    ExpireTime string
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    IsProtected bool
    (boolean) - Whether the branch is protected
    NoExpiry bool
    Explicitly disable expiration. When set to true, the branch will not expire. If set to false, the request is invalid; provide either ttl or expire_time instead
    SourceBranch string
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    SourceBranchLsn string
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    SourceBranchTime string
    (string) - The point in time on the source branch from which this branch was created
    Ttl string
    Relative time-to-live duration. When set, the branch will expire at creation_time + ttl
    ExpireTime string
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    IsProtected bool
    (boolean) - Whether the branch is protected
    NoExpiry bool
    Explicitly disable expiration. When set to true, the branch will not expire. If set to false, the request is invalid; provide either ttl or expire_time instead
    SourceBranch string
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    SourceBranchLsn string
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    SourceBranchTime string
    (string) - The point in time on the source branch from which this branch was created
    Ttl string
    Relative time-to-live duration. When set, the branch will expire at creation_time + ttl
    expireTime String
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    isProtected Boolean
    (boolean) - Whether the branch is protected
    noExpiry Boolean
    Explicitly disable expiration. When set to true, the branch will not expire. If set to false, the request is invalid; provide either ttl or expire_time instead
    sourceBranch String
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    sourceBranchLsn String
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    sourceBranchTime String
    (string) - The point in time on the source branch from which this branch was created
    ttl String
    Relative time-to-live duration. When set, the branch will expire at creation_time + ttl
    expireTime string
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    isProtected boolean
    (boolean) - Whether the branch is protected
    noExpiry boolean
    Explicitly disable expiration. When set to true, the branch will not expire. If set to false, the request is invalid; provide either ttl or expire_time instead
    sourceBranch string
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    sourceBranchLsn string
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    sourceBranchTime string
    (string) - The point in time on the source branch from which this branch was created
    ttl string
    Relative time-to-live duration. When set, the branch will expire at creation_time + ttl
    expire_time str
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    is_protected bool
    (boolean) - Whether the branch is protected
    no_expiry bool
    Explicitly disable expiration. When set to true, the branch will not expire. If set to false, the request is invalid; provide either ttl or expire_time instead
    source_branch str
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    source_branch_lsn str
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    source_branch_time str
    (string) - The point in time on the source branch from which this branch was created
    ttl str
    Relative time-to-live duration. When set, the branch will expire at creation_time + ttl
    expireTime String
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    isProtected Boolean
    (boolean) - Whether the branch is protected
    noExpiry Boolean
    Explicitly disable expiration. When set to true, the branch will not expire. If set to false, the request is invalid; provide either ttl or expire_time instead
    sourceBranch String
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    sourceBranchLsn String
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    sourceBranchTime String
    (string) - The point in time on the source branch from which this branch was created
    ttl String
    Relative time-to-live duration. When set, the branch will expire at creation_time + ttl

    PostgresBranchStatus, PostgresBranchStatusArgs

    CurrentState string
    (string) - The branch's state, indicating if it is initializing, ready for use, or archived. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    Default bool
    (boolean) - Whether the branch is the project's default branch
    ExpireTime string
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    IsProtected bool
    (boolean) - Whether the branch is protected
    LogicalSizeBytes int
    (integer) - The logical size of the branch
    PendingState string
    (string) - The pending state of the branch, if a state transition is in progress. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    SourceBranch string
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    SourceBranchLsn string
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    SourceBranchTime string
    (string) - The point in time on the source branch from which this branch was created
    StateChangeTime string
    (string) - A timestamp indicating when the current_state began
    CurrentState string
    (string) - The branch's state, indicating if it is initializing, ready for use, or archived. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    Default bool
    (boolean) - Whether the branch is the project's default branch
    ExpireTime string
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    IsProtected bool
    (boolean) - Whether the branch is protected
    LogicalSizeBytes int
    (integer) - The logical size of the branch
    PendingState string
    (string) - The pending state of the branch, if a state transition is in progress. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    SourceBranch string
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    SourceBranchLsn string
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    SourceBranchTime string
    (string) - The point in time on the source branch from which this branch was created
    StateChangeTime string
    (string) - A timestamp indicating when the current_state began
    currentState String
    (string) - The branch's state, indicating if it is initializing, ready for use, or archived. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    default_ Boolean
    (boolean) - Whether the branch is the project's default branch
    expireTime String
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    isProtected Boolean
    (boolean) - Whether the branch is protected
    logicalSizeBytes Integer
    (integer) - The logical size of the branch
    pendingState String
    (string) - The pending state of the branch, if a state transition is in progress. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    sourceBranch String
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    sourceBranchLsn String
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    sourceBranchTime String
    (string) - The point in time on the source branch from which this branch was created
    stateChangeTime String
    (string) - A timestamp indicating when the current_state began
    currentState string
    (string) - The branch's state, indicating if it is initializing, ready for use, or archived. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    default boolean
    (boolean) - Whether the branch is the project's default branch
    expireTime string
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    isProtected boolean
    (boolean) - Whether the branch is protected
    logicalSizeBytes number
    (integer) - The logical size of the branch
    pendingState string
    (string) - The pending state of the branch, if a state transition is in progress. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    sourceBranch string
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    sourceBranchLsn string
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    sourceBranchTime string
    (string) - The point in time on the source branch from which this branch was created
    stateChangeTime string
    (string) - A timestamp indicating when the current_state began
    current_state str
    (string) - The branch's state, indicating if it is initializing, ready for use, or archived. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    default bool
    (boolean) - Whether the branch is the project's default branch
    expire_time str
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    is_protected bool
    (boolean) - Whether the branch is protected
    logical_size_bytes int
    (integer) - The logical size of the branch
    pending_state str
    (string) - The pending state of the branch, if a state transition is in progress. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    source_branch str
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    source_branch_lsn str
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    source_branch_time str
    (string) - The point in time on the source branch from which this branch was created
    state_change_time str
    (string) - A timestamp indicating when the current_state began
    currentState String
    (string) - The branch's state, indicating if it is initializing, ready for use, or archived. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    default Boolean
    (boolean) - Whether the branch is the project's default branch
    expireTime String
    (string) - Absolute expiration time for the branch. Empty if expiration is disabled
    isProtected Boolean
    (boolean) - Whether the branch is protected
    logicalSizeBytes Number
    (integer) - The logical size of the branch
    pendingState String
    (string) - The pending state of the branch, if a state transition is in progress. Possible values are: ARCHIVED, IMPORTING, INIT, READY, RESETTING
    sourceBranch String
    (string) - The name of the source branch from which this branch was created. Format: projects/{project_id}/branches/{branch_id}
    sourceBranchLsn String
    (string) - The Log Sequence Number (LSN) on the source branch from which this branch was created
    sourceBranchTime String
    (string) - The point in time on the source branch from which this branch was created
    stateChangeTime String
    (string) - A timestamp indicating when the current_state began

    Import

    As of Pulumi v1.5, resources can be imported through configuration.

    hcl

    import {

    id = “name”

    to = databricks_postgres_branch.this

    }

    If you are using an older version of Pulumi, import the resource using the pulumi import command as follows:

    $ pulumi import databricks:index/postgresBranch:PostgresBranch this "name"

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    databricks pulumi/pulumi-databricks
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the databricks Terraform Provider.
    databricks logo
    Databricks v1.83.0 published on Friday, Jan 23, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-databricks
      Meet Neo: Your AI Platform Teammate