[ISSUE] IAM permissions documentation issue for request_object_type in the case of SQL Warehouses

[elisabetao]

Description
The issue revolves around IAM permissions documentation for request_object_type in the case of SQL Warehouses. The documentation should mention request_object_type being 'warehouses' instead of 'sql-warehouses' .

If one now uses 'sql-warehouses' as a request_object_type , one will get the following error : " databricks.sdk.errors.platform.BadRequest: 'sql-warehouses' is not a supported object type for permissions. Expected one of {authorization,clusters,cluster-policies,directories,experiments,files,instance-pools,jobs,notebooks,pipelines,registered-models,repos,serving-endpoints,sql-warehouses} "

But the Python SDK uses the Databricks REST API PUT to set permissions re -

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

Line 2666 in 898b57d

res = self._api.do('PUT',

, which as can be seen here: https://docs.databricks.com/api/workspace/warehouses/setpermissions, the request_object_type should be 'warehouses' and not 'sql-warehouses'

Thanks

[mgyucht]

Thanks for reporting this! I've reported this to the appropriate team, and they will prioritize fixing the documentation & error message.