permissions

Creates, updates, deletes, gets or lists a permissions resource.

Overview

Name	permissions
Type	Resource
Id	databricks_workspace.apps.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 an app. Apps can inherit permissions from their root object.
updatepermissions	update	deployment_name		Updates the permissions on an app. Apps can inherit permissions from their 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 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 an app. Apps can inherit permissions from their root object.

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

UPDATE examples

updatepermissions

Updates the permissions on an app. Apps can inherit permissions from their root object.

UPDATE databricks_workspace.apps.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 root object.

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