databricks-sdk 0.153.0__tar.gz → 0.155.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/CHANGELOG.md +28 -0
  2. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/PKG-INFO +1 -1
  3. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/__init__.py +2 -2
  4. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/config.py +5 -0
  5. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/files.py +175 -14
  6. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/agentkit.py +46 -49
  7. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/billing.py +27 -6
  8. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/bundledeployments.py +7 -6
  9. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/catalog.py +93 -15
  10. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/compute.py +5 -33
  11. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/disasterrecovery.py +45 -0
  12. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/jobs.py +71 -0
  13. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/knowledgeassistants.py +1 -1
  14. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/ml.py +108 -0
  15. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/pipelines.py +4 -2
  16. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/sandbox.py +378 -0
  17. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/sharing.py +1 -48
  18. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/sql.py +126 -0
  19. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/supervisoragents.py +1 -1
  20. databricks_sdk-0.155.0/databricks/sdk/version.py +1 -0
  21. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/PKG-INFO +1 -1
  22. databricks_sdk-0.153.0/databricks/sdk/version.py +0 -1
  23. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/CONTRIBUTING.md +0 -0
  24. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/DCO +0 -0
  25. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/LICENSE +0 -0
  26. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/MANIFEST.in +0 -0
  27. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/Makefile +0 -0
  28. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/NOTICE +0 -0
  29. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/README.md +0 -0
  30. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/SECURITY.md +0 -0
  31. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/__init__.py +0 -0
  32. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_base_client.py +0 -0
  33. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_property.py +0 -0
  34. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_sandbox_grpc/__init__.py +0 -0
  35. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_sandbox_grpc/sandbox_service_pb2.py +0 -0
  36. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_sandbox_grpc/sandbox_service_pb2_grpc.py +0 -0
  37. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_widgets/__init__.py +0 -0
  38. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_widgets/default_widgets_utils.py +0 -0
  39. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_widgets/ipywidgets_utils.py +0 -0
  40. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/azure.py +0 -0
  41. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/casing.py +0 -0
  42. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/client_types.py +0 -0
  43. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/clock.py +0 -0
  44. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/common/lro.py +0 -0
  45. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/common/types/__init__.py +0 -0
  46. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/common/types/fieldmask.py +0 -0
  47. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/core.py +0 -0
  48. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/credentials_provider.py +0 -0
  49. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/data_plane.py +0 -0
  50. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/dbutils.py +0 -0
  51. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/environments.py +0 -0
  52. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/__init__.py +0 -0
  53. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/base.py +0 -0
  54. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/customizer.py +0 -0
  55. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/deserializer.py +0 -0
  56. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/details.py +0 -0
  57. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/mapper.py +0 -0
  58. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/overrides.py +0 -0
  59. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/parser.py +0 -0
  60. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/platform.py +0 -0
  61. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/private_link.py +0 -0
  62. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/sdk.py +0 -0
  63. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/logger/__init__.py +0 -0
  64. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/logger/round_trip_logger.py +0 -0
  65. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/__init__.py +0 -0
  66. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/_grpc_transport.py +0 -0
  67. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/compute.py +0 -0
  68. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/files_utils.py +0 -0
  69. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/jobs.py +0 -0
  70. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/open_ai_client.py +0 -0
  71. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/sandbox.py +0 -0
  72. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/sharing.py +0 -0
  73. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/workspace.py +0 -0
  74. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/oauth.py +0 -0
  75. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/oidc.py +0 -0
  76. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/oidc_token_supplier.py +0 -0
  77. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/py.typed +0 -0
  78. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/retries.py +0 -0
  79. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/runtime/__init__.py +0 -0
  80. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/runtime/dbutils_stub.py +0 -0
  81. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/__init__.py +0 -0
  82. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/_internal.py +0 -0
  83. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/agentbricks.py +0 -0
  84. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/aifunctions.py +0 -0
  85. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/aisearch.py +0 -0
  86. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/apps.py +0 -0
  87. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/bundle.py +0 -0
  88. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/cleanrooms.py +0 -0
  89. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/dashboards.py +0 -0
  90. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/database.py +0 -0
  91. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/dataclassification.py +0 -0
  92. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/dataquality.py +0 -0
  93. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/domains.py +0 -0
  94. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/environments.py +0 -0
  95. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/files.py +0 -0
  96. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/iam.py +0 -0
  97. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/iamv2.py +0 -0
  98. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/marketplace.py +0 -0
  99. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/networking.py +0 -0
  100. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/oauth2.py +0 -0
  101. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/postgres.py +0 -0
  102. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/provisioning.py +0 -0
  103. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/qualitymonitorv2.py +0 -0
  104. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/serving.py +0 -0
  105. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/settings.py +0 -0
  106. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/settingsv2.py +0 -0
  107. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/tags.py +0 -0
  108. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/vectorsearch.py +0 -0
  109. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/workspace.py +0 -0
  110. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/useragent.py +0 -0
  111. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/SOURCES.txt +0 -0
  112. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/dependency_links.txt +0 -0
  113. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/requires.txt +0 -0
  114. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/top_level.txt +0 -0
  115. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/pyproject.toml +0 -0
  116. {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/setup.cfg +0 -0
@@ -1,5 +1,33 @@
1
1
  # Version changelog
2
2
 
3
+ ## Release v0.155.0 (2026-10-21)
4
+
5
+ ### API Changes
6
+ * Add `sdp_source` field for `databricks.sdk.service.ml.DataSource`.
7
+ * Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.CreateWarehouseRequest`.
8
+ * Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.EditWarehouseRequest`.
9
+ * Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.EndpointInfo`.
10
+ * Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.GetWarehouseResponse`.
11
+ * [Breaking] Remove `replication_config` field for `databricks.sdk.service.sharing.CreateShare`.
12
+ * [Breaking] Remove `replication_config` field for `databricks.sdk.service.sharing.ShareInfo`.
13
+
14
+ ## Release v0.154.0 (2026-10-19)
15
+
16
+ ### API Changes
17
+ * Add `create_directory()`, `delete_path()`, `get_metadata()`, `list_directory_contents()` and `rename_path()` methods for [w.sandbox](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/sandbox/sandbox.html) workspace-level service.
18
+ * Add `secrets` field for `databricks.sdk.service.catalog.ConnectionInfo`.
19
+ * Add `secrets` field for `databricks.sdk.service.catalog.CreateConnection`.
20
+ * Add `governed_tags` field for `databricks.sdk.service.catalog.PolicyInfo`.
21
+ * Add `secrets` field for `databricks.sdk.service.catalog.UpdateConnection`.
22
+ * Add `has_replication_point_blocking_errors` and `initial_replication_progress` fields for `databricks.sdk.service.disasterrecovery.FailoverGroup`.
23
+ * Add `duration_target` field for `databricks.sdk.service.jobs.BaseRun`.
24
+ * Add `duration_target` field for `databricks.sdk.service.jobs.CreateJob`.
25
+ * Add `duration_target` field for `databricks.sdk.service.jobs.JobSettings`.
26
+ * Add `duration_target` field for `databricks.sdk.service.jobs.RepairRun`.
27
+ * Add `duration_target` field for `databricks.sdk.service.jobs.Run`.
28
+ * Add `duration_target` field for `databricks.sdk.service.jobs.RunNow`.
29
+ * Add `duration_target` field for `databricks.sdk.service.jobs.SubmitRun`.
30
+
3
31
  ## Release v0.153.0 (2026-10-15)
4
32
 
5
33
  ### API Changes
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: databricks-sdk
3
- Version: 0.153.0
3
+ Version: 0.155.0
4
4
  Summary: Databricks SDK for Python (Beta)
5
5
  Project-URL: Documentation, https://databricks-sdk-py.readthedocs.io
6
6
  Keywords: databricks,sdk
@@ -829,7 +829,7 @@ class WorkspaceClient:
829
829
 
830
830
  @property
831
831
  def knowledge_assistants(self) -> pkg_knowledgeassistants.KnowledgeAssistantsAPI:
832
- """Manage Knowledge Assistants and related resources."""
832
+ """Manage legacy Knowledge Assistants and related resources."""
833
833
  return self._knowledge_assistants
834
834
 
835
835
  @property
@@ -1094,7 +1094,7 @@ class WorkspaceClient:
1094
1094
 
1095
1095
  @property
1096
1096
  def supervisor_agents(self) -> pkg_supervisoragents.SupervisorAgentsAPI:
1097
- """Manage Supervisor Agents and related resources."""
1097
+ """Manage legacy Supervisor Agents and related resources."""
1098
1098
  return self._supervisor_agents
1099
1099
 
1100
1100
  @property
@@ -267,6 +267,11 @@ class Config:
267
267
  # When enabled, the SDK will probe the storage proxy and use it if available.
268
268
  experimental_files_ext_enable_storage_proxy: bool = False
269
269
 
270
+ # Whether to ask the workspace which endpoints to use for file transfers (GET /api/2.0/fs/endpoints).
271
+ # When disabled, or when the server cannot answer, the SDK uses a built-in order: Presigned URL, then
272
+ # Files API 2.0 on the workspace host.
273
+ experimental_files_ext_enable_endpoints_api: bool = False
274
+
270
275
  def __init__(
271
276
  self,
272
277
  *,
@@ -16,6 +16,7 @@ from collections.abc import Iterator
16
16
  from concurrent.futures import ThreadPoolExecutor, as_completed
17
17
  from dataclasses import dataclass
18
18
  from datetime import timedelta
19
+ from enum import Enum
19
20
  from io import BytesIO
20
21
  from queue import Empty, Full, Queue
21
22
  from tempfile import mkstemp
@@ -746,6 +747,35 @@ class _PresignedUrl:
746
747
  part_number: int | None = None
747
748
 
748
749
 
750
+ class _ResolvedEndpoint(Enum):
751
+ """A file transfer protocol this SDK can speak, identified by the (api, api_version) pair the
752
+ endpoints API returns."""
753
+
754
+ IO_OFFLOAD = "IO_OFFLOAD"
755
+ FILES_API_V2 = "FILES_API_V2"
756
+
757
+
758
+ # Maps the server's (api, api_version) to a protocol compiled into this SDK. Pairs not listed here are
759
+ # skipped, which lets the server advertise newer protocols without breaking older SDKs. IO_OFFLOAD is
760
+ # unversioned during the preview, so a versioned IO_OFFLOAD is newer than this SDK.
761
+ _RECOGNIZED_ENDPOINTS: dict[tuple[str, Optional[str]], _ResolvedEndpoint] = {
762
+ ("IO_OFFLOAD", None): _ResolvedEndpoint.IO_OFFLOAD,
763
+ ("FILES_API", "2.0"): _ResolvedEndpoint.FILES_API_V2,
764
+ }
765
+
766
+ _ENDPOINT_SCHEMES = ("http", "https")
767
+
768
+
769
+ @dataclass(frozen=True)
770
+ class _Endpoint:
771
+ """One entry of the ordered endpoint list a file transfer walks, best first."""
772
+
773
+ kind: _ResolvedEndpoint
774
+ base_url: str
775
+ """Scheme and hostname as returned by the server, e.g. https://example.cloud.databricks.com."""
776
+ multipart_upload_supported: bool
777
+
778
+
749
779
  class _PresignedUrlRequestBuilder:
750
780
  """Builds presigned URL requests for file upload operations.
751
781
 
@@ -928,6 +958,12 @@ class FilesExt(files.FilesAPI):
928
958
  # Timeout in seconds for the storage-proxy health check probe.
929
959
  _STORAGE_PROXY_PROBE_TIMEOUT: float = 3.0
930
960
 
961
+ _ENDPOINTS_API_PATH: str = "/api/2.0/fs/endpoints"
962
+
963
+ # Endpoint discovery is a single attempt bounded by this timeout: it precedes a transfer, so it
964
+ # must fail fast to the default order rather than retry and stall the upload or download.
965
+ _ENDPOINTS_RESOLVE_TIMEOUT_SECONDS: float = 10.0
966
+
931
967
  @dataclass(frozen=True)
932
968
  class _UploadContext:
933
969
  target_path: str
@@ -956,13 +992,129 @@ class FilesExt(files.FilesAPI):
956
992
  self._dp_hostname_available: Optional[bool] = None
957
993
  self._cached_storage_proxy_session: Optional[requests.Session] = None
958
994
  self._storage_proxy_session_lock = Lock()
995
+ self._cached_endpoints: Optional[list[_Endpoint]] = None
996
+ self._endpoints_lock = Lock()
959
997
 
960
- def _get_hostname(self) -> str:
961
- """Returns the hostname for file operations.
998
+ def _resolve_endpoints(self) -> list[_Endpoint]:
999
+ """Returns the ordered endpoints to try for a file transfer, best first.
962
1000
 
963
- When storage proxy is enabled, probes it on first call and caches the
964
- result. Returns the proxy hostname if available, otherwise the workspace
965
- hostname.
1001
+ The server is asked once per client and its answer, including a failure, is cached. Anything
1002
+ short of a usable list falls back to the built-in order, so endpoint discovery never fails a
1003
+ transfer.
1004
+ """
1005
+ if not self._config.experimental_files_ext_enable_endpoints_api:
1006
+ return self._default_endpoints()
1007
+ with self._endpoints_lock:
1008
+ if self._cached_endpoints is None:
1009
+ self._cached_endpoints = self._fetch_endpoints() or self._default_endpoints()
1010
+ return list(self._cached_endpoints)
1011
+
1012
+ def _default_endpoints(self) -> list[_Endpoint]:
1013
+ host = self._config.host
1014
+ return [
1015
+ _Endpoint(_ResolvedEndpoint.IO_OFFLOAD, host, multipart_upload_supported=True),
1016
+ _Endpoint(_ResolvedEndpoint.FILES_API_V2, host, multipart_upload_supported=False),
1017
+ ]
1018
+
1019
+ def _fetch_endpoints(self) -> list[_Endpoint]:
1020
+ """Fetches the endpoint list from the server, keeping only entries this SDK can speak.
1021
+
1022
+ Discovery runs before a transfer, so it is a single short-timeout attempt with no retries: a
1023
+ slow or failing endpoint must fall back to the default order quickly rather than hold up the
1024
+ upload or download.
1025
+ """
1026
+ url = f"{self._config.host}{self._ENDPOINTS_API_PATH}"
1027
+ try:
1028
+ response = self._cloud_provider_session().request(
1029
+ "GET",
1030
+ url,
1031
+ headers={**self._config.authenticate(), "Accept": "application/json"},
1032
+ timeout=self._ENDPOINTS_RESOLVE_TIMEOUT_SECONDS,
1033
+ )
1034
+ except Exception as e:
1035
+ # Broad on purpose: network and auth failures must all fail safe to the default order.
1036
+ _LOG.warning(f"Failed to resolve file endpoints, using the default endpoints: {e}")
1037
+ return []
1038
+
1039
+ # Lets a failure below be traced to the server's request log.
1040
+ request_id = response.headers.get("x-request-id")
1041
+ if response.status_code == 404:
1042
+ # Not a warning: until the server-side rollout completes, some workspaces do not serve the API.
1043
+ _LOG.info(
1044
+ f"Endpoints API is not served for this workspace (request ID {request_id}), using the default endpoints."
1045
+ )
1046
+ return []
1047
+ if response.status_code != 200:
1048
+ _LOG.warning(
1049
+ f"Unexpected status resolving file endpoints ({response.status_code}, request ID {request_id}), "
1050
+ "using the default endpoints."
1051
+ )
1052
+ return []
1053
+ try:
1054
+ body = response.json()
1055
+ except Exception as e:
1056
+ _LOG.warning(
1057
+ f"Failed to parse endpoints response (request ID {request_id}), using the default endpoints: {e}"
1058
+ )
1059
+ return []
1060
+
1061
+ # Proto3 JSON leaves out an empty repeated field.
1062
+ entries = body.get("endpoints", []) if isinstance(body, dict) else None
1063
+ if not isinstance(entries, list):
1064
+ _LOG.warning(
1065
+ f"Unexpected endpoints response (request ID {request_id}), using the default endpoints: {body}"
1066
+ )
1067
+ return []
1068
+ endpoints = []
1069
+ for entry in entries:
1070
+ kind = self._endpoint_kind(entry)
1071
+ if kind is None:
1072
+ # Not a warning: an older SDK is expected to skip entries for APIs added after it shipped.
1073
+ _LOG.info(f"Skipping endpoint this SDK cannot use (request ID {request_id}): {entry}")
1074
+ continue
1075
+ endpoint = self._parse_endpoint(entry, kind)
1076
+ if endpoint is None:
1077
+ _LOG.warning(
1078
+ f"Skipping {kind.value} endpoint with an unusable address (request ID {request_id}): {entry}"
1079
+ )
1080
+ continue
1081
+ endpoints.append(endpoint)
1082
+ if not endpoints:
1083
+ _LOG.warning(f"No usable endpoints in the response (request ID {request_id}), using the default endpoints.")
1084
+ return endpoints
1085
+
1086
+ @staticmethod
1087
+ def _endpoint_kind(entry) -> Optional[_ResolvedEndpoint]:
1088
+ """Returns the protocol of a listed endpoint, or None if this SDK does not speak it."""
1089
+ if not isinstance(entry, dict):
1090
+ return None
1091
+ api = entry.get("api")
1092
+ api_version = entry.get("api_version")
1093
+ # The entry is unvalidated JSON: an unhashable value such as a list would make the lookup below raise
1094
+ # instead of skipping the entry. IO_OFFLOAD entries have no api_version, so None is allowed.
1095
+ if not isinstance(api, str) or not (api_version is None or isinstance(api_version, str)):
1096
+ return None
1097
+ return _RECOGNIZED_ENDPOINTS.get((api, api_version))
1098
+
1099
+ @staticmethod
1100
+ def _parse_endpoint(entry: dict, kind: _ResolvedEndpoint) -> Optional[_Endpoint]:
1101
+ scheme = entry.get("scheme")
1102
+ hostname = entry.get("hostname")
1103
+ if scheme not in _ENDPOINT_SCHEMES or not isinstance(hostname, str) or not hostname:
1104
+ return None
1105
+ # Mirrors the proto getter: an unset optional bool reads as false.
1106
+ multipart_upload_supported = entry.get("multipart_upload_supported") is True
1107
+ return _Endpoint(kind, f"{scheme}://{hostname}", multipart_upload_supported)
1108
+
1109
+ def _active_endpoint(self) -> _Endpoint:
1110
+ """The endpoint used for bulk file transfer.
1111
+
1112
+ Selected by the storage-proxy probe: the storage proxy (a direct Files API path) when the probe
1113
+ finds it available, otherwise the offload (presigned) path on the workspace host. The probe runs
1114
+ once and its result is cached.
1115
+
1116
+ This is the single-endpoint selection; PR wiring the endpoints API replaces it with a walk over
1117
+ the server-resolved list.
966
1118
  """
967
1119
  if self._config.experimental_files_ext_enable_storage_proxy:
968
1120
  if self._dp_hostname_available is None:
@@ -972,19 +1124,28 @@ class FilesExt(files.FilesAPI):
972
1124
  else:
973
1125
  _LOG.info("Storage proxy is not available, will use presigned URLs.")
974
1126
  if self._dp_hostname_available:
975
- return self._STORAGE_PROXY_HOSTNAME
976
- return self._config.host
1127
+ return _Endpoint(
1128
+ _ResolvedEndpoint.FILES_API_V2, self._STORAGE_PROXY_HOSTNAME, multipart_upload_supported=True
1129
+ )
1130
+ return _Endpoint(_ResolvedEndpoint.IO_OFFLOAD, self._config.host, multipart_upload_supported=True)
1131
+
1132
+ def _get_hostname(self) -> str:
1133
+ """Returns the scheme+hostname for file operations, e.g. https://example.cloud.databricks.com."""
1134
+ return self._active_endpoint().base_url
977
1135
 
978
1136
  def _create_request_builder(self):
979
- """Creates the appropriate request builder for file operations.
1137
+ """Creates the request builder for the active endpoint."""
1138
+ return self._request_builder_for(self._active_endpoint())
1139
+
1140
+ def _request_builder_for(self, endpoint: _Endpoint):
1141
+ """Maps an endpoint to the builder that speaks its protocol.
980
1142
 
981
- Returns a storage proxy builder when the proxy is available,
982
- otherwise a presigned URL builder.
1143
+ The offload path coordinates presigned URLs through the workspace API; the direct Files API path
1144
+ builds URLs straight at the endpoint host.
983
1145
  """
984
- hostname = self._get_hostname()
985
- if self._config.experimental_files_ext_enable_storage_proxy and self._dp_hostname_available:
986
- return _StorageProxyRequestBuilder(hostname)
987
- return _PresignedUrlRequestBuilder(self._api, hostname)
1146
+ if endpoint.kind == _ResolvedEndpoint.IO_OFFLOAD:
1147
+ return _PresignedUrlRequestBuilder(self._api, endpoint.base_url)
1148
+ return _StorageProxyRequestBuilder(endpoint.base_url)
988
1149
 
989
1150
  def _resolve_workspace_id(self) -> Optional[str]:
990
1151
  """Resolves the workspace ID by querying the SCIM Me endpoint."""
@@ -138,10 +138,10 @@ class ForkSessionResponse:
138
138
 
139
139
  @dataclass
140
140
  class ListManagedMemoryEntriesResponse:
141
- """Response containing managed memory entries."""
141
+ """Response containing memory entries."""
142
142
 
143
143
  managed_memory_entries: Optional[List[ManagedMemoryEntry]] = None
144
- """Managed memory entries matching the request and selected response view."""
144
+ """Memory entries matching the request and selected response view."""
145
145
 
146
146
  next_page_token: Optional[str] = None
147
147
  """Opaque pagination token. This field is omitted when there are no more results."""
@@ -175,10 +175,10 @@ class ListManagedMemoryEntriesResponse:
175
175
 
176
176
  @dataclass
177
177
  class ListManagedMemoryStoresResponse:
178
- """Response containing managed memory stores in the caller's workspace."""
178
+ """Response containing memory stores in the caller's workspace."""
179
179
 
180
180
  managed_memory_stores: Optional[List[ManagedMemoryStore]] = None
181
- """Managed memory stores in the caller's workspace."""
181
+ """Memory stores in the caller's workspace."""
182
182
 
183
183
  next_page_token: Optional[str] = None
184
184
  """Opaque pagination token. This field is omitted when there are no more results."""
@@ -320,7 +320,7 @@ class ListSessionsResponse:
320
320
 
321
321
  @dataclass
322
322
  class ManagedMemoryEntry:
323
- """A workspace-scoped entry in a managed memory store."""
323
+ """A workspace-scoped entry in a memory store."""
324
324
 
325
325
  actor_id: str
326
326
  """Customer-provided identifier for the actor whose memory this entry represents."""
@@ -416,10 +416,10 @@ class ManagedMemoryEntry:
416
416
 
417
417
  @dataclass
418
418
  class ManagedMemoryEntrySearchResult:
419
- """One relevance-ranked managed memory search result."""
419
+ """One relevance-ranked memory search result."""
420
420
 
421
421
  managed_memory_entry: Optional[ManagedMemoryEntry] = None
422
- """Managed memory entry matching the query."""
422
+ """Memory entry matching the query."""
423
423
 
424
424
  score: Optional[float] = None
425
425
  """Relevance score for the result. Higher scores are more relevant."""
@@ -451,14 +451,14 @@ class ManagedMemoryEntrySearchResult:
451
451
 
452
452
 
453
453
  class ManagedMemoryEntrySourceType(Enum):
454
- """Identifies the source that created a managed memory entry."""
454
+ """Identifies the source that created a memory entry."""
455
455
 
456
456
  MANAGED_MEMORY_ENTRY_SOURCE_TYPE_AGENT = "MANAGED_MEMORY_ENTRY_SOURCE_TYPE_AGENT"
457
457
  MANAGED_MEMORY_ENTRY_SOURCE_TYPE_DREAMER = "MANAGED_MEMORY_ENTRY_SOURCE_TYPE_DREAMER"
458
458
 
459
459
 
460
460
  class ManagedMemoryEntryView(Enum):
461
- """Controls how much managed memory entry data is returned."""
461
+ """Controls how much memory entry data is returned."""
462
462
 
463
463
  MANAGED_MEMORY_ENTRY_VIEW_BASIC = "MANAGED_MEMORY_ENTRY_VIEW_BASIC"
464
464
  MANAGED_MEMORY_ENTRY_VIEW_FULL = "MANAGED_MEMORY_ENTRY_VIEW_FULL"
@@ -466,7 +466,7 @@ class ManagedMemoryEntryView(Enum):
466
466
 
467
467
  @dataclass
468
468
  class ManagedMemoryStore:
469
- """A workspace-scoped managed memory store backed by service-managed storage."""
469
+ """A workspace-scoped memory store backed by service-managed storage."""
470
470
 
471
471
  create_time: Optional[Timestamp] = None
472
472
  """Time when the store was created."""
@@ -480,9 +480,9 @@ class ManagedMemoryStore:
480
480
  """Human-readable description of the memory store."""
481
481
 
482
482
  display_name: Optional[str] = None
483
- """Deprecated compatibility alias for the caller-provided managed memory store ID. Canonical
484
- clients provide the ID through ``CreateMemoryStoreRequest.managed_memory_store_id`` and use
485
- ``name`` as the resource identifier."""
483
+ """Deprecated compatibility alias for the caller-provided memory store ID. Canonical clients
484
+ provide the ID through ``CreateMemoryStoreRequest.managed_memory_store_id`` and use ``name`` as
485
+ the resource identifier."""
486
486
 
487
487
  name: Optional[str] = None
488
488
  """Resource name in the form ``memory-stores/{managed_memory_store_id}``."""
@@ -591,7 +591,7 @@ class PopSessionItemResponse:
591
591
 
592
592
  @dataclass
593
593
  class SearchManagedMemoryEntriesResponse:
594
- """Response containing managed memory entries ranked by relevance."""
594
+ """Response containing memory entries ranked by relevance."""
595
595
 
596
596
  managed_memory_entries: Optional[List[ManagedMemoryEntry]] = None
597
597
  """Deprecated compatibility alias for clients migrating to ``results``. This contains the same
@@ -852,7 +852,7 @@ class SessionStore:
852
852
 
853
853
  @dataclass
854
854
  class StorageBackend:
855
- """Service-managed storage backing a managed memory store."""
855
+ """Service-managed storage backing a memory store."""
856
856
 
857
857
  backend_id: Optional[str] = None
858
858
  """Backend-specific identifier. For Lakebase, this is the project ID."""
@@ -885,7 +885,7 @@ class StorageBackend:
885
885
 
886
886
 
887
887
  class StorageBackendType(Enum):
888
- """Type of service-managed storage backing a managed memory store."""
888
+ """Type of service-managed storage backing a memory store."""
889
889
 
890
890
  STORAGE_BACKEND_TYPE_LAKEBASE = "STORAGE_BACKEND_TYPE_LAKEBASE"
891
891
 
@@ -951,19 +951,18 @@ class AgentKitAPI:
951
951
  def create_memory(
952
952
  self, parent: str, managed_memory_entry: ManagedMemoryEntry, *, managed_memory_entry_id: Optional[str] = None
953
953
  ) -> ManagedMemoryEntry:
954
- """Creates a managed memory entry using exclusive-create semantics. Callers may choose the entry ID; the
955
- service generates one when it is omitted. Returns ``ALREADY_EXISTS`` when an entry with the same
956
- actor, session, and path already exists. Omitted ``session_id`` is its own uniqueness key: two
954
+ """Creates a memory entry using exclusive-create semantics. Callers may choose the entry ID; the service
955
+ generates one when it is omitted. Returns ``ALREADY_EXISTS`` when an entry with the same actor,
956
+ session, and path already exists. Omitted ``session_id`` is its own uniqueness key: two
957
957
  omitted-session entries with the same actor and path conflict, but an omitted-session entry does not
958
958
  conflict with a session-scoped entry at the same actor and path.
959
959
 
960
960
  :param parent: str
961
- Managed memory store that will contain the entry, in the form
962
- ``memory-stores/{managed_memory_store_id}``.
961
+ Memory store that will contain the entry, in the form ``memory-stores/{managed_memory_store_id}``.
963
962
  :param managed_memory_entry: :class:`ManagedMemoryEntry`
964
- The managed memory entry to create.
963
+ The memory entry to create.
965
964
  :param managed_memory_entry_id: str (optional)
966
- Optional caller-selected managed memory entry ID. The service generates an ID when omitted.
965
+ Optional caller-selected memory entry ID. The service generates an ID when omitted.
967
966
 
968
967
  :returns: :class:`ManagedMemoryEntry`
969
968
  """
@@ -987,12 +986,12 @@ class AgentKitAPI:
987
986
  def create_memory_store(
988
987
  self, managed_memory_store: ManagedMemoryStore, managed_memory_store_id: str
989
988
  ) -> ManagedMemoryStore:
990
- """Creates a managed memory store in the caller's workspace.
989
+ """Creates a memory store in the caller's workspace.
991
990
 
992
991
  :param managed_memory_store: :class:`ManagedMemoryStore`
993
- The managed memory store to create.
992
+ The memory store to create.
994
993
  :param managed_memory_store_id: str
995
- Caller-provided, workspace-unique managed memory store ID. It must be 3-56 characters, begin with a
994
+ Caller-provided, workspace-unique memory store ID. It must be 3-56 characters, begin with a
996
995
  lowercase letter, contain only lowercase letters, digits, and hyphens, and end with a letter or
997
996
  digit.
998
997
 
@@ -1075,8 +1074,8 @@ class AgentKitAPI:
1075
1074
  return SessionStore.from_dict(res)
1076
1075
 
1077
1076
  def delete_memory(self, name: str):
1078
- """Deletes a managed memory entry by resource name. Returns ``NOT_FOUND`` when the entry does not exist
1079
- in the caller's workspace.
1077
+ """Deletes a memory entry by resource name. Returns ``NOT_FOUND`` when the entry does not exist in the
1078
+ caller's workspace.
1080
1079
 
1081
1080
  :param name: str
1082
1081
  Resource name in the form
@@ -1096,8 +1095,8 @@ class AgentKitAPI:
1096
1095
  self._api.do("DELETE", f"/api/2.0/agents/{name}", headers=headers)
1097
1096
 
1098
1097
  def delete_memory_store(self, name: str):
1099
- """Deletes a managed memory store by resource name. Returns ``NOT_FOUND`` when the store does not exist
1100
- in the caller's workspace.
1098
+ """Deletes a memory store by resource name. Returns ``NOT_FOUND`` when the store does not exist in the
1099
+ caller's workspace.
1101
1100
 
1102
1101
  :param name: str
1103
1102
  Resource name in the form ``memory-stores/{managed_memory_store_id}``.
@@ -1172,7 +1171,7 @@ class AgentKitAPI:
1172
1171
  :param session_id: str
1173
1172
  Identifier of the session whose transcript is distilled into memories.
1174
1173
  :param memory_store: str
1175
- Managed memory store the extracted entries are written to, in the form
1174
+ Memory store the extracted entries are written to, in the form
1176
1175
  ``memory-stores/{managed_memory_store_id}``.
1177
1176
  :param dry_run: bool (optional)
1178
1177
  When true, extract and return the entries without writing them to the memory store. Defaults to
@@ -1257,8 +1256,8 @@ class AgentKitAPI:
1257
1256
  return ForkSessionResponse.from_dict(res)
1258
1257
 
1259
1258
  def get_memory(self, name: str, *, view: Optional[ManagedMemoryEntryView] = None) -> ManagedMemoryEntry:
1260
- """Retrieves a managed memory entry by resource name. ``view`` controls whether the response includes
1261
- memory content. Returns ``NOT_FOUND`` when the entry does not exist in the caller's workspace.
1259
+ """Retrieves a memory entry by resource name. ``view`` controls whether the response includes memory
1260
+ content. Returns ``NOT_FOUND`` when the entry does not exist in the caller's workspace.
1262
1261
 
1263
1262
  :param name: str
1264
1263
  Resource name in the form
@@ -1284,8 +1283,8 @@ class AgentKitAPI:
1284
1283
  return ManagedMemoryEntry.from_dict(res)
1285
1284
 
1286
1285
  def get_memory_store(self, name: str) -> ManagedMemoryStore:
1287
- """Retrieves a managed memory store by resource name. Returns ``NOT_FOUND`` when the store does not exist
1288
- in the caller's workspace.
1286
+ """Retrieves a memory store by resource name. Returns ``NOT_FOUND`` when the store does not exist in the
1287
+ caller's workspace.
1289
1288
 
1290
1289
  :param name: str
1291
1290
  Resource name in the form ``memory-stores/{managed_memory_store_id}``.
@@ -1355,13 +1354,12 @@ class AgentKitAPI:
1355
1354
  session_id: Optional[str] = None,
1356
1355
  view: Optional[ManagedMemoryEntryView] = None,
1357
1356
  ) -> Iterator[ManagedMemoryEntry]:
1358
- """Lists managed memory entries for one actor. An exact ``path`` filters entries across sessions,
1359
- ignoring session metadata. Otherwise, ``session_id`` and ``path_prefix`` restrict the actor partition.
1360
- ``view`` controls whether each returned entry includes memory content.
1357
+ """Lists memory entries for one actor. An exact ``path`` filters entries across sessions, ignoring
1358
+ session metadata. Otherwise, ``session_id`` and ``path_prefix`` restrict the actor partition. ``view``
1359
+ controls whether each returned entry includes memory content.
1361
1360
 
1362
1361
  :param parent: str
1363
- Managed memory store whose entries are listed, in the form
1364
- ``memory-stores/{managed_memory_store_id}``.
1362
+ Memory store whose entries are listed, in the form ``memory-stores/{managed_memory_store_id}``.
1365
1363
  :param actor_id: str
1366
1364
  Customer-provided identifier for the actor whose entries are listed.
1367
1365
  :param page_size: int (optional)
@@ -1413,7 +1411,7 @@ class AgentKitAPI:
1413
1411
  def list_memory_stores(
1414
1412
  self, *, page_size: Optional[int] = None, page_token: Optional[str] = None
1415
1413
  ) -> Iterator[ManagedMemoryStore]:
1416
- """Lists managed memory stores in the caller's workspace.
1414
+ """Lists memory stores in the caller's workspace.
1417
1415
 
1418
1416
  :param page_size: int (optional)
1419
1417
  Maximum number of stores to return. The service may return fewer stores than requested. Defaults to
@@ -1621,12 +1619,11 @@ class AgentKitAPI:
1621
1619
  session_id: Optional[str] = None,
1622
1620
  view: Optional[ManagedMemoryEntryView] = None,
1623
1621
  ) -> Iterator[ManagedMemoryEntrySearchResult]:
1624
- """Searches managed memory entries by text query for one actor. Returns matching entries and scores
1625
- ranked by relevance; ``view`` controls whether each returned entry includes content.
1622
+ """Searches memory entries by text query for one actor. Returns matching entries and scores ranked by
1623
+ relevance; ``view`` controls whether each returned entry includes content.
1626
1624
 
1627
1625
  :param parent: str
1628
- Managed memory store whose entries are searched, in the form
1629
- ``memory-stores/{managed_memory_store_id}``.
1626
+ Memory store whose entries are searched, in the form ``memory-stores/{managed_memory_store_id}``.
1630
1627
  :param actor_id: str
1631
1628
  Customer-provided identifier for the actor whose entries are searched.
1632
1629
  :param query: str
@@ -1689,13 +1686,13 @@ class AgentKitAPI:
1689
1686
  def update_memory(
1690
1687
  self, name: str, managed_memory_entry: ManagedMemoryEntry, update_mask: FieldMask
1691
1688
  ) -> ManagedMemoryEntry:
1692
- """Updates selected mutable fields on a managed memory entry. Identity fields are immutable.
1689
+ """Updates selected mutable fields on a memory entry. Identity fields are immutable.
1693
1690
 
1694
1691
  :param name: str
1695
1692
  Resource name in the form
1696
1693
  ``memory-stores/{managed_memory_store_id}/entries/{managed_memory_entry_id}``.
1697
1694
  :param managed_memory_entry: :class:`ManagedMemoryEntry`
1698
- The managed memory entry to update.
1695
+ The memory entry to update.
1699
1696
  :param update_mask: FieldMask
1700
1697
  Fields to update. Only ``content`` and ``description`` may be updated.
1701
1698
 
@@ -1721,12 +1718,12 @@ class AgentKitAPI:
1721
1718
  def update_memory_store(
1722
1719
  self, name: str, managed_memory_store: ManagedMemoryStore, update_mask: FieldMask
1723
1720
  ) -> ManagedMemoryStore:
1724
- """Updates a managed memory store's description and metadata.
1721
+ """Updates a memory store's description and metadata.
1725
1722
 
1726
1723
  :param name: str
1727
1724
  Resource name in the form ``memory-stores/{managed_memory_store_id}``.
1728
1725
  :param managed_memory_store: :class:`ManagedMemoryStore`
1729
- The managed memory store to update. ``name`` is taken from the URL.
1726
+ The memory store to update. ``name`` is taken from the URL.
1730
1727
  :param update_mask: FieldMask
1731
1728
  Only ``description`` and ``metadata`` may be updated. Selecting ``metadata`` replaces the entire
1732
1729
  map.
@@ -193,8 +193,15 @@ class BudgetConfiguration:
193
193
  """Databricks account ID."""
194
194
 
195
195
  alert_configurations: Optional[List[AlertConfiguration]] = None
196
- """Alerts to configure when this budget is in a triggered state. Budgets must have exactly one
197
- alert configuration."""
196
+ """Alerts to configure when this budget is in a triggered state. Budgets must have at least one
197
+ alert configuration. A budget can have up to four shared alerts per time period, each with a
198
+ unique ``quantity_threshold``. Budgets with ``resource_type`` set to
199
+ ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY`` can also use per-user alerts, with optional
200
+ ``principal_overrides``. These budgets can have at most one per-user alert per time period, and
201
+ can use shared alerts, a per-user alert, or both. The ``BLOCK_USAGE`` action is only supported
202
+ on budgets with ``resource_type`` set to ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY``. At most one
203
+ shared alert per time period can have a ``BLOCK_USAGE`` action, and it must be the shared alert
204
+ with the highest threshold in that period."""
198
205
 
199
206
  budget_configuration_id: Optional[str] = None
200
207
  """Databricks budget configuration ID."""
@@ -504,8 +511,15 @@ class CreateBudgetConfigurationBudget:
504
511
  """Databricks account ID."""
505
512
 
506
513
  alert_configurations: Optional[List[CreateBudgetConfigurationBudgetAlertConfigurations]] = None
507
- """Alerts to configure when this budget is in a triggered state. Budgets must have exactly one
508
- alert configuration."""
514
+ """Alerts to configure when this budget is in a triggered state. Budgets must have at least one
515
+ alert configuration. A budget can have up to four shared alerts per time period, each with a
516
+ unique ``quantity_threshold``. Budgets with ``resource_type`` set to
517
+ ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY`` can also use per-user alerts, with optional
518
+ ``principal_overrides``. These budgets can have at most one per-user alert per time period, and
519
+ can use shared alerts, a per-user alert, or both. The ``BLOCK_USAGE`` action is only supported
520
+ on budgets with ``resource_type`` set to ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY``. At most one
521
+ shared alert per time period can have a ``BLOCK_USAGE`` action, and it must be the shared alert
522
+ with the highest threshold in that period."""
509
523
 
510
524
  display_name: Optional[str] = None
511
525
  """Human-readable name of budget configuration. Max Length: 128"""
@@ -1470,8 +1484,15 @@ class UpdateBudgetConfigurationBudget:
1470
1484
  """Databricks account ID."""
1471
1485
 
1472
1486
  alert_configurations: Optional[List[AlertConfiguration]] = None
1473
- """Alerts to configure when this budget is in a triggered state. Budgets must have exactly one
1474
- alert configuration."""
1487
+ """Alerts to configure when this budget is in a triggered state. Budgets must have at least one
1488
+ alert configuration. A budget can have up to four shared alerts per time period, each with a
1489
+ unique ``quantity_threshold``. Budgets with ``resource_type`` set to
1490
+ ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY`` can also use per-user alerts, with optional
1491
+ ``principal_overrides``. These budgets can have at most one per-user alert per time period, and
1492
+ can use shared alerts, a per-user alert, or both. The ``BLOCK_USAGE`` action is only supported
1493
+ on budgets with ``resource_type`` set to ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY``. At most one
1494
+ shared alert per time period can have a ``BLOCK_USAGE`` action, and it must be the shared alert
1495
+ with the highest threshold in that period."""
1475
1496
 
1476
1497
  budget_configuration_id: Optional[str] = None
1477
1498
  """Databricks budget configuration ID."""