[ISSUE] missing documentation for permissions API

[imarkowitz]

Description

There's no documentation here:

databricks-sdk-py/databricks/sdk/service/iam.py

Line 2203 in 2b952c9

<needs content>

instead it just says <needs content>.

This API really needs documentation. What is a request_object_type and what are possible values here?

I'm trying to update permissions for a python wheel and I have no idea what the type string should be.

[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