Assignable Role Proxy

View as Markdown

Get assignable roles for a resourceGET /api/2.0/preview/accounts/access-control/assignable-roles

Role object

namestringPublic Preview

Role to assign to a principal or a list of principals on a resource.

View as Markdown

The Role object

{
  "name": "string"
}

Get assignable roles for a resource Public Preview

GET /api/2.0/preview/accounts/access-control/assignable-roles

Gets all the roles that can be granted on an account level resource. A role is grantable if the rule set on the resource can contain an access rule of the role.

API scopes: access-management

Parameters

account_idstringquery

<Databricks> account ID.

resourcestringRequiredquery

The resource name for which assignable roles will be listed.

Examples	Summary
resource=accounts/<ACCOUNT_ID>	A resource name for the account.
resource=accounts/<ACCOUNT_ID>/groups/<GROUP_ID>	A resource name for the group.
resource=accounts/<ACCOUNT_ID>/servicePrincipals/<SP_ID>	A resource name for the service principal.
resource=accounts/<ACCOUNT_ID>/tagPolicies/<TAG_POLICY_ID>	A resource name for the tag policy.

Response

Returns a list of Role objects.

View as Markdown

Response

A role that will grant the permissions of a marketplace admin.Roles that can grant permissions on groups.Roles that can grant permissions on service principals.

{
  "roles": [
    {
      "name": "roles/marketplace.admin"
    }
  ]
}