Skip to main content

acls

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

Overview

Nameacls
TypeResource
Iddatabricks_workspace.secrets.acls

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
permissionstring
principalstring

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listaclsselectdeployment_nameList the ACLs for a given secret scope. Users must have the
getaclselectdeployment_nameGets the details about the given ACL, such as the group and permission. Users must have the
putaclreplacedeployment_nameCreates or overwrites the Access Control List (ACL) associated with the given principal (user or group) on the specified scope point.
deleteacldeletedeployment_nameDeletes the given ACL on the given scope.

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.

NameDatatypeDescription
deployment_namestringThe Databricks Workspace Deployment Name (default: dbc-abcd0123-a1bc)

SELECT examples

List the ACLs for a given secret scope. Users must have the

SELECT
permission,
principal
FROM databricks_workspace.secrets.acls
WHERE deployment_name = '{{ deployment_name }}' -- required;

REPLACE examples

Creates or overwrites the Access Control List (ACL) associated with the given principal (user or group) on the specified scope point.

REPLACE databricks_workspace.secrets.acls
SET
data__scope = '{{ scope }}',
data__principal = '{{ principal }}',
data__permission = '{{ permission }}'
WHERE
deployment_name = '{{ deployment_name }}' --required;

DELETE examples

Deletes the given ACL on the given scope.

DELETE FROM databricks_workspace.secrets.acls
WHERE deployment_name = '{{ deployment_name }}' --required;