## Changes
There are times when it is especially useful to get the workspace ID for
the current workspace client. Currently, the workspace ID for the
current workspace is exposed as a header in the SCIM Me API call. We'll
expose this through a get_workspace_id() method, caching the workspace
ID for the lifetime of the client.

In the future, we may add a meta service for exposing information about
the current account/workspace. At that point, we can migrate off of this
somewhat hacky approach.

Ports databricks/databricks-sdk-go#808 to the
Python SDK.

## Tests
<!-- 
How is this tested? Please see the checklist below and also describe any
other relevant tests
-->

- [ ] `make test` run locally
- [ ] `make fmt` applied
- [ ] relevant integration tests applied

…nt client (#542)

## Changes
* We are creating a shallow copy of the config object when creating a ws
client from acc client. This leads to the config of acc client being
overridden by changes made for the workspace client. This PR makes it so
that we are making a deepcopy instead.
* Also, correctly handle list response jsons in the API client. 

## Tests
* added integration test

- [ ] `make test` run locally
- [ ] `make fmt` applied
- [ ] relevant integration tests applied

New features:

* Add `get_workspace_id()` to WorkspaceClient
([#537](#537)).

Bugfix:

* Create a deepcopy of config when creating workspace client from
account client
([#542](#542)). This
fixes an issue where `AccountClient` instances would stop working after
calling `get_workspace_client()`.

## Changes
Doc generation is done automatically for all services in the
`WorkspaceClient` and `AccountClient` classes. However,
`get_workspace_id()` does not need to go through the same process, as
its docs will appear on the `WorkspaceClient` doc page anyways:
https://databricks-sdk-py--549.org.readthedocs.build/en/549/clients/workspace.html#databricks.sdk.WorkspaceClient.get_workspace_id.

## Tests
<!-- 
How is this tested? Please see the checklist below and also describe any
other relevant tests
-->

- [ ] `make test` run locally
- [ ] `make fmt` applied
- [ ] relevant integration tests applied

## Changes
Support HEAD operation and response Headers 

## Test

- [X] make fmt
- [X] make test
- [X] run integration tests (both with current sha and master sha)

---------

Signed-off-by: hectorcast-db <[email protected]>
Co-authored-by: Miles Yucht <[email protected]>

Major Changes:

* Updated behaviour for raw parameter in `ApiClient.do()` method. The
raw data is not returned directly anymore, but as part of a dict with
the `contents` key. This dict will also contain response headers if
returned by the API.

Internal Changes:

* Add get_workspace_id to docgen blocklist
([#549](#549)).
* Support HEAD operation and response Headers
([#547](#547)).

API Changes:

* Changed `delete()`, `get()` and `update()` methods for
[w.connections](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/connections.html)
workspace-level service with new required argument order.
* Changed `update()` method for
[w.lakehouse_monitors](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/lakehouse_monitors.html)
workspace-level service with new required argument order.
* Changed `delete()`, `get()` and `update()` methods for
[w.volumes](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/volumes.html)
workspace-level service with new required argument order.
* Added
[w.online_tables](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/online_tables.html)
workspace-level service.
* Renamed `name_arg` field to `name` for the following dataclasses:
`databricks.sdk.service.catalog.DeleteConnectionRequest`,
   `databricks.sdk.service.catalog.GetConnectionRequest`,
   `databricks.sdk.service.catalog.UpdateConnection`,
   `databricks.sdk.service.sharing.DeleteCleanRoomRequest`, 
   `databricks.sdk.service.sharing.GetCleanRoomRequest` and
   `databricks.sdk.service.sharing.UpdateCleanRoom`.
* Removed `full_name_arg` field for
`databricks.sdk.service.catalog.DeleteVolumeRequest`.
* Added `name` field for
`databricks.sdk.service.catalog.DeleteVolumeRequest`.
* Added `max_results` field for
`databricks.sdk.service.catalog.ListVolumesRequest`.
* Added `page_token` field for
`databricks.sdk.service.catalog.ListVolumesRequest`.
* Added `next_page_token` field for
`databricks.sdk.service.catalog.ListVolumesResponseContent`.
* Removed `full_name_arg` field for
`databricks.sdk.service.catalog.ReadVolumeRequest`.
* Added `name` field for
`databricks.sdk.service.catalog.ReadVolumeRequest`.
* Removed `assets_dir` field for
`databricks.sdk.service.catalog.UpdateMonitor`.
* Removed `full_name_arg` field for
`databricks.sdk.service.catalog.UpdateVolumeRequestContent`.
* Added `name` field for
`databricks.sdk.service.catalog.UpdateVolumeRequestContent`.
* Added the following catalog dataclasses: `ContinuousUpdateStatus`,
`DeleteOnlineTableRequest`, `FailedStatus`,
`GetOnlineTableRequest`, `OnlineTable`, `OnlineTableSpec`,
`OnlineTableState`, `OnlineTableStatus`,
`PipelineProgress`, `ProvisioningStatus`, `TriggeredUpdateStatus` and
`ViewData`.
* Added `get_directory_metadata()` method for
[w.files](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/files.html)
workspace-level service.
* Added `get_metadata()` method for
[w.files](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/files.html)
workspace-level service.
* Added `content_length`, `content_type` and `last_modified` fields for
`databricks.sdk.service.files.DownloadResponse`.
* Added the following files dataclasses: `FileSize`,
`GetDirectoryMetadataRequest`, `GetMetadataRequest`,
   `GetMetadataResponse` and `LastModifiedHttpDate`.
* Removed `trigger_history` field for `databricks.sdk.service.jobs.Job`.
 * Removed `databricks.sdk.service.jobs.TriggerEvaluation` dataclass.
 * Removed `databricks.sdk.service.jobs.TriggerHistory` dataclass.
* Added `table` field for `databricks.sdk.service.jobs.TriggerSettings`.
 * Added `databricks.sdk.service.jobs.Condition` dataclass.
* Added `databricks.sdk.service.jobs.TableTriggerConfiguration`
dataclass.
* Removed `config` field for
`databricks.sdk.service.serving.ExternalModel`.
* Removed `databricks.sdk.service.serving.ExternalModelConfig`
dataclass. Fields moved to
`databricks.sdk.service.serving.ExternalModel`.
* Added `max_provisioned_throughput` and `min_provisioned_throughput`
fields for `databricks.sdk.service.serving.ServedEntityInput`.
* Added `max_provisioned_throughput` and `min_provisioned_throughput`
fields for `databricks.sdk.service.serving.ServedEntityOutput`.
* Changed `delete()` method for
[w.clean_rooms](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/clean_rooms.html)
workspace-level service with new required argument order.
* Changed `get()` method for
[w.clean_rooms](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/clean_rooms.html)
workspace-level service with new required argument order.
* Changed `update()` method for
[w.clean_rooms](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/clean_rooms.html)
workspace-level service with new required argument order.
* Added `enum_options` field for `databricks.sdk.service.sql.Parameter`.
* Added `multi_values_options` field for
`databricks.sdk.service.sql.Parameter`.
 * Added `query_id` field for `databricks.sdk.service.sql.Parameter`.
 * Added `databricks.sdk.service.sql.MultiValuesOptions` dataclass.

OpenAPI SHA: cdd76a98a4fca7008572b3a94427566dd286c63b, Date: 2024-02-19