object_permissions

Creates, updates, deletes, gets or lists an object_permissions resource.

Overview

Name	object_permissions
Type	Resource
Id	databricks_workspace.workspace.object_permissions

Fields

The following fields are returned by SELECT queries:

getpermissions

Name	Datatype	Description
object_id	string
access_control_list	array
object_type	string

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
getpermissions	select	deployment_name		Gets the permissions of a workspace object. Workspace objects can inherit permissions from their parent objects or root object.
updatepermissions	update	deployment_name		Updates the permissions on a workspace object. Workspace objects can inherit permissions from their parent objects or root object.
setpermissions	replace	deployment_name		Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct permissions if none are specified. Objects can inherit permissions from their parent objects or root object.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
deployment_name	string	The Databricks Workspace Deployment Name (default: dbc-abcd0123-a1bc)

SELECT examples

getpermissions

Gets the permissions of a workspace object. Workspace objects can inherit permissions from their parent objects or root object.

SELECT
object_id,
access_control_list,
object_type
FROM databricks_workspace.workspace.object_permissions
WHERE deployment_name = '{{ deployment_name }}' -- required;

UPDATE examples

updatepermissions

Updates the permissions on a workspace object. Workspace objects can inherit permissions from their parent objects or root object.

UPDATE databricks_workspace.workspace.object_permissions
SET 
data__access_control_list = '{{ access_control_list }}'
WHERE 
deployment_name = '{{ deployment_name }}' --required
RETURNING
object_id,
access_control_list,
object_type;

REPLACE examples

setpermissions

Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct permissions if none are specified. Objects can inherit permissions from their parent objects or root object.

REPLACE databricks_workspace.workspace.object_permissions
SET 
data__access_control_list = '{{ access_control_list }}'
WHERE 
deployment_name = '{{ deployment_name }}' --required
RETURNING
object_id,
access_control_list,
object_type;