databricks-sdk 0.70.0__py3-none-any.whl → 0.71.0__py3-none-any.whl

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.

Potentially problematic release.


This version of databricks-sdk might be problematic. Click here for more details.

Files changed (36) hide show
  1. databricks/sdk/__init__.py +24 -24
  2. databricks/sdk/mixins/files.py +10 -10
  3. databricks/sdk/service/agentbricks.py +2 -0
  4. databricks/sdk/service/apps.py +10 -0
  5. databricks/sdk/service/billing.py +13 -3
  6. databricks/sdk/service/catalog.py +129 -46
  7. databricks/sdk/service/cleanrooms.py +11 -3
  8. databricks/sdk/service/compute.py +54 -0
  9. databricks/sdk/service/dashboards.py +10 -0
  10. databricks/sdk/service/database.py +12 -0
  11. databricks/sdk/service/dataquality.py +4 -0
  12. databricks/sdk/service/files.py +7 -72
  13. databricks/sdk/service/iam.py +26 -36
  14. databricks/sdk/service/iamv2.py +6 -0
  15. databricks/sdk/service/jobs.py +13 -116
  16. databricks/sdk/service/marketplace.py +18 -0
  17. databricks/sdk/service/ml.py +171 -17
  18. databricks/sdk/service/oauth2.py +10 -18
  19. databricks/sdk/service/pipelines.py +23 -0
  20. databricks/sdk/service/provisioning.py +9 -0
  21. databricks/sdk/service/qualitymonitorv2.py +2 -0
  22. databricks/sdk/service/serving.py +16 -21
  23. databricks/sdk/service/settings.py +43 -72
  24. databricks/sdk/service/settingsv2.py +2 -0
  25. databricks/sdk/service/sharing.py +23 -31
  26. databricks/sdk/service/sql.py +48 -24
  27. databricks/sdk/service/tags.py +2 -0
  28. databricks/sdk/service/vectorsearch.py +8 -0
  29. databricks/sdk/service/workspace.py +18 -91
  30. databricks/sdk/version.py +1 -1
  31. {databricks_sdk-0.70.0.dist-info → databricks_sdk-0.71.0.dist-info}/METADATA +1 -1
  32. {databricks_sdk-0.70.0.dist-info → databricks_sdk-0.71.0.dist-info}/RECORD +36 -36
  33. {databricks_sdk-0.70.0.dist-info → databricks_sdk-0.71.0.dist-info}/WHEEL +0 -0
  34. {databricks_sdk-0.70.0.dist-info → databricks_sdk-0.71.0.dist-info}/licenses/LICENSE +0 -0
  35. {databricks_sdk-0.70.0.dist-info → databricks_sdk-0.71.0.dist-info}/licenses/NOTICE +0 -0
  36. {databricks_sdk-0.70.0.dist-info → databricks_sdk-0.71.0.dist-info}/top_level.txt +0 -0
@@ -1697,24 +1697,6 @@ class DeletePersonalComputeSettingResponse:
1697
1697
  return cls(etag=d.get("etag", None))
1698
1698
 
1699
1699
 
1700
- @dataclass
1701
- class DeleteResponse:
1702
- def as_dict(self) -> dict:
1703
- """Serializes the DeleteResponse into a dictionary suitable for use as a JSON request body."""
1704
- body = {}
1705
- return body
1706
-
1707
- def as_shallow_dict(self) -> dict:
1708
- """Serializes the DeleteResponse into a shallow dictionary of its immediate attributes."""
1709
- body = {}
1710
- return body
1711
-
1712
- @classmethod
1713
- def from_dict(cls, d: Dict[str, Any]) -> DeleteResponse:
1714
- """Deserializes the DeleteResponse from a dictionary."""
1715
- return cls()
1716
-
1717
-
1718
1700
  @dataclass
1719
1701
  class DeleteRestrictWorkspaceAdminsSettingResponse:
1720
1702
  """The etag is returned."""
@@ -4553,24 +4535,6 @@ class PublicTokenInfo:
4553
4535
  )
4554
4536
 
4555
4537
 
4556
- @dataclass
4557
- class ReplaceResponse:
4558
- def as_dict(self) -> dict:
4559
- """Serializes the ReplaceResponse into a dictionary suitable for use as a JSON request body."""
4560
- body = {}
4561
- return body
4562
-
4563
- def as_shallow_dict(self) -> dict:
4564
- """Serializes the ReplaceResponse into a shallow dictionary of its immediate attributes."""
4565
- body = {}
4566
- return body
4567
-
4568
- @classmethod
4569
- def from_dict(cls, d: Dict[str, Any]) -> ReplaceResponse:
4570
- """Deserializes the ReplaceResponse from a dictionary."""
4571
- return cls()
4572
-
4573
-
4574
4538
  @dataclass
4575
4539
  class RestrictWorkspaceAdminsMessage:
4576
4540
  status: RestrictWorkspaceAdminsMessageStatus
@@ -4669,24 +4633,6 @@ class RevokeTokenResponse:
4669
4633
  return cls()
4670
4634
 
4671
4635
 
4672
- @dataclass
4673
- class SetStatusResponse:
4674
- def as_dict(self) -> dict:
4675
- """Serializes the SetStatusResponse into a dictionary suitable for use as a JSON request body."""
4676
- body = {}
4677
- return body
4678
-
4679
- def as_shallow_dict(self) -> dict:
4680
- """Serializes the SetStatusResponse into a shallow dictionary of its immediate attributes."""
4681
- body = {}
4682
- return body
4683
-
4684
- @classmethod
4685
- def from_dict(cls, d: Dict[str, Any]) -> SetStatusResponse:
4686
- """Deserializes the SetStatusResponse from a dictionary."""
4687
- return cls()
4688
-
4689
-
4690
4636
  @dataclass
4691
4637
  class SlackConfig:
4692
4638
  channel_id: Optional[str] = None
@@ -5215,24 +5161,6 @@ class UpdatePrivateEndpointRule:
5215
5161
  )
5216
5162
 
5217
5163
 
5218
- @dataclass
5219
- class UpdateResponse:
5220
- def as_dict(self) -> dict:
5221
- """Serializes the UpdateResponse into a dictionary suitable for use as a JSON request body."""
5222
- body = {}
5223
- return body
5224
-
5225
- def as_shallow_dict(self) -> dict:
5226
- """Serializes the UpdateResponse into a shallow dictionary of its immediate attributes."""
5227
- body = {}
5228
- return body
5229
-
5230
- @classmethod
5231
- def from_dict(cls, d: Dict[str, Any]) -> UpdateResponse:
5232
- """Deserializes the UpdateResponse from a dictionary."""
5233
- return cls()
5234
-
5235
-
5236
5164
  WorkspaceConf = Dict[str, str]
5237
5165
 
5238
5166
 
@@ -5317,6 +5245,7 @@ class AccountIpAccessListsAPI:
5317
5245
 
5318
5246
  :returns: :class:`CreateIpAccessListResponse`
5319
5247
  """
5248
+
5320
5249
  body = {}
5321
5250
  if ip_addresses is not None:
5322
5251
  body["ip_addresses"] = [v for v in ip_addresses]
@@ -5412,6 +5341,7 @@ class AccountIpAccessListsAPI:
5412
5341
 
5413
5342
 
5414
5343
  """
5344
+
5415
5345
  body = {}
5416
5346
  if enabled is not None:
5417
5347
  body["enabled"] = enabled
@@ -5466,6 +5396,7 @@ class AccountIpAccessListsAPI:
5466
5396
 
5467
5397
 
5468
5398
  """
5399
+
5469
5400
  body = {}
5470
5401
  if enabled is not None:
5471
5402
  body["enabled"] = enabled
@@ -5619,6 +5550,7 @@ class AibiDashboardEmbeddingAccessPolicyAPI:
5619
5550
 
5620
5551
  :returns: :class:`AibiDashboardEmbeddingAccessPolicySetting`
5621
5552
  """
5553
+
5622
5554
  body = {}
5623
5555
  if allow_missing is not None:
5624
5556
  body["allow_missing"] = allow_missing
@@ -5723,6 +5655,7 @@ class AibiDashboardEmbeddingApprovedDomainsAPI:
5723
5655
 
5724
5656
  :returns: :class:`AibiDashboardEmbeddingApprovedDomainsSetting`
5725
5657
  """
5658
+
5726
5659
  body = {}
5727
5660
  if allow_missing is not None:
5728
5661
  body["allow_missing"] = allow_missing
@@ -5800,6 +5733,7 @@ class AutomaticClusterUpdateAPI:
5800
5733
 
5801
5734
  :returns: :class:`AutomaticClusterUpdateSetting`
5802
5735
  """
5736
+
5803
5737
  body = {}
5804
5738
  if allow_missing is not None:
5805
5739
  body["allow_missing"] = allow_missing
@@ -5876,6 +5810,7 @@ class ComplianceSecurityProfileAPI:
5876
5810
 
5877
5811
  :returns: :class:`ComplianceSecurityProfileSetting`
5878
5812
  """
5813
+
5879
5814
  body = {}
5880
5815
  if allow_missing is not None:
5881
5816
  body["allow_missing"] = allow_missing
@@ -5916,6 +5851,7 @@ class CredentialsManagerAPI:
5916
5851
 
5917
5852
  :returns: :class:`ExchangeTokenResponse`
5918
5853
  """
5854
+
5919
5855
  body = {}
5920
5856
  if partition_id is not None:
5921
5857
  body["partitionId"] = partition_id.as_dict()
@@ -5992,6 +5928,7 @@ class CspEnablementAccountAPI:
5992
5928
 
5993
5929
  :returns: :class:`CspEnablementAccountSetting`
5994
5930
  """
5931
+
5995
5932
  body = {}
5996
5933
  if allow_missing is not None:
5997
5934
  body["allow_missing"] = allow_missing
@@ -6095,6 +6032,7 @@ class DashboardEmailSubscriptionsAPI:
6095
6032
 
6096
6033
  :returns: :class:`DashboardEmailSubscriptions`
6097
6034
  """
6035
+
6098
6036
  body = {}
6099
6037
  if allow_missing is not None:
6100
6038
  body["allow_missing"] = allow_missing
@@ -6205,6 +6143,7 @@ class DefaultNamespaceAPI:
6205
6143
 
6206
6144
  :returns: :class:`DefaultNamespaceSetting`
6207
6145
  """
6146
+
6208
6147
  body = {}
6209
6148
  if allow_missing is not None:
6210
6149
  body["allow_missing"] = allow_missing
@@ -6299,6 +6238,7 @@ class DefaultWarehouseIdAPI:
6299
6238
 
6300
6239
  :returns: :class:`DefaultWarehouseId`
6301
6240
  """
6241
+
6302
6242
  body = {}
6303
6243
  if allow_missing is not None:
6304
6244
  body["allow_missing"] = allow_missing
@@ -6396,6 +6336,7 @@ class DisableLegacyAccessAPI:
6396
6336
 
6397
6337
  :returns: :class:`DisableLegacyAccess`
6398
6338
  """
6339
+
6399
6340
  body = {}
6400
6341
  if allow_missing is not None:
6401
6342
  body["allow_missing"] = allow_missing
@@ -6496,6 +6437,7 @@ class DisableLegacyDbfsAPI:
6496
6437
 
6497
6438
  :returns: :class:`DisableLegacyDbfs`
6498
6439
  """
6440
+
6499
6441
  body = {}
6500
6442
  if allow_missing is not None:
6501
6443
  body["allow_missing"] = allow_missing
@@ -6599,6 +6541,7 @@ class DisableLegacyFeaturesAPI:
6599
6541
 
6600
6542
  :returns: :class:`DisableLegacyFeatures`
6601
6543
  """
6544
+
6602
6545
  body = {}
6603
6546
  if allow_missing is not None:
6604
6547
  body["allow_missing"] = allow_missing
@@ -6663,6 +6606,7 @@ class EnableExportNotebookAPI:
6663
6606
 
6664
6607
  :returns: :class:`EnableExportNotebook`
6665
6608
  """
6609
+
6666
6610
  body = {}
6667
6611
  if allow_missing is not None:
6668
6612
  body["allow_missing"] = allow_missing
@@ -6763,6 +6707,7 @@ class EnableIpAccessListsAPI:
6763
6707
 
6764
6708
  :returns: :class:`AccountIpAccessEnable`
6765
6709
  """
6710
+
6766
6711
  body = {}
6767
6712
  if allow_missing is not None:
6768
6713
  body["allow_missing"] = allow_missing
@@ -6829,6 +6774,7 @@ class EnableNotebookTableClipboardAPI:
6829
6774
 
6830
6775
  :returns: :class:`EnableNotebookTableClipboard`
6831
6776
  """
6777
+
6832
6778
  body = {}
6833
6779
  if allow_missing is not None:
6834
6780
  body["allow_missing"] = allow_missing
@@ -6889,6 +6835,7 @@ class EnableResultsDownloadingAPI:
6889
6835
 
6890
6836
  :returns: :class:`EnableResultsDownloading`
6891
6837
  """
6838
+
6892
6839
  body = {}
6893
6840
  if allow_missing is not None:
6894
6841
  body["allow_missing"] = allow_missing
@@ -6967,6 +6914,7 @@ class EnhancedSecurityMonitoringAPI:
6967
6914
 
6968
6915
  :returns: :class:`EnhancedSecurityMonitoringSetting`
6969
6916
  """
6917
+
6970
6918
  body = {}
6971
6919
  if allow_missing is not None:
6972
6920
  body["allow_missing"] = allow_missing
@@ -7042,6 +6990,7 @@ class EsmEnablementAccountAPI:
7042
6990
 
7043
6991
  :returns: :class:`EsmEnablementAccountSetting`
7044
6992
  """
6993
+
7045
6994
  body = {}
7046
6995
  if allow_missing is not None:
7047
6996
  body["allow_missing"] = allow_missing
@@ -7110,6 +7059,7 @@ class IpAccessListsAPI:
7110
7059
 
7111
7060
  :returns: :class:`CreateIpAccessListResponse`
7112
7061
  """
7062
+
7113
7063
  body = {}
7114
7064
  if ip_addresses is not None:
7115
7065
  body["ip_addresses"] = [v for v in ip_addresses]
@@ -7200,6 +7150,7 @@ class IpAccessListsAPI:
7200
7150
 
7201
7151
 
7202
7152
  """
7153
+
7203
7154
  body = {}
7204
7155
  if enabled is not None:
7205
7156
  body["enabled"] = enabled
@@ -7250,6 +7201,7 @@ class IpAccessListsAPI:
7250
7201
 
7251
7202
 
7252
7203
  """
7204
+
7253
7205
  body = {}
7254
7206
  if enabled is not None:
7255
7207
  body["enabled"] = enabled
@@ -7321,6 +7273,7 @@ class LlmProxyPartnerPoweredAccountAPI:
7321
7273
 
7322
7274
  :returns: :class:`LlmProxyPartnerPoweredAccount`
7323
7275
  """
7276
+
7324
7277
  body = {}
7325
7278
  if allow_missing is not None:
7326
7279
  body["allow_missing"] = allow_missing
@@ -7398,6 +7351,7 @@ class LlmProxyPartnerPoweredEnforceAPI:
7398
7351
 
7399
7352
  :returns: :class:`LlmProxyPartnerPoweredEnforce`
7400
7353
  """
7354
+
7401
7355
  body = {}
7402
7356
  if allow_missing is not None:
7403
7357
  body["allow_missing"] = allow_missing
@@ -7496,6 +7450,7 @@ class LlmProxyPartnerPoweredWorkspaceAPI:
7496
7450
 
7497
7451
  :returns: :class:`LlmProxyPartnerPoweredWorkspace`
7498
7452
  """
7453
+
7499
7454
  body = {}
7500
7455
  if allow_missing is not None:
7501
7456
  body["allow_missing"] = allow_missing
@@ -7546,6 +7501,7 @@ class NetworkConnectivityAPI:
7546
7501
 
7547
7502
  :returns: :class:`NetworkConnectivityConfiguration`
7548
7503
  """
7504
+
7549
7505
  body = network_connectivity_config.as_dict()
7550
7506
  headers = {
7551
7507
  "Accept": "application/json",
@@ -7576,6 +7532,7 @@ class NetworkConnectivityAPI:
7576
7532
 
7577
7533
  :returns: :class:`NccPrivateEndpointRule`
7578
7534
  """
7535
+
7579
7536
  body = private_endpoint_rule.as_dict()
7580
7537
  headers = {
7581
7538
  "Accept": "application/json",
@@ -7773,6 +7730,7 @@ class NetworkConnectivityAPI:
7773
7730
 
7774
7731
  :returns: :class:`NccPrivateEndpointRule`
7775
7732
  """
7733
+
7776
7734
  body = private_endpoint_rule.as_dict()
7777
7735
  query = {}
7778
7736
  if update_mask is not None:
@@ -7812,6 +7770,7 @@ class NetworkPoliciesAPI:
7812
7770
 
7813
7771
  :returns: :class:`AccountNetworkPolicy`
7814
7772
  """
7773
+
7815
7774
  body = network_policy.as_dict()
7816
7775
  headers = {
7817
7776
  "Accept": "application/json",
@@ -7897,6 +7856,7 @@ class NetworkPoliciesAPI:
7897
7856
 
7898
7857
  :returns: :class:`AccountNetworkPolicy`
7899
7858
  """
7859
+
7900
7860
  body = network_policy.as_dict()
7901
7861
  headers = {
7902
7862
  "Accept": "application/json",
@@ -7931,6 +7891,7 @@ class NotificationDestinationsAPI:
7931
7891
 
7932
7892
  :returns: :class:`NotificationDestination`
7933
7893
  """
7894
+
7934
7895
  body = {}
7935
7896
  if config is not None:
7936
7897
  body["config"] = config.as_dict()
@@ -8017,6 +7978,7 @@ class NotificationDestinationsAPI:
8017
7978
 
8018
7979
  :returns: :class:`NotificationDestination`
8019
7980
  """
7981
+
8020
7982
  body = {}
8021
7983
  if config is not None:
8022
7984
  body["config"] = config.as_dict()
@@ -8118,6 +8080,7 @@ class PersonalComputeAPI:
8118
8080
 
8119
8081
  :returns: :class:`PersonalComputeSetting`
8120
8082
  """
8083
+
8121
8084
  body = {}
8122
8085
  if allow_missing is not None:
8123
8086
  body["allow_missing"] = allow_missing
@@ -8230,6 +8193,7 @@ class RestrictWorkspaceAdminsAPI:
8230
8193
 
8231
8194
  :returns: :class:`RestrictWorkspaceAdminsSetting`
8232
8195
  """
8196
+
8233
8197
  body = {}
8234
8198
  if allow_missing is not None:
8235
8199
  body["allow_missing"] = allow_missing
@@ -8428,6 +8392,7 @@ class SqlResultsDownloadAPI:
8428
8392
 
8429
8393
  :returns: :class:`SqlResultsDownload`
8430
8394
  """
8395
+
8431
8396
  body = {}
8432
8397
  if allow_missing is not None:
8433
8398
  body["allow_missing"] = allow_missing
@@ -8467,6 +8432,7 @@ class TokenManagementAPI:
8467
8432
 
8468
8433
  :returns: :class:`CreateOboTokenResponse`
8469
8434
  """
8435
+
8470
8436
  body = {}
8471
8437
  if application_id is not None:
8472
8438
  body["application_id"] = application_id
@@ -8575,6 +8541,7 @@ class TokenManagementAPI:
8575
8541
 
8576
8542
  :returns: :class:`TokenPermissions`
8577
8543
  """
8544
+
8578
8545
  body = {}
8579
8546
  if access_control_list is not None:
8580
8547
  body["access_control_list"] = [v.as_dict() for v in access_control_list]
@@ -8595,6 +8562,7 @@ class TokenManagementAPI:
8595
8562
 
8596
8563
  :returns: :class:`TokenPermissions`
8597
8564
  """
8565
+
8598
8566
  body = {}
8599
8567
  if access_control_list is not None:
8600
8568
  body["access_control_list"] = [v.as_dict() for v in access_control_list]
@@ -8628,6 +8596,7 @@ class TokensAPI:
8628
8596
 
8629
8597
  :returns: :class:`CreateTokenResponse`
8630
8598
  """
8599
+
8631
8600
  body = {}
8632
8601
  if comment is not None:
8633
8602
  body["comment"] = comment
@@ -8651,6 +8620,7 @@ class TokensAPI:
8651
8620
 
8652
8621
 
8653
8622
  """
8623
+
8654
8624
  body = {}
8655
8625
  if token_id is not None:
8656
8626
  body["token_id"] = token_id
@@ -8753,6 +8723,7 @@ class WorkspaceNetworkConfigurationAPI:
8753
8723
 
8754
8724
  :returns: :class:`WorkspaceNetworkOption`
8755
8725
  """
8726
+
8756
8727
  body = workspace_network_option.as_dict()
8757
8728
  headers = {
8758
8729
  "Accept": "application/json",
@@ -793,6 +793,7 @@ class AccountSettingsV2API:
793
793
 
794
794
  :returns: :class:`Setting`
795
795
  """
796
+
796
797
  body = setting.as_dict()
797
798
  headers = {
798
799
  "Accept": "application/json",
@@ -875,6 +876,7 @@ class WorkspaceSettingsV2API:
875
876
 
876
877
  :returns: :class:`Setting`
877
878
  """
879
+
878
880
  body = setting.as_dict()
879
881
  headers = {
880
882
  "Accept": "application/json",
@@ -55,24 +55,6 @@ class ColumnTypeName(Enum):
55
55
  VARIANT = "VARIANT"
56
56
 
57
57
 
58
- @dataclass
59
- class DeleteResponse:
60
- def as_dict(self) -> dict:
61
- """Serializes the DeleteResponse into a dictionary suitable for use as a JSON request body."""
62
- body = {}
63
- return body
64
-
65
- def as_shallow_dict(self) -> dict:
66
- """Serializes the DeleteResponse into a shallow dictionary of its immediate attributes."""
67
- body = {}
68
- return body
69
-
70
- @classmethod
71
- def from_dict(cls, d: Dict[str, Any]) -> DeleteResponse:
72
- """Deserializes the DeleteResponse from a dictionary."""
73
- return cls()
74
-
75
-
76
58
  @dataclass
77
59
  class DeltaSharingDependency:
78
60
  """Represents a UC dependency."""
@@ -2563,6 +2545,7 @@ class ProvidersAPI:
2563
2545
 
2564
2546
  :returns: :class:`ProviderInfo`
2565
2547
  """
2548
+
2566
2549
  body = {}
2567
2550
  if authentication_type is not None:
2568
2551
  body["authentication_type"] = authentication_type.value
@@ -2778,6 +2761,7 @@ class ProvidersAPI:
2778
2761
 
2779
2762
  :returns: :class:`ProviderInfo`
2780
2763
  """
2764
+
2781
2765
  body = {}
2782
2766
  if comment is not None:
2783
2767
  body["comment"] = comment
@@ -2898,6 +2882,7 @@ class RecipientFederationPoliciesAPI:
2898
2882
 
2899
2883
  :returns: :class:`FederationPolicy`
2900
2884
  """
2885
+
2901
2886
  body = policy.as_dict()
2902
2887
  headers = {
2903
2888
  "Accept": "application/json",
@@ -3047,6 +3032,7 @@ class RecipientsAPI:
3047
3032
 
3048
3033
  :returns: :class:`RecipientInfo`
3049
3034
  """
3035
+
3050
3036
  body = {}
3051
3037
  if authentication_type is not None:
3052
3038
  body["authentication_type"] = authentication_type.value
@@ -3169,6 +3155,7 @@ class RecipientsAPI:
3169
3155
 
3170
3156
  :returns: :class:`RecipientInfo`
3171
3157
  """
3158
+
3172
3159
  body = {}
3173
3160
  if existing_token_expire_in_seconds is not None:
3174
3161
  body["existing_token_expire_in_seconds"] = existing_token_expire_in_seconds
@@ -3183,8 +3170,8 @@ class RecipientsAPI:
3183
3170
  def share_permissions(
3184
3171
  self, name: str, *, max_results: Optional[int] = None, page_token: Optional[str] = None
3185
3172
  ) -> GetRecipientSharePermissionsResponse:
3186
- """Gets the share permissions for the specified Recipient. The caller must be a metastore admin or the
3187
- owner of the Recipient.
3173
+ """Gets the share permissions for the specified Recipient. The caller must have the USE_RECIPIENT
3174
+ privilege on the metastore or be the owner of the Recipient.
3188
3175
 
3189
3176
  :param name: str
3190
3177
  The name of the Recipient.
@@ -3250,6 +3237,7 @@ class RecipientsAPI:
3250
3237
 
3251
3238
  :returns: :class:`RecipientInfo`
3252
3239
  """
3240
+
3253
3241
  body = {}
3254
3242
  if comment is not None:
3255
3243
  body["comment"] = comment
@@ -3294,6 +3282,7 @@ class SharesAPI:
3294
3282
 
3295
3283
  :returns: :class:`ShareInfo`
3296
3284
  """
3285
+
3297
3286
  body = {}
3298
3287
  if comment is not None:
3299
3288
  body["comment"] = comment
@@ -3323,8 +3312,8 @@ class SharesAPI:
3323
3312
  self._api.do("DELETE", f"/api/2.1/unity-catalog/shares/{name}", headers=headers)
3324
3313
 
3325
3314
  def get(self, name: str, *, include_shared_data: Optional[bool] = None) -> ShareInfo:
3326
- """Gets a data object share from the metastore. The caller must be a metastore admin or the owner of the
3327
- share.
3315
+ """Gets a data object share from the metastore. The caller must have the USE_SHARE privilege on the
3316
+ metastore or be the owner of the share.
3328
3317
 
3329
3318
  :param name: str
3330
3319
  The name of the share.
@@ -3347,8 +3336,9 @@ class SharesAPI:
3347
3336
  def list_shares(
3348
3337
  self, *, max_results: Optional[int] = None, page_token: Optional[str] = None
3349
3338
  ) -> Iterator[ShareInfo]:
3350
- """Gets an array of data object shares from the metastore. The caller must be a metastore admin or the
3351
- owner of the share. There is no guarantee of a specific ordering of the elements in the array.
3339
+ """Gets an array of data object shares from the metastore. If the caller has the USE_SHARE privilege on
3340
+ the metastore, all shares are returned. Otherwise, only shares owned by the caller are returned. There
3341
+ is no guarantee of a specific ordering of the elements in the array.
3352
3342
 
3353
3343
  :param max_results: int (optional)
3354
3344
  Maximum number of shares to return. - when set to 0, the page length is set to a server configured
@@ -3387,11 +3377,11 @@ class SharesAPI:
3387
3377
  def share_permissions(
3388
3378
  self, name: str, *, max_results: Optional[int] = None, page_token: Optional[str] = None
3389
3379
  ) -> GetSharePermissionsResponse:
3390
- """Gets the permissions for a data share from the metastore. The caller must be a metastore admin or the
3391
- owner of the share.
3380
+ """Gets the permissions for a data share from the metastore. The caller must have the USE_SHARE privilege
3381
+ on the metastore or be the owner of the share.
3392
3382
 
3393
3383
  :param name: str
3394
- The name of the share.
3384
+ The name of the Recipient.
3395
3385
  :param max_results: int (optional)
3396
3386
  Maximum number of permissions to return. - when set to 0, the page length is set to a server
3397
3387
  configured value (recommended); - when set to a value greater than 0, the page length is the minimum
@@ -3459,6 +3449,7 @@ class SharesAPI:
3459
3449
 
3460
3450
  :returns: :class:`ShareInfo`
3461
3451
  """
3452
+
3462
3453
  body = {}
3463
3454
  if comment is not None:
3464
3455
  body["comment"] = comment
@@ -3485,11 +3476,11 @@ class SharesAPI:
3485
3476
  changes: Optional[List[PermissionsChange]] = None,
3486
3477
  omit_permissions_list: Optional[bool] = None,
3487
3478
  ) -> UpdateSharePermissionsResponse:
3488
- """Updates the permissions for a data share in the metastore. The caller must be a metastore admin or an
3489
- owner of the share.
3479
+ """Updates the permissions for a data share in the metastore. The caller must have both the USE_SHARE and
3480
+ SET_SHARE_PERMISSION privileges on the metastore, or be the owner of the share.
3490
3481
 
3491
- For new recipient grants, the user must also be the recipient owner or metastore admin. recipient
3492
- revocations do not require additional privileges.
3482
+ For new recipient grants, the user must also be the owner of the recipients. recipient revocations do
3483
+ not require additional privileges.
3493
3484
 
3494
3485
  :param name: str
3495
3486
  The name of the share.
@@ -3500,6 +3491,7 @@ class SharesAPI:
3500
3491
 
3501
3492
  :returns: :class:`UpdateSharePermissionsResponse`
3502
3493
  """
3494
+
3503
3495
  body = {}
3504
3496
  if changes is not None:
3505
3497
  body["changes"] = [v.as_dict() for v in changes]