databricksgrouprole Resource

June 12, 2026 ยท View on GitHub

API Documentation

This resource allows you to attach a role to databricks_group. This role could be a pre-defined role such as account admin, or an instance profile ARN.

-> This resource can be used with an account or workspace-level provider.

Example Usage

Attach an instance profile to a group

resource "databricks_instance_profile" "instance_profile" {
  instance_profile_arn = "my_instance_profile_arn"
}

resource "databricks_group" "my_group" {
  display_name = "my_group_name"
}

resource "databricks_group_role" "my_group_instance_profile" {
  group_id = databricks_group.my_group.id
  role     = databricks_instance_profile.instance_profile.id
}

Attach account admin role to an account-level group

provider "databricks" {
  host          = "https://accounts.cloud.databricks.com"
  account_id    = var.databricks_account_id
  client_id     = var.client_id
  client_secret = var.client_secret
}

resource "databricks_group" "my_group" {
  display_name = "my_group_name"
}

resource "databricks_group_role" "my_group_account_admin" {
  group_id = databricks_group.my_group.id
  role     = "account_admin"
}

Argument Reference

The following arguments are supported:

  • group_id - (Required) This is the id of the group resource.
  • role - (Required) Either a role name or the ARN/ID of the instance profile resource.
  • api - (Optional) Specifies whether to use account-level or workspace-level API. Valid values are account and workspace. When not set, the API level is inferred from the provider host.

Attribute Reference

In addition to all arguments above, the following attributes are exported:

  • id - The id for the databricks_group_role object which is in the format <group_id>|<role>.

Import

!> Importing this resource is not currently supported.

The following resources are often used in the same context: