[ISSUE] missing documentation for `permissions` API about databricks-sdk-py

[hectorcast-db]

Hi @imarkowitz
Thanks for reaching out. We will improve the documentations for this object.
However, most likely you are looking for a different object.
This is the generic permissions class, but there are classes and methods dedicated to handle permissions for each Databricks resource. For instance, here the objects and methods to get the permissions for a Job

databricks-sdk-py/databricks/sdk/service/jobs.py

Line 4827 in 3a8b042

def get_permission_levels(self, job_id: str) -> GetJobPermissionLevelsResponse:

[imarkowitz]

Thanks, I think it would be helpful to add that information to the documentation as well.

Documentation on those APIs seems inadequate as well. For example,

databricks-sdk-py/databricks/sdk/service/workspace.py

Line 2178 in 3a8b042

The workspace object type for which to get or manage permissions.

-- what are valid possible values for "workspace_object_type" here?

Thanks