Alert access control

Preview

This feature is in Public Preview.

With alert access control, individual permissions determine a user’s abilities. This article describes the individual permissions and how to configure alert access control.

Alert permissions

There are three permission levels for a alert: No Permissions, Can Run, and Can Manage. The table lists the abilities for each permission.

Ability No Permissions Can Run Can Manage
See in alert list   x x
View alert and result   x x
Manually trigger alert run   x x
Edit alert     x
Modify permissions     x
Delete alert     x
Subscribe to notifications   x x

Manage alert permissions using the UI

  1. Click Alerts Icon Alerts in the sidebar.

  2. Click an alert.

  3. Click the Share Button button at the top right. The Manage Permissions dialog displays.

    Manage alert permissions
  4. Select a user or group and a permission.

  5. Click Add.

  6. Dismiss the dialog.

Manage alert permissions using the API

To manage alert permissions using the API, invoke methods on the /2.0/permissions/sql/alert/<alert-id> REST endpoint. For example, to set Can Manage permission for the user user@example.com, run the command:

curl -u 'token:<token>' https://<databricks-instance>/api/2.0/permissions/sql/alert/<alert-id> -X PATCH -d '{ "access_control_list" : [ { "user_name": user@example.com", "permission_level": "CAN_MANAGE" } ] }'

where