From bddb0e7fbd7d1faa63d5a461fc99a8f3be7845cb Mon Sep 17 00:00:00 2001 From: "databricks-ci-ghec-1[bot]" <184311507+databricks-ci-ghec-1[bot]@users.noreply.github.com> Date: Thu, 12 Nov 2026 03:18:38 +0000 Subject: [PATCH] Release databricks-sdk-java --- .codegen/_last_sha | 2 +- CHANGELOG.md | 10 ++ databricks-sdk-java/lockfile.json | 2 +- databricks-sdk-java/pom.xml | 2 +- .../com/databricks/sdk/WorkspaceClient.java | 20 ++++ .../com/databricks/sdk/core/UserAgent.java | 2 +- .../service/aifunctions/AiFunctionsAPI.java | 12 +-- .../aifunctions/AiFunctionsService.java | 12 +-- .../sdk/service/aifunctions/Batch.java | 42 ++++++--- .../aifunctions/BatchRequestCounts.java | 6 +- .../sdk/service/aifunctions/BatchStatus.java | 1 - .../aifunctions/CancelBatchRequest.java | 2 +- .../service/aifunctions/GetBatchRequest.java | 2 +- .../aifunctions/ListBatchesRequest.java | 2 +- .../aifunctions/ListBatchesResponse.java | 2 +- .../com/databricks/sdk/service/apps/App.java | 19 ++++ .../sdk/service/iam/AssumeGroupAPI.java | 77 ++++++++++++++++ .../sdk/service/iam/AssumeGroupImpl.java | 91 +++++++++++++++++++ .../sdk/service/iam/AssumeGroupService.java | 36 ++++++++ .../CreateRestrictedSharingGroupRequest.java | 70 ++++++++++++++ .../DeleteRestrictedSharingGroupRequest.java | 44 +++++++++ .../iam/GetRestrictedSharingGroupRequest.java | 44 +++++++++ .../ListRestrictedSharingGroupsRequest.java | 68 ++++++++++++++ .../ListRestrictedSharingGroupsResponse.java | 65 +++++++++++++ .../service/iam/RestrictedSharingGroup.java | 86 ++++++++++++++++++ .../sdk/service/lakewatch/Rule.java | 10 +- .../sdk/service/lakewatch/RuleInputBatch.java | 4 +- .../service/lakewatch/RuleInputBatchSql.java | 2 +- .../lakewatch/RuleInputCustomNotebook.java | 2 +- .../sdk/service/lakewatch/RuleSchedule.java | 26 +----- .../sdk/service/lakewatch/RuleTimeRange.java | 6 +- .../sdk/service/ml/DeltaTableSource.java | 11 +-- .../postgres/CreateDatabaseRequest.java | 4 +- .../service/postgres/CreateRoleRequest.java | 4 +- .../postgres/DatabaseDatabaseSpec.java | 2 +- .../postgres/DeleteEndpointRequest.java | 3 + .../sdk/service/postgres/RoleRoleSpec.java | 32 +++---- .../serving/AutoCaptureConfigOutput.java | 2 +- .../sdk/service/serving/AutoCaptureState.java | 2 +- .../serving/CreateServingEndpoint.java | 2 +- .../serving/DeleteServingEndpointRequest.java | 2 +- .../serving/EndpointPendingConfig.java | 5 +- .../sdk/service/serving/EndpointTags.java | 2 +- .../sdk/service/serving/FoundationModel.java | 8 +- .../sdk/service/serving/PayloadTable.java | 6 +- .../service/serving/PtEndpointCoreConfig.java | 2 +- .../sdk/service/serving/PtServedModel.java | 2 +- .../databricks/sdk/service/serving/Route.java | 2 +- .../service/serving/ServedEntityInput.java | 5 +- .../service/serving/ServedEntityOutput.java | 16 +++- .../sdk/service/serving/ServedEntitySpec.java | 24 ++++- .../sdk/service/serving/ServedModelInput.java | 8 +- .../service/serving/ServedModelOutput.java | 14 ++- .../sdk/service/serving/ServedModelSpec.java | 10 +- .../sdk/service/serving/ServedModelState.java | 15 ++- .../sdk/service/serving/ServingEndpoint.java | 7 +- .../serving/ServingEndpointDetailed.java | 9 +- ...nferenceEndpointNotificationsResponse.java | 4 +- ...sionedThroughputEndpointConfigRequest.java | 2 +- .../databricks/sdk/service/sql/AlertV2.java | 31 +++++-- .../sdk/service/sql/AlertV2Evaluation.java | 19 +++- .../sdk/service/sql/AlertV2Notification.java | 2 +- .../sdk/service/sql/AlertV2Operand.java | 4 +- .../sdk/service/sql/AlertV2OperandColumn.java | 10 +- .../sdk/service/sql/AlertV2OperandValue.java | 6 +- .../sdk/service/sql/AlertV2Subscription.java | 6 +- .../sdk/service/sql/AlertsV2API.java | 10 +- .../sdk/service/sql/AlertsV2Service.java | 10 +- .../sdk/service/sql/CronSchedule.java | 4 +- .../sdk/service/sql/GetAlertV2Request.java | 2 +- .../sdk/service/sql/ListAlertsV2Request.java | 7 +- .../sdk/service/sql/TrashAlertV2Request.java | 2 +- .../sdk/service/sql/UpdateAlertV2Request.java | 12 +-- examples/docs/pom.xml | 2 +- examples/spring-boot-oauth-u2m-demo/pom.xml | 2 +- lockfile.json | 2 +- pom.xml | 2 +- shaded/pom.xml | 2 +- 78 files changed, 911 insertions(+), 198 deletions(-) create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupAPI.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupImpl.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupService.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/CreateRestrictedSharingGroupRequest.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/DeleteRestrictedSharingGroupRequest.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/GetRestrictedSharingGroupRequest.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsRequest.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsResponse.java create mode 100644 databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/RestrictedSharingGroup.java diff --git a/.codegen/_last_sha b/.codegen/_last_sha index fa2e0c4ce..d5de729c9 100644 --- a/.codegen/_last_sha +++ b/.codegen/_last_sha @@ -1 +1 @@ -d0f10d671a637cab2b494fe81cd50955cc608866 \ No newline at end of file +e13a7b6206adbdb6c4008e2a58b7cc785e32cb1c \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index e5c554fb7..b684dd4e6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,15 @@ # Version changelog +## Release v0.180.0 (2026-11-12) + +### API Changes +* Add `workspaceClient.assumeGroup()` service. +* Add `effectiveResources` field for `com.databricks.sdk.service.apps.App`. +* Change `outputRef` field for `com.databricks.sdk.service.aifunctions.Batch` to be required. +* [Breaking] Change `outputRef` field for `com.databricks.sdk.service.aifunctions.Batch` to be required. +* [Breaking] Remove `continuous` field for `com.databricks.sdk.service.lakewatch.RuleSchedule`. +* [Breaking] Remove `EXPIRED` enum value for `com.databricks.sdk.service.aifunctions.BatchStatus`. + ## Release v0.179.0 (2026-11-11) ### API Changes diff --git a/databricks-sdk-java/lockfile.json b/databricks-sdk-java/lockfile.json index 0ce218cfa..71f6c9359 100644 --- a/databricks-sdk-java/lockfile.json +++ b/databricks-sdk-java/lockfile.json @@ -1,7 +1,7 @@ { "artifactId": "databricks-sdk-java", "groupId": "com.databricks", - "version": "0.179.0", + "version": "0.180.0", "lockFileVersion": 1, "dependencies": [ { diff --git a/databricks-sdk-java/pom.xml b/databricks-sdk-java/pom.xml index 3514f1b48..f9ad9bf38 100644 --- a/databricks-sdk-java/pom.xml +++ b/databricks-sdk-java/pom.xml @@ -5,7 +5,7 @@ com.databricks databricks-sdk-parent - 0.179.0 + 0.180.0 databricks-sdk-java Databricks SDK for Java diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/WorkspaceClient.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/WorkspaceClient.java index 7ec94ac06..b4eadcc85 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/WorkspaceClient.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/WorkspaceClient.java @@ -138,6 +138,8 @@ import com.databricks.sdk.service.iam.AccessControlService; import com.databricks.sdk.service.iam.AccountAccessControlProxyAPI; import com.databricks.sdk.service.iam.AccountAccessControlProxyService; +import com.databricks.sdk.service.iam.AssumeGroupAPI; +import com.databricks.sdk.service.iam.AssumeGroupService; import com.databricks.sdk.service.iam.CurrentUserAPI; import com.databricks.sdk.service.iam.CurrentUserService; import com.databricks.sdk.service.iam.GroupsAPI; @@ -312,6 +314,7 @@ public class WorkspaceClient { private AppsAPI appsAPI; private AppsSettingsAPI appsSettingsAPI; private ArtifactAllowlistsAPI artifactAllowlistsAPI; + private AssumeGroupAPI assumeGroupAPI; private BundleDeploymentsAPI bundleDeploymentsAPI; private CatalogsAPI catalogsAPI; private CleanRoomAssetRevisionsAPI cleanRoomAssetRevisionsAPI; @@ -463,6 +466,7 @@ public WorkspaceClient(DatabricksConfig config) { appsAPI = new AppsAPI(apiClient); appsSettingsAPI = new AppsSettingsAPI(apiClient); artifactAllowlistsAPI = new ArtifactAllowlistsAPI(apiClient); + assumeGroupAPI = new AssumeGroupAPI(apiClient); bundleDeploymentsAPI = new BundleDeploymentsAPI(apiClient); catalogsAPI = new CatalogsAPI(apiClient); cleanRoomAssetRevisionsAPI = new CleanRoomAssetRevisionsAPI(apiClient); @@ -710,6 +714,11 @@ public ArtifactAllowlistsAPI artifactAllowlists() { return artifactAllowlistsAPI; } + /** Manage the workspace's restricted sharing groups. */ + public AssumeGroupAPI assumeGroup() { + return assumeGroupAPI; + } + /** Service for managing bundle deployment metadata. */ public BundleDeploymentsAPI bundleDeployments() { return bundleDeploymentsAPI; @@ -2496,6 +2505,17 @@ public WorkspaceClient withArtifactAllowlistsAPI(ArtifactAllowlistsAPI artifactA return this; } + /** Replace the default AssumeGroupService with a custom implementation. */ + public WorkspaceClient withAssumeGroupImpl(AssumeGroupService assumeGroup) { + return this.withAssumeGroupAPI(new AssumeGroupAPI(assumeGroup)); + } + + /** Replace the default AssumeGroupAPI with a custom implementation. */ + public WorkspaceClient withAssumeGroupAPI(AssumeGroupAPI assumeGroup) { + this.assumeGroupAPI = assumeGroup; + return this; + } + /** Replace the default BundleDeploymentsService with a custom implementation. */ public WorkspaceClient withBundleDeploymentsImpl(BundleDeploymentsService bundleDeployments) { return this.withBundleDeploymentsAPI(new BundleDeploymentsAPI(bundleDeployments)); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java index 62dcc0b14..ab0a4957d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java @@ -36,7 +36,7 @@ public String getValue() { // TODO: check if reading from // /META-INF/maven/com.databricks/databrics-sdk-java/pom.properties // or getClass().getPackage().getImplementationVersion() is enough. - private static final String version = "0.179.0"; + private static final String version = "0.180.0"; public static void withProduct(String product, String productVersion) { UserAgent.product = product; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsAPI.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsAPI.java index bef2d4032..f5bd0673b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsAPI.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsAPI.java @@ -56,16 +56,16 @@ public AiParseDocumentResponse aiParseDocument(AiParseDocumentRequest request) { } /** - * Cancel a batch. Cancellation is asynchronous: requests in flight drain first, so read the batch - * to observe the `CANCELLING` and `CANCELLED` statuses. + * Starts the asynchronous cancellation of a batch. Requests in progress are drained first. + * Cancellation is best effort, so the batch can still complete. */ public CancelBatchResponse cancelBatch(CancelBatchRequest request) { return impl.cancelBatch(request); } /** - * Run an AI function over every request in a file on a Unity Catalog volume. The batch runs - * asynchronously; read it to follow its progress. + * Creates a batch that runs an AI function on every request in a JSONL file on a Unity Catalog + * volume. The batch runs asynchronously. To follow its progress, get the batch. */ public Batch createBatch(CreateBatchRequest request) { return impl.createBatch(request); @@ -75,12 +75,12 @@ public Batch getBatch(String name) { return getBatch(new GetBatchRequest().setName(name)); } - /** Read one batch, with its status and progress. */ + /** Gets the latest status and progress of a batch. */ public Batch getBatch(GetBatchRequest request) { return impl.getBatch(request); } - /** List the batches the caller created in this workspace. */ + /** Lists the batches that the caller created in this workspace. */ public Iterable listBatches(ListBatchesRequest request) { return Paginator.newTokenPagination( request, diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsService.java index e3b17a61f..3081a509b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsService.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/AiFunctionsService.java @@ -36,20 +36,20 @@ public interface AiFunctionsService { AiParseDocumentResponse aiParseDocument(AiParseDocumentRequest aiParseDocumentRequest); /** - * Cancel a batch. Cancellation is asynchronous: requests in flight drain first, so read the batch - * to observe the `CANCELLING` and `CANCELLED` statuses. + * Starts the asynchronous cancellation of a batch. Requests in progress are drained first. + * Cancellation is best effort, so the batch can still complete. */ CancelBatchResponse cancelBatch(CancelBatchRequest cancelBatchRequest); /** - * Run an AI function over every request in a file on a Unity Catalog volume. The batch runs - * asynchronously; read it to follow its progress. + * Creates a batch that runs an AI function on every request in a JSONL file on a Unity Catalog + * volume. The batch runs asynchronously. To follow its progress, get the batch. */ Batch createBatch(CreateBatchRequest createBatchRequest); - /** Read one batch, with its status and progress. */ + /** Gets the latest status and progress of a batch. */ Batch getBatch(GetBatchRequest getBatchRequest); - /** List the batches the caller created in this workspace. */ + /** Lists the batches that the caller created in this workspace. */ ListBatchesResponse listBatches(ListBatchesRequest listBatchesRequest); } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/Batch.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/Batch.java index e965a788e..98033501d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/Batch.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/Batch.java @@ -10,49 +10,65 @@ import java.util.Map; import java.util.Objects; -/** An asynchronous run of one AI function over a file of requests. */ +/** + * The AI Functions Asynchronous API lets you process large volumes of requests as a batch in a + * single call. + */ @Generated public class Batch { - /** Output only. Time the batch was created. */ + /** Output only. The time when the batch was created. */ @JsonProperty("create_time") private Timestamp createTime; - /** The AI function to run for every request, for example `ai_extract`. */ + /** The AI function, for example `ai_parse_document`. */ @JsonProperty("endpoint") private String endpoint; - /** Path of the JSONL input file on a Unity Catalog volume. Each line is one request. */ + /** + * Unity Catalog volume path of the JSONL input file. Each line is one request, in the form + * `{"custom_id": ..., "body": ...}`. The file can hold up to 50,000 requests and be up to 200 + * MiB. + */ @JsonProperty("input_ref") private String inputRef; - /** ID of the batch, in the form `batch_`. The service assigns it. */ + /** + * Output only. Identifier. Resource name of the batch, returned by create. Format: `batch_`. + */ @JsonProperty("name") private String name; /** - * Path on a Unity Catalog volume to write the JSONL output to. When it is omitted, the output - * stays on Databricks-managed storage and a finished batch returns a short-lived download URL in - * this field instead. + * Unity Catalog volume path to write the JSONL output file to. If the path is a directory, the + * file is `/_output.jsonl`. */ @JsonProperty("output_ref") private String outputRef; - /** Function options applied to every request in the batch, for example the extraction schema. */ + /** + * Parameters of the function other than its input, applied to every request in the batch, for + * example `schema` for `ai_extract`. Put function options, such as `version`, in a nested + * `options` object. For the parameters of each function, see [AI + * Functions](/large-language-models/ai-functions). + */ @JsonProperty("params") private Map params; /** - * Output only. Percentage of the requests that finished, from 0 to 100. Returned when one batch - * is read, not when batches are listed. + * Output only. The percentage of requests that are processed, from 0 to 100. Returned when you + * get a batch, not when you list batches. */ @JsonProperty("percent_complete") private Double percentComplete; - /** Output only. Request counts. Returned when one batch is read, not when batches are listed. */ + /** + * Output only. The number of requests in the batch, by result. Returned when you get a batch, not + * when you list batches. + */ @JsonProperty("request_counts") private BatchRequestCounts requestCounts; - /** Output only. Status of the batch. */ + /** Output only. The status of the batch. */ @JsonProperty("status") private BatchStatus status; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchRequestCounts.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchRequestCounts.java index 2ce0c5cff..cda3b8806 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchRequestCounts.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchRequestCounts.java @@ -10,15 +10,15 @@ /** Counts of the requests in a batch. */ @Generated public class BatchRequestCounts { - /** Output only. Number of requests that failed and will not be retried. */ + /** Output only. The number of requests that failed. The service does not retry them. */ @JsonProperty("failed") private Long failed; - /** Output only. Number of requests that finished successfully. */ + /** Output only. The number of requests that were processed successfully. */ @JsonProperty("succeeded") private Long succeeded; - /** Output only. Number of requests in the input file. */ + /** Output only. The number of requests in the batch. */ @JsonProperty("total") private Long total; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchStatus.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchStatus.java index cf197b8cc..84bbd2d25 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchStatus.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/BatchStatus.java @@ -10,7 +10,6 @@ public enum BatchStatus { CANCELLED, CANCELLING, COMPLETED, - EXPIRED, FAILED, FINALIZING, IN_PROGRESS, diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/CancelBatchRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/CancelBatchRequest.java index 5ebf1201d..df9cc0ded 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/CancelBatchRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/CancelBatchRequest.java @@ -9,7 +9,7 @@ @Generated public class CancelBatchRequest { - /** ID of the batch, in the form `batch_`. */ + /** Resource name of the batch. Format: `batch_`. */ @JsonIgnore private String name; public CancelBatchRequest setName(String name) { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/GetBatchRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/GetBatchRequest.java index 14e8dc4b1..bac8afbf5 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/GetBatchRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/GetBatchRequest.java @@ -9,7 +9,7 @@ @Generated public class GetBatchRequest { - /** ID of the batch, in the form `batch_`. */ + /** Resource name of the batch. Format: `batch_`. */ @JsonIgnore private String name; public GetBatchRequest setName(String name) { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesRequest.java index f728d96f7..56ee8643a 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesRequest.java @@ -15,7 +15,7 @@ public class ListBatchesRequest { @QueryParam("page_size") private Long pageSize; - /** Page token from an earlier response. Omit it to read the first page. */ + /** A page token from a previous call to list batches. Omit it to get the first page. */ @JsonIgnore @QueryParam("page_token") private String pageToken; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesResponse.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesResponse.java index f2cd0cfbd..23e70d423 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesResponse.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/aifunctions/ListBatchesResponse.java @@ -14,7 +14,7 @@ public class ListBatchesResponse { @JsonProperty("batches") private Collection batches; - /** Token that reads the next page. It is empty on the last page. */ + /** A token to get the next page. It is empty on the last page. */ @JsonProperty("next_page_token") private String nextPageToken; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/apps/App.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/apps/App.java index a473ebe45..26a1b3497 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/apps/App.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/apps/App.java @@ -78,6 +78,13 @@ public class App { @JsonProperty("effective_budget_policy_id") private String effectiveBudgetPolicyId; + /** + * Resources added to the app, plus the resources it inherits from its space. Empty for apps that + * are not in a space. + */ + @JsonProperty("effective_resources") + private Collection effectiveResources; + /** */ @JsonProperty("effective_usage_policy_id") private String effectiveUsagePolicyId; @@ -302,6 +309,15 @@ public String getEffectiveBudgetPolicyId() { return effectiveBudgetPolicyId; } + public App setEffectiveResources(Collection effectiveResources) { + this.effectiveResources = effectiveResources; + return this; + } + + public Collection getEffectiveResources() { + return effectiveResources; + } + public App setEffectiveUsagePolicyId(String effectiveUsagePolicyId) { this.effectiveUsagePolicyId = effectiveUsagePolicyId; return this; @@ -528,6 +544,7 @@ public boolean equals(Object o) { && Objects.equals(defaultSourceCodePath, that.defaultSourceCodePath) && Objects.equals(description, that.description) && Objects.equals(effectiveBudgetPolicyId, that.effectiveBudgetPolicyId) + && Objects.equals(effectiveResources, that.effectiveResources) && Objects.equals(effectiveUsagePolicyId, that.effectiveUsagePolicyId) && Objects.equals(effectiveUserApiScopes, that.effectiveUserApiScopes) && Objects.equals(forwardUserAccessToken, that.forwardUserAccessToken) @@ -569,6 +586,7 @@ public int hashCode() { defaultSourceCodePath, description, effectiveBudgetPolicyId, + effectiveResources, effectiveUsagePolicyId, effectiveUserApiScopes, forwardUserAccessToken, @@ -610,6 +628,7 @@ public String toString() { .add("defaultSourceCodePath", defaultSourceCodePath) .add("description", description) .add("effectiveBudgetPolicyId", effectiveBudgetPolicyId) + .add("effectiveResources", effectiveResources) .add("effectiveUsagePolicyId", effectiveUsagePolicyId) .add("effectiveUserApiScopes", effectiveUserApiScopes) .add("forwardUserAccessToken", forwardUserAccessToken) diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupAPI.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupAPI.java new file mode 100644 index 000000000..01e3da3c9 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupAPI.java @@ -0,0 +1,77 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.core.ApiClient; +import com.databricks.sdk.core.logging.Logger; +import com.databricks.sdk.core.logging.LoggerFactory; +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.Paginator; + +/** Manage the workspace's restricted sharing groups. */ +@Generated +public class AssumeGroupAPI { + private static final Logger LOG = LoggerFactory.getLogger(AssumeGroupAPI.class); + + private final AssumeGroupService impl; + + /** Regular-use constructor */ + public AssumeGroupAPI(ApiClient apiClient) { + impl = new AssumeGroupImpl(apiClient); + } + + /** Constructor for mocks */ + public AssumeGroupAPI(AssumeGroupService mock) { + impl = mock; + } + + /** + * Adds a group to the workspace's restricted list. The workspace allows at most 100 restricted + * sharing groups. Requires workspace admin. + */ + public RestrictedSharingGroup createRestrictedSharingGroup( + CreateRestrictedSharingGroupRequest request) { + return impl.createRestrictedSharingGroup(request); + } + + public void deleteRestrictedSharingGroup(String name) { + deleteRestrictedSharingGroup(new DeleteRestrictedSharingGroupRequest().setName(name)); + } + + /** Removes a group from the workspace's restricted list. Requires workspace admin. */ + public void deleteRestrictedSharingGroup(DeleteRestrictedSharingGroupRequest request) { + impl.deleteRestrictedSharingGroup(request); + } + + public RestrictedSharingGroup getRestrictedSharingGroup(String name) { + return getRestrictedSharingGroup(new GetRestrictedSharingGroupRequest().setName(name)); + } + + /** + * Gets a restricted sharing group in the workspace. Use it to check whether a group is on the + * workspace's restricted list. Requires workspace admin. + */ + public RestrictedSharingGroup getRestrictedSharingGroup( + GetRestrictedSharingGroupRequest request) { + return impl.getRestrictedSharingGroup(request); + } + + /** Lists the restricted sharing groups in the workspace. Requires workspace admin. */ + public Iterable listRestrictedSharingGroups( + ListRestrictedSharingGroupsRequest request) { + return Paginator.newTokenPagination( + request, + impl::listRestrictedSharingGroups, + ListRestrictedSharingGroupsResponse::getRestrictedSharingGroups, + response -> { + String token = response.getNextPageToken(); + if (token == null || token.isEmpty()) { + return null; + } + return request.setPageToken(token); + }); + } + + public AssumeGroupService impl() { + return impl; + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupImpl.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupImpl.java new file mode 100644 index 000000000..778f219eb --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupImpl.java @@ -0,0 +1,91 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.core.ApiClient; +import com.databricks.sdk.core.DatabricksException; +import com.databricks.sdk.core.http.Request; +import com.databricks.sdk.support.Generated; +import java.io.IOException; + +/** Package-local implementation of AssumeGroup */ +@Generated +class AssumeGroupImpl implements AssumeGroupService { + private final ApiClient apiClient; + + public AssumeGroupImpl(ApiClient apiClient) { + this.apiClient = apiClient; + } + + @Override + public RestrictedSharingGroup createRestrictedSharingGroup( + CreateRestrictedSharingGroupRequest request) { + String path = "/api/2.0/access-control/restricted-sharing-groups"; + try { + Request req = + new Request("POST", path, apiClient.serialize(request.getRestrictedSharingGroup())); + + ApiClient.setQuery(req, request); + req.withHeader("Accept", "application/json"); + req.withHeader("Content-Type", "application/json"); + if (apiClient.workspaceId() != null) { + req.withHeader("X-Databricks-Workspace-Id", apiClient.workspaceId()); + } + return apiClient.execute(req, RestrictedSharingGroup.class); + } catch (IOException e) { + throw new DatabricksException("IO error: " + e.getMessage(), e); + } + } + + @Override + public void deleteRestrictedSharingGroup(DeleteRestrictedSharingGroupRequest request) { + String path = String.format("/api/2.0/access-control/%s", request.getName()); + try { + Request req = new Request("DELETE", path); + + ApiClient.setQuery(req, request); + req.withHeader("Accept", "application/json"); + if (apiClient.workspaceId() != null) { + req.withHeader("X-Databricks-Workspace-Id", apiClient.workspaceId()); + } + apiClient.execute(req, Void.class); + } catch (IOException e) { + throw new DatabricksException("IO error: " + e.getMessage(), e); + } + } + + @Override + public RestrictedSharingGroup getRestrictedSharingGroup( + GetRestrictedSharingGroupRequest request) { + String path = String.format("/api/2.0/access-control/%s", request.getName()); + try { + Request req = new Request("GET", path); + + ApiClient.setQuery(req, request); + req.withHeader("Accept", "application/json"); + if (apiClient.workspaceId() != null) { + req.withHeader("X-Databricks-Workspace-Id", apiClient.workspaceId()); + } + return apiClient.execute(req, RestrictedSharingGroup.class); + } catch (IOException e) { + throw new DatabricksException("IO error: " + e.getMessage(), e); + } + } + + @Override + public ListRestrictedSharingGroupsResponse listRestrictedSharingGroups( + ListRestrictedSharingGroupsRequest request) { + String path = "/api/2.0/access-control/restricted-sharing-groups"; + try { + Request req = new Request("GET", path); + + ApiClient.setQuery(req, request); + req.withHeader("Accept", "application/json"); + if (apiClient.workspaceId() != null) { + req.withHeader("X-Databricks-Workspace-Id", apiClient.workspaceId()); + } + return apiClient.execute(req, ListRestrictedSharingGroupsResponse.class); + } catch (IOException e) { + throw new DatabricksException("IO error: " + e.getMessage(), e); + } + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupService.java new file mode 100644 index 000000000..48bf5e184 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/AssumeGroupService.java @@ -0,0 +1,36 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.support.Generated; + +/** + * Manage the workspace's restricted sharing groups. + * + *

This is the high-level interface, that contains generated methods. + * + *

Evolving: this interface is under development. Method signatures may change. + */ +@Generated +public interface AssumeGroupService { + /** + * Adds a group to the workspace's restricted list. The workspace allows at most 100 restricted + * sharing groups. Requires workspace admin. + */ + RestrictedSharingGroup createRestrictedSharingGroup( + CreateRestrictedSharingGroupRequest createRestrictedSharingGroupRequest); + + /** Removes a group from the workspace's restricted list. Requires workspace admin. */ + void deleteRestrictedSharingGroup( + DeleteRestrictedSharingGroupRequest deleteRestrictedSharingGroupRequest); + + /** + * Gets a restricted sharing group in the workspace. Use it to check whether a group is on the + * workspace's restricted list. Requires workspace admin. + */ + RestrictedSharingGroup getRestrictedSharingGroup( + GetRestrictedSharingGroupRequest getRestrictedSharingGroupRequest); + + /** Lists the restricted sharing groups in the workspace. Requires workspace admin. */ + ListRestrictedSharingGroupsResponse listRestrictedSharingGroups( + ListRestrictedSharingGroupsRequest listRestrictedSharingGroupsRequest); +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/CreateRestrictedSharingGroupRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/CreateRestrictedSharingGroupRequest.java new file mode 100644 index 000000000..3b05831b6 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/CreateRestrictedSharingGroupRequest.java @@ -0,0 +1,70 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. + +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.QueryParam; +import com.databricks.sdk.support.ToStringer; +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Objects; + +@Generated +public class CreateRestrictedSharingGroupRequest { + /** + * The restricted sharing group to create. It has no client-set fields; the group is identified by + * restricted_sharing_group_id. + */ + @JsonProperty("restricted_sharing_group") + private RestrictedSharingGroup restrictedSharingGroup; + + /** + * The id of the workspace group to restrict: the numeric id of an existing and non-system + * workspace group. + */ + @JsonIgnore + @QueryParam("restricted_sharing_group_id") + private String restrictedSharingGroupId; + + public CreateRestrictedSharingGroupRequest setRestrictedSharingGroup( + RestrictedSharingGroup restrictedSharingGroup) { + this.restrictedSharingGroup = restrictedSharingGroup; + return this; + } + + public RestrictedSharingGroup getRestrictedSharingGroup() { + return restrictedSharingGroup; + } + + public CreateRestrictedSharingGroupRequest setRestrictedSharingGroupId( + String restrictedSharingGroupId) { + this.restrictedSharingGroupId = restrictedSharingGroupId; + return this; + } + + public String getRestrictedSharingGroupId() { + return restrictedSharingGroupId; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + CreateRestrictedSharingGroupRequest that = (CreateRestrictedSharingGroupRequest) o; + return Objects.equals(restrictedSharingGroup, that.restrictedSharingGroup) + && Objects.equals(restrictedSharingGroupId, that.restrictedSharingGroupId); + } + + @Override + public int hashCode() { + return Objects.hash(restrictedSharingGroup, restrictedSharingGroupId); + } + + @Override + public String toString() { + return new ToStringer(CreateRestrictedSharingGroupRequest.class) + .add("restrictedSharingGroup", restrictedSharingGroup) + .add("restrictedSharingGroupId", restrictedSharingGroupId) + .toString(); + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/DeleteRestrictedSharingGroupRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/DeleteRestrictedSharingGroupRequest.java new file mode 100644 index 000000000..52405639b --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/DeleteRestrictedSharingGroupRequest.java @@ -0,0 +1,44 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. + +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.ToStringer; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Objects; + +@Generated +public class DeleteRestrictedSharingGroupRequest { + /** + * The name of the restricted sharing group to delete. Format: + * `restricted-sharing-groups/{restricted_sharing_group_id}` + */ + @JsonIgnore private String name; + + public DeleteRestrictedSharingGroupRequest setName(String name) { + this.name = name; + return this; + } + + public String getName() { + return name; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + DeleteRestrictedSharingGroupRequest that = (DeleteRestrictedSharingGroupRequest) o; + return Objects.equals(name, that.name); + } + + @Override + public int hashCode() { + return Objects.hash(name); + } + + @Override + public String toString() { + return new ToStringer(DeleteRestrictedSharingGroupRequest.class).add("name", name).toString(); + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/GetRestrictedSharingGroupRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/GetRestrictedSharingGroupRequest.java new file mode 100644 index 000000000..e39a66f87 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/GetRestrictedSharingGroupRequest.java @@ -0,0 +1,44 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. + +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.ToStringer; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Objects; + +@Generated +public class GetRestrictedSharingGroupRequest { + /** + * The name of the restricted sharing group to get. Format: + * `restricted-sharing-groups/{restricted_sharing_group_id}` + */ + @JsonIgnore private String name; + + public GetRestrictedSharingGroupRequest setName(String name) { + this.name = name; + return this; + } + + public String getName() { + return name; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + GetRestrictedSharingGroupRequest that = (GetRestrictedSharingGroupRequest) o; + return Objects.equals(name, that.name); + } + + @Override + public int hashCode() { + return Objects.hash(name); + } + + @Override + public String toString() { + return new ToStringer(GetRestrictedSharingGroupRequest.class).add("name", name).toString(); + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsRequest.java new file mode 100644 index 000000000..ef602a8f1 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsRequest.java @@ -0,0 +1,68 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. + +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.QueryParam; +import com.databricks.sdk.support.ToStringer; +import com.fasterxml.jackson.annotation.JsonIgnore; +import java.util.Objects; + +@Generated +public class ListRestrictedSharingGroupsRequest { + /** + * The maximum number of groups to return. The service may return fewer. If unspecified or 0, at + * most 100 groups are returned. Values above 100 are coerced to 100. Negative values are + * rejected. + */ + @JsonIgnore + @QueryParam("page_size") + private Long pageSize; + + /** + * A page token from a previous ListRestrictedSharingGroups call. Provide this to retrieve the + * subsequent page. + */ + @JsonIgnore + @QueryParam("page_token") + private String pageToken; + + public ListRestrictedSharingGroupsRequest setPageSize(Long pageSize) { + this.pageSize = pageSize; + return this; + } + + public Long getPageSize() { + return pageSize; + } + + public ListRestrictedSharingGroupsRequest setPageToken(String pageToken) { + this.pageToken = pageToken; + return this; + } + + public String getPageToken() { + return pageToken; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + ListRestrictedSharingGroupsRequest that = (ListRestrictedSharingGroupsRequest) o; + return Objects.equals(pageSize, that.pageSize) && Objects.equals(pageToken, that.pageToken); + } + + @Override + public int hashCode() { + return Objects.hash(pageSize, pageToken); + } + + @Override + public String toString() { + return new ToStringer(ListRestrictedSharingGroupsRequest.class) + .add("pageSize", pageSize) + .add("pageToken", pageToken) + .toString(); + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsResponse.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsResponse.java new file mode 100644 index 000000000..594757bb3 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/ListRestrictedSharingGroupsResponse.java @@ -0,0 +1,65 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. + +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.ToStringer; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Collection; +import java.util.Objects; + +/** A page of restricted sharing groups in the caller's workspace. */ +@Generated +public class ListRestrictedSharingGroupsResponse { + /** + * A token that can be sent as page_token to retrieve the next page. If this field is omitted, + * there are no subsequent pages. + */ + @JsonProperty("next_page_token") + private String nextPageToken; + + /** The restricted sharing groups in the workspace. */ + @JsonProperty("restricted_sharing_groups") + private Collection restrictedSharingGroups; + + public ListRestrictedSharingGroupsResponse setNextPageToken(String nextPageToken) { + this.nextPageToken = nextPageToken; + return this; + } + + public String getNextPageToken() { + return nextPageToken; + } + + public ListRestrictedSharingGroupsResponse setRestrictedSharingGroups( + Collection restrictedSharingGroups) { + this.restrictedSharingGroups = restrictedSharingGroups; + return this; + } + + public Collection getRestrictedSharingGroups() { + return restrictedSharingGroups; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + ListRestrictedSharingGroupsResponse that = (ListRestrictedSharingGroupsResponse) o; + return Objects.equals(nextPageToken, that.nextPageToken) + && Objects.equals(restrictedSharingGroups, that.restrictedSharingGroups); + } + + @Override + public int hashCode() { + return Objects.hash(nextPageToken, restrictedSharingGroups); + } + + @Override + public String toString() { + return new ToStringer(ListRestrictedSharingGroupsResponse.class) + .add("nextPageToken", nextPageToken) + .add("restrictedSharingGroups", restrictedSharingGroups) + .toString(); + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/RestrictedSharingGroup.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/RestrictedSharingGroup.java new file mode 100644 index 000000000..19911ff60 --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iam/RestrictedSharingGroup.java @@ -0,0 +1,86 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. + +package com.databricks.sdk.service.iam; + +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.ToStringer; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Objects; + +/** + * A RestrictedSharingGroup is a workspace group whose members cannot grant or revoke permissions on + * workspace assets while they have assumed the group or one of its child groups. Users acting as + * themselves are not affected. + */ +@Generated +public class RestrictedSharingGroup { + /** The display name of the restricted workspace group. */ + @JsonProperty("group_display_name") + private String groupDisplayName; + + /** + * The resource name of the restricted sharing group. Format: + * `restricted-sharing-groups/{restricted_sharing_group_id}` Example: + * `restricted-sharing-groups/123` + */ + @JsonProperty("name") + private String name; + + /** + * The id of the restricted workspace group: the numeric id of an existing and non-system + * workspace group. + */ + @JsonProperty("restricted_sharing_group_id") + private String restrictedSharingGroupId; + + public RestrictedSharingGroup setGroupDisplayName(String groupDisplayName) { + this.groupDisplayName = groupDisplayName; + return this; + } + + public String getGroupDisplayName() { + return groupDisplayName; + } + + public RestrictedSharingGroup setName(String name) { + this.name = name; + return this; + } + + public String getName() { + return name; + } + + public RestrictedSharingGroup setRestrictedSharingGroupId(String restrictedSharingGroupId) { + this.restrictedSharingGroupId = restrictedSharingGroupId; + return this; + } + + public String getRestrictedSharingGroupId() { + return restrictedSharingGroupId; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + RestrictedSharingGroup that = (RestrictedSharingGroup) o; + return Objects.equals(groupDisplayName, that.groupDisplayName) + && Objects.equals(name, that.name) + && Objects.equals(restrictedSharingGroupId, that.restrictedSharingGroupId); + } + + @Override + public int hashCode() { + return Objects.hash(groupDisplayName, name, restrictedSharingGroupId); + } + + @Override + public String toString() { + return new ToStringer(RestrictedSharingGroup.class) + .add("groupDisplayName", groupDisplayName) + .add("name", name) + .add("restrictedSharingGroupId", restrictedSharingGroupId) + .toString(); + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/Rule.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/Rule.java index f12d96749..8711e357d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/Rule.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/Rule.java @@ -20,7 +20,7 @@ public class Rule { @JsonProperty("annotations") private Map annotations; - /** Batch SQL rule input. */ + /** Scheduled detection (also known as batch detection) input. */ @JsonProperty("batch") private RuleInputBatch batch; @@ -38,8 +38,8 @@ public class Rule { /** * ID of the workspace whose compute runs this rule's jobs and owns its associated resources, such - * as the SQL warehouse a scheduled rule runs on. Server-assigned; a rule's warehouse can only be - * changed from this workspace. + * as the SQL warehouse a scheduled detection runs on. Server-assigned; a rule's warehouse can + * only be changed from this workspace. */ @JsonProperty("compute_workspace_id") private String computeWorkspaceId; @@ -208,8 +208,8 @@ public class Rule { private Timestamp suppressUntilTime; /** - * Time-range configuration for batch rules. If unset, the execution time range is extended by a - * fixed `15m` lookback. + * Time-range configuration for scheduled detections. If unset, the execution time range is + * extended by a fixed `15m` lookback. */ @JsonProperty("timerange") private RuleTimeRange timerange; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatch.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatch.java index 7d6615f24..7cf88c06a 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatch.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatch.java @@ -7,7 +7,7 @@ import com.fasterxml.jackson.annotation.JsonProperty; import java.util.Objects; -/** Batch input for a detection rule. */ +/** Input for a scheduled detection (also known as batch detection). */ @Generated public class RuleInputBatch { /** Custom-notebook user function. The output is used as input data for the rule. */ @@ -18,7 +18,7 @@ public class RuleInputBatch { @JsonProperty("sql") private RuleInputBatchSql sql; - /** SQL warehouse used to run this batch rule. */ + /** SQL warehouse that runs this scheduled detection. */ @JsonProperty("warehouse_id") private String warehouseId; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatchSql.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatchSql.java index 84f0dc23b..862cd24ab 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatchSql.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputBatchSql.java @@ -7,7 +7,7 @@ import com.fasterxml.jackson.annotation.JsonProperty; import java.util.Objects; -/** Batch SQL input for a detection rule. */ +/** SQL query input for a scheduled detection. */ @Generated public class RuleInputBatchSql { /** diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputCustomNotebook.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputCustomNotebook.java index edaafdb2c..f095836ae 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputCustomNotebook.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleInputCustomNotebook.java @@ -8,7 +8,7 @@ import java.util.Map; import java.util.Objects; -/** Reference to a custom-user-function notebook for stream or batch input. */ +/** Reference to a custom-user-function notebook for scheduled detection input. */ @Generated public class RuleInputCustomNotebook { /** diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleSchedule.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleSchedule.java index 218908674..79006b451 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleSchedule.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleSchedule.java @@ -10,9 +10,9 @@ /** * Defines when a detection rule executes. * - *

A batch rule sets exactly one of `at_least_every` or `cron_expression`. A streaming rule runs - * continuously and sets no timing; it accepts only `enabled`, and an omitted schedule means - * enabled. The server rejects any other combination. `enabled` is orthogonal to the timing. + *

A scheduled detection sets exactly one of `at_least_every` or `cron_expression`. A streaming + * rule runs continuously and sets no timing; it accepts only `enabled`, and an omitted schedule + * means enabled. The server rejects any other combination. `enabled` is orthogonal to the timing. */ @Generated public class RuleSchedule { @@ -23,13 +23,6 @@ public class RuleSchedule { @JsonProperty("at_least_every") private String atLeastEvery; - /** - * Runs the rule continuously. Detection rules do not accept it: batch rules reject it, and - * streaming rules run continuously without it. - */ - @JsonProperty("continuous") - private Boolean continuous; - /** Defines the schedule using a Quartz cron expression. */ @JsonProperty("cron_expression") private String cronExpression; @@ -47,15 +40,6 @@ public String getAtLeastEvery() { return atLeastEvery; } - public RuleSchedule setContinuous(Boolean continuous) { - this.continuous = continuous; - return this; - } - - public Boolean getContinuous() { - return continuous; - } - public RuleSchedule setCronExpression(String cronExpression) { this.cronExpression = cronExpression; return this; @@ -80,21 +64,19 @@ public boolean equals(Object o) { if (o == null || getClass() != o.getClass()) return false; RuleSchedule that = (RuleSchedule) o; return Objects.equals(atLeastEvery, that.atLeastEvery) - && Objects.equals(continuous, that.continuous) && Objects.equals(cronExpression, that.cronExpression) && Objects.equals(enabled, that.enabled); } @Override public int hashCode() { - return Objects.hash(atLeastEvery, continuous, cronExpression, enabled); + return Objects.hash(atLeastEvery, cronExpression, enabled); } @Override public String toString() { return new ToStringer(RuleSchedule.class) .add("atLeastEvery", atLeastEvery) - .add("continuous", continuous) .add("cronExpression", cronExpression) .add("enabled", enabled) .toString(); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleTimeRange.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleTimeRange.java index 991395873..f2b390800 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleTimeRange.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/lakewatch/RuleTimeRange.java @@ -7,15 +7,15 @@ import com.fasterxml.jackson.annotation.JsonProperty; import java.util.Objects; -/** Time-range configuration for a batch detection rule. */ +/** Time-range configuration for a scheduled detection. */ @Generated public class RuleTimeRange { /** * Extends the start of the execution time range by a compact duration with integer days, hours, * minutes, and seconds in that order, such as `1h30m` or `15m`. Zero duration disables extension. * Unset or empty uses a fixed `15m` at execution time. Only the start moves; the end is - * unchanged. Has no effect on batch SQL that does not use `IN_TIMERANGE`. Values must fit signed - * 64-bit microseconds. + * unchanged. Has no effect on a detection query that does not use `IN_TIMERANGE`. Values must fit + * signed 64-bit microseconds. */ @JsonProperty("extend_lookback") private String extendLookback; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/DeltaTableSource.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/DeltaTableSource.java index b6278e0c8..fbf49578e 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/DeltaTableSource.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/DeltaTableSource.java @@ -23,8 +23,8 @@ public class DeltaTableSource { private Collection entityColumns; /** - * Single WHERE clause to filter delta table before applying transformations. Will be row-wise - * evaluated, so should only include conditionals and projections. + * A single WHERE clause to filter the Delta table before applying transformations. The predicate + * is evaluated for each row. */ @JsonProperty("filter_condition") private String filterCondition; @@ -38,10 +38,9 @@ public class DeltaTableSource { private String timeseriesColumn; /** - * A single SQL SELECT expression applied after filter_condition. Should contains all the columns - * needed (eg. "SELECT *, col_a + col_b AS col_c FROM x.y.z WHERE col_a > 0" would have - * `transformation_sql` "*, col_a + col_b AS col_c") If transformation_sql is not provided, all - * columns of the delta table are present in the DataSource dataframe. + * A single SQL SELECT expression applied after filter_condition. The expression must contain all + * required columns (e.g., "*, col_a + col_b AS col_c"). If transformation_sql is not provided, + * all columns of the delta table are present in the DataSource dataframe. */ @JsonProperty("transformation_sql") private String transformationSql; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateDatabaseRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateDatabaseRequest.java index 9161e83d0..929f6065c 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateDatabaseRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateDatabaseRequest.java @@ -16,8 +16,8 @@ public class CreateDatabaseRequest { private Database database; /** - * The ID to use for the Database, which will become the final component of the database's - * resource name. This ID becomes the database name in postgres. + * The ID used to identify and manage the Database resource through the API. The Postgres database + * name is specified in `spec.postgres_database`. * *

This value should be 4-63 characters, and only use characters available in DNS names, as * defined by RFC-1123 diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateRoleRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateRoleRequest.java index 41d80f4b9..18767f9ed 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateRoleRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/CreateRoleRequest.java @@ -37,8 +37,8 @@ public class CreateRoleRequest { private Role role; /** - * The ID to use for the Role, which will become the final component of the role's resource name. - * This ID becomes the role in Postgres. + * The ID used to identify and manage the Role resource through the API. The Postgres role name is + * specified in `spec.postgres_role`. * *

This value should be 4-63 characters, and valid characters are lowercase letters, numbers, * and hyphens, as defined by RFC 1123. diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DatabaseDatabaseSpec.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DatabaseDatabaseSpec.java index 3c0f98f1c..87b3c8948 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DatabaseDatabaseSpec.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DatabaseDatabaseSpec.java @@ -27,7 +27,7 @@ public class DatabaseDatabaseSpec { * *

To change the owner, pass valid existing Role name when updating the Database * - *

A database always has an owner. + *

Required when creating the Database. */ @JsonProperty("role") private String role; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DeleteEndpointRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DeleteEndpointRequest.java index 456951b90..73d3b898d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DeleteEndpointRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/DeleteEndpointRequest.java @@ -12,6 +12,9 @@ public class DeleteEndpointRequest { /** * The full resource path of the endpoint to delete. Format: * projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id} + * + *

Read-write endpoints currently cannot be deleted directly. Their deletion is managed by the + * parent branch. To avoid compute costs, set `disabled` to `true` on the endpoint. */ @JsonIgnore private String name; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/RoleRoleSpec.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/RoleRoleSpec.java index ad0d9a207..b16db3902 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/RoleRoleSpec.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/postgres/RoleRoleSpec.java @@ -22,9 +22,9 @@ public class RoleRoleSpec { * derived from the backing managed identity (the Databricks user, service principal, or group * named by the role's `postgres_role`). No static password exists for roles using this method. * * PG_PASSWORD_SCRAM_SHA_256: the role authenticates with a Postgres password verified server-side - * using the SCRAM-SHA-256 mechanism. Lakebase generates a password for the role. * NO_LOGIN: the - * role cannot open a Postgres session at all. Useful for roles that exist only to own objects or - * to aggregate privileges that are then granted to other, loginable roles. + * using the SCRAM-SHA-256 mechanism. Lakebase generates a password for the role. + * + *

NO_LOGIN is not currently supported for Role creation. * *

If auth_method is left unspecified, a meaningful authentication method is derived from the * identity_type: * For the managed identities, OAUTH is used. * For the regular postgres roles, @@ -33,30 +33,26 @@ public class RoleRoleSpec { *

NOTE: for the Databricks identity type GROUP, LAKEBASE_OAUTH_V1 is the default auth method * (group can login as well). * - *

This field is set when the role is created and cannot be changed. When replacing an existing - * role with replace_existing=true, omit this field or supply its current value. A differing value - * returns INVALID_PARAMETER_VALUE and rejects the entire request, including changes to mutable - * fields. With `*` or masks containing only mutable fields, supplied values are ignored. - * Including this field as an explicit path in update_mask returns INVALID_PARAMETER_VALUE. + *

This value cannot be changed after creation. */ @JsonProperty("auth_method") private RoleAuthMethod authMethod; /** - * The type of role. When specifying a managed-identity, the chosen role_id must be a valid: + * The type of role. When specifying a managed-identity, the chosen postgres_role must be a valid: * *

* application ID for SERVICE_PRINCIPAL * user email for USER * group name for GROUP * - *

This field is set when the role is created and cannot be changed. When replacing an existing - * role with replace_existing=true, omit this field or supply its current value. A differing value - * returns INVALID_PARAMETER_VALUE and rejects the entire request, including changes to mutable - * fields. With `*` or masks containing only mutable fields, supplied values are ignored. - * Including this field as an explicit path in update_mask returns INVALID_PARAMETER_VALUE. + *

This value cannot be changed after creation. */ @JsonProperty("identity_type") private RoleIdentityType identityType; - /** An enum value for a standard role that this role is a member of. */ + /** + * An enum value for a standard role that this role is a member of. When selected in update_mask, + * this field replaces all existing memberships. An empty or omitted list clears all memberships, + * including DATABRICKS_SUPERUSER. + */ @JsonProperty("membership_roles") private Collection membershipRoles; @@ -74,11 +70,7 @@ public class RoleRoleSpec { *

1. user email for IdentityType.USER 2. app ID for IdentityType.SERVICE_PRINCIPAL 2. group * name for IdentityType.GROUP * - *

This field is set when the role is created and cannot be changed. When replacing an existing - * role with replace_existing=true, omit this field or supply its current value. A differing value - * returns INVALID_PARAMETER_VALUE and rejects the entire request, including changes to mutable - * fields. With `*` or masks containing only mutable fields, supplied values are ignored. - * Including this field as an explicit path in update_mask returns INVALID_PARAMETER_VALUE. + *

This value cannot be changed after creation. */ @JsonProperty("postgres_role") private String postgresRole; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureConfigOutput.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureConfigOutput.java index 4d6d370c3..cad67c89c 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureConfigOutput.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureConfigOutput.java @@ -31,7 +31,7 @@ public class AutoCaptureConfigOutput { @JsonProperty("schema_name") private String schemaName; - /** */ + /** The state of the inference table. */ @JsonProperty("state") private AutoCaptureState state; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureState.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureState.java index d08c23e6d..b3b122b2b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureState.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AutoCaptureState.java @@ -9,7 +9,7 @@ @Generated public class AutoCaptureState { - /** */ + /** The payload table that stores the logged requests and responses. */ @JsonProperty("payload_table") private PayloadTable payloadTable; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/CreateServingEndpoint.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/CreateServingEndpoint.java index 669bfd45e..819b9f132 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/CreateServingEndpoint.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/CreateServingEndpoint.java @@ -26,7 +26,7 @@ public class CreateServingEndpoint { @JsonProperty("config") private EndpointCoreConfigInput config; - /** */ + /** The description of the serving endpoint. */ @JsonProperty("description") private String description; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/DeleteServingEndpointRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/DeleteServingEndpointRequest.java index 962a3c11b..4f9564e60 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/DeleteServingEndpointRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/DeleteServingEndpointRequest.java @@ -9,7 +9,7 @@ @Generated public class DeleteServingEndpointRequest { - /** */ + /** The name of the serving endpoint to delete. */ @JsonIgnore private String name; public DeleteServingEndpointRequest setName(String name) { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointPendingConfig.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointPendingConfig.java index 55924321e..bd15ef4d8 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointPendingConfig.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointPendingConfig.java @@ -33,7 +33,10 @@ public class EndpointPendingConfig { @JsonProperty("served_models") private Collection servedModels; - /** The timestamp when the update to the pending config started. */ + /** + * The timestamp when the update to the pending config started, in milliseconds since the Unix + * epoch. + */ @JsonProperty("start_time") private Long startTime; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointTags.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointTags.java index 1fb13a9b2..fb7eb7127 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointTags.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/EndpointTags.java @@ -10,7 +10,7 @@ @Generated public class EndpointTags { - /** */ + /** The tags attached to the serving endpoint after the update. */ @JsonProperty("tags") private Collection tags; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/FoundationModel.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/FoundationModel.java index c5a818bcd..f6f99e146 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/FoundationModel.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/FoundationModel.java @@ -13,19 +13,19 @@ */ @Generated public class FoundationModel { - /** */ + /** A description of the foundation model. */ @JsonProperty("description") private String description; - /** */ + /** The human-readable display name of the foundation model. */ @JsonProperty("display_name") private String displayName; - /** */ + /** The URL of the Databricks documentation page for the foundation model. */ @JsonProperty("docs") private String docs; - /** */ + /** The name of the foundation model. */ @JsonProperty("name") private String name; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PayloadTable.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PayloadTable.java index 500d98298..993711359 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PayloadTable.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PayloadTable.java @@ -9,15 +9,15 @@ @Generated public class PayloadTable { - /** */ + /** The name of the payload table within the configured catalog and schema. */ @JsonProperty("name") private String name; - /** */ + /** The status of the payload table. One of PENDING, READY, FAILED or DISABLED. */ @JsonProperty("status") private String status; - /** */ + /** More information about the status of the payload table, if available. */ @JsonProperty("status_message") private String statusMessage; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtEndpointCoreConfig.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtEndpointCoreConfig.java index d0a1c2c0c..c5512913f 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtEndpointCoreConfig.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtEndpointCoreConfig.java @@ -14,7 +14,7 @@ public class PtEndpointCoreConfig { @JsonProperty("served_entities") private Collection servedEntities; - /** */ + /** The traffic configuration associated with the serving endpoint config. */ @JsonProperty("traffic_config") private TrafficConfig trafficConfig; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtServedModel.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtServedModel.java index 193b88a66..809619c01 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtServedModel.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/PtServedModel.java @@ -26,7 +26,7 @@ public class PtServedModel { @JsonProperty("entity_name") private String entityName; - /** */ + /** The version of the model in Unity Catalog to be served. */ @JsonProperty("entity_version") private String entityVersion; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/Route.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/Route.java index 64fe2e69a..5bf588595 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/Route.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/Route.java @@ -9,7 +9,7 @@ @Generated public class Route { - /** */ + /** The name of the served entity this route configures traffic for. */ @JsonProperty("served_entity_name") private String servedEntityName; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityInput.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityInput.java index f73344a2a..1d312ff7c 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityInput.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityInput.java @@ -27,7 +27,10 @@ public class ServedEntityInput { @JsonProperty("entity_name") private String entityName; - /** */ + /** + * The version of the model in Databricks Model Registry or Unity Catalog to be served, or empty + * if the entity is a FEATURE_SPEC function. + */ @JsonProperty("entity_version") private String entityVersion; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityOutput.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityOutput.java index a5d27729c..9477cd4c7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityOutput.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntityOutput.java @@ -18,11 +18,11 @@ public class ServedEntityOutput { @JsonProperty("burst_scaling_enabled") private Boolean burstScalingEnabled; - /** */ + /** The timestamp when the served entity was created, in milliseconds since the Unix epoch. */ @JsonProperty("creation_timestamp") private Long creationTimestamp; - /** */ + /** The email of the user who created the served entity. */ @JsonProperty("creator") private String creator; @@ -35,7 +35,10 @@ public class ServedEntityOutput { @JsonProperty("entity_name") private String entityName; - /** */ + /** + * The version of the model in Databricks Model Registry or Unity Catalog to be served, or empty + * if the entity is a FEATURE_SPEC function. + */ @JsonProperty("entity_version") private String entityVersion; @@ -60,7 +63,10 @@ public class ServedEntityOutput { @JsonProperty("external_model") private ExternalModel externalModel; - /** */ + /** + * The foundation model that is served. Present for served entities that serve a Databricks-hosted + * foundation model. + */ @JsonProperty("foundation_model") private FoundationModel foundationModel; @@ -107,7 +113,7 @@ public class ServedEntityOutput { @JsonProperty("scale_to_zero_enabled") private Boolean scaleToZeroEnabled; - /** */ + /** Information corresponding to the state of the served entity. */ @JsonProperty("state") private ServedModelState state; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntitySpec.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntitySpec.java index ec9eb293f..7e362390a 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntitySpec.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedEntitySpec.java @@ -9,23 +9,37 @@ @Generated public class ServedEntitySpec { - /** */ + /** + * The name of the entity to be served. The entity may be a model in the Databricks Model + * Registry, a model in the Unity Catalog (UC), or a function of type FEATURE_SPEC in the UC. If + * it is a UC object, the full name of the object is given in the form of + * **catalog_name.schema_name.model_name**. + */ @JsonProperty("entity_name") private String entityName; - /** */ + /** + * The version of the model in Databricks Model Registry or Unity Catalog to be served, or empty + * if the entity is a FEATURE_SPEC function. + */ @JsonProperty("entity_version") private String entityVersion; - /** */ + /** + * The external model that is served. NOTE: Only one of external_model, foundation_model, and + * (entity_name, entity_version) is returned based on the endpoint type. + */ @JsonProperty("external_model") private ExternalModel externalModel; - /** */ + /** + * The foundation model that is served. NOTE: Only one of foundation_model, external_model, and + * (entity_name, entity_version) is returned based on the endpoint type. + */ @JsonProperty("foundation_model") private FoundationModel foundationModel; - /** */ + /** The name of the served entity. */ @JsonProperty("name") private String name; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelInput.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelInput.java index 4ba2bf39f..75e9d045a 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelInput.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelInput.java @@ -53,11 +53,15 @@ public class ServedModelInput { @JsonProperty("min_provisioned_throughput") private Long minProvisionedThroughput; - /** */ + /** + * The name of the model in Databricks Model Registry to be served or, if the model resides in + * Unity Catalog, the full name of the model in the form of + * **catalog_name.schema_name.model_name**. + */ @JsonProperty("model_name") private String modelName; - /** */ + /** The version of the model in Databricks Model Registry or Unity Catalog to be served. */ @JsonProperty("model_version") private String modelVersion; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelOutput.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelOutput.java index 550c83383..5a52461d7 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelOutput.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelOutput.java @@ -18,11 +18,11 @@ public class ServedModelOutput { @JsonProperty("burst_scaling_enabled") private Boolean burstScalingEnabled; - /** */ + /** The timestamp when the served entity was created, in milliseconds since the Unix epoch. */ @JsonProperty("creation_timestamp") private Long creationTimestamp; - /** */ + /** The email of the user who created the served entity. */ @JsonProperty("creator") private String creator; @@ -53,11 +53,15 @@ public class ServedModelOutput { @JsonProperty("min_provisioned_concurrency") private Long minProvisionedConcurrency; - /** */ + /** + * The name of the model in Databricks Model Registry to be served or, if the model resides in + * Unity Catalog, the full name of the model in the form of + * **catalog_name.schema_name.model_name**. + */ @JsonProperty("model_name") private String modelName; - /** */ + /** The version of the model in Databricks Model Registry or Unity Catalog to be served. */ @JsonProperty("model_version") private String modelVersion; @@ -78,7 +82,7 @@ public class ServedModelOutput { @JsonProperty("scale_to_zero_enabled") private Boolean scaleToZeroEnabled; - /** */ + /** Information corresponding to the state of the served entity. */ @JsonProperty("state") private ServedModelState state; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelSpec.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelSpec.java index 233618bd9..e7eb87ce8 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelSpec.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelSpec.java @@ -9,15 +9,19 @@ @Generated public class ServedModelSpec { - /** Only one of model_name and entity_name should be populated */ + /** + * The name of the model in Databricks Model Registry to be served or, if the model resides in + * Unity Catalog, the full name of the model in the form of + * **catalog_name.schema_name.model_name**. + */ @JsonProperty("model_name") private String modelName; - /** Only one of model_version and entity_version should be populated */ + /** The version of the model in Databricks Model Registry or Unity Catalog to be served. */ @JsonProperty("model_version") private String modelVersion; - /** */ + /** The name of the served entity. */ @JsonProperty("name") private String name; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelState.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelState.java index 4c71f5360..023d1cd37 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelState.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServedModelState.java @@ -9,11 +9,22 @@ @Generated public class ServedModelState { - /** */ + /** + * The state of the deployment of the served entity. DEPLOYMENT_CREATING indicates that the served + * entity is not ready yet because the deployment is still being created (for example, the + * container image is building or the model server is starting for the first time). + * DEPLOYMENT_RECOVERING indicates that the served entity was previously ready but no longer is + * and is attempting to recover. DEPLOYMENT_READY indicates that the served entity is ready to + * receive traffic. DEPLOYMENT_FAILED indicates that there was an error bringing up the served + * entity (for example, the container image build failed or the model server failed to start due + * to a model loading error). DEPLOYMENT_ABORTED indicates that the deployment was terminated, + * likely due to a failure in bringing up another served entity under the same endpoint and config + * version. + */ @JsonProperty("deployment") private ServedModelStateDeployment deployment; - /** */ + /** More information about the state of the served entity, if available. */ @JsonProperty("deployment_state_message") private String deploymentStateMessage; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpoint.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpoint.java index 37e12e87e..20319ba62 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpoint.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpoint.java @@ -26,7 +26,7 @@ public class ServingEndpoint { @JsonProperty("config") private EndpointCoreConfigSummary config; - /** The timestamp when the endpoint was created in Unix time. */ + /** The timestamp when the endpoint was created, in milliseconds since the Unix epoch. */ @JsonProperty("creation_timestamp") private Long creationTimestamp; @@ -42,7 +42,10 @@ public class ServingEndpoint { @JsonProperty("id") private String id; - /** The timestamp when the endpoint was last updated by a user in Unix time. */ + /** + * The timestamp when the endpoint was last updated by a user, in milliseconds since the Unix + * epoch. + */ @JsonProperty("last_updated_timestamp") private Long lastUpdatedTimestamp; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpointDetailed.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpointDetailed.java index 11490868e..e866b06dc 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpointDetailed.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/ServingEndpointDetailed.java @@ -26,7 +26,7 @@ public class ServingEndpointDetailed { @JsonProperty("config") private EndpointCoreConfigOutput config; - /** The timestamp when the endpoint was created in Unix time. */ + /** The timestamp when the endpoint was created, in milliseconds since the Unix epoch. */ @JsonProperty("creation_timestamp") private Long creationTimestamp; @@ -38,7 +38,7 @@ public class ServingEndpointDetailed { @JsonProperty("data_plane_info") private ModelDataPlaneInfo dataPlaneInfo; - /** Description of the serving model */ + /** Description of the serving endpoint. */ @JsonProperty("description") private String description; @@ -57,7 +57,10 @@ public class ServingEndpointDetailed { @JsonProperty("id") private String id; - /** The timestamp when the endpoint was last updated by a user in Unix time. */ + /** + * The timestamp when the endpoint was last updated by a user, in milliseconds since the Unix + * epoch. + */ @JsonProperty("last_updated_timestamp") private Long lastUpdatedTimestamp; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateInferenceEndpointNotificationsResponse.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateInferenceEndpointNotificationsResponse.java index 1ba0b7e66..399dee992 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateInferenceEndpointNotificationsResponse.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateInferenceEndpointNotificationsResponse.java @@ -9,11 +9,11 @@ @Generated public class UpdateInferenceEndpointNotificationsResponse { - /** */ + /** The email notification settings now in effect for the serving endpoint. */ @JsonProperty("email_notifications") private EmailNotifications emailNotifications; - /** */ + /** The name of the serving endpoint whose notification settings were updated. */ @JsonProperty("name") private String name; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateProvisionedThroughputEndpointConfigRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateProvisionedThroughputEndpointConfigRequest.java index 997aa5fbb..180d6f496 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateProvisionedThroughputEndpointConfigRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/UpdateProvisionedThroughputEndpointConfigRequest.java @@ -10,7 +10,7 @@ @Generated public class UpdateProvisionedThroughputEndpointConfigRequest { - /** */ + /** The core config of the serving endpoint. */ @JsonProperty("config") private PtEndpointCoreConfig config; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2.java index cc977548a..5636cd1d8 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2.java @@ -8,17 +8,28 @@ import java.util.Collection; import java.util.Objects; +/** + * A SQL alert. An alert runs a query on a schedule, evaluates the result against a condition, and + * notifies users or notification destinations when the condition is met. + */ @Generated public class AlertV2 { /** The timestamp indicating when the alert was created. */ @JsonProperty("create_time") private String createTime; - /** Custom description for the alert. Interpreted according to `custom_template_format`. */ + /** + * Custom description for the alert, used as the notification body. Interpreted according to + * `custom_template_format`. The available template variables are listed at + * https://docs.databricks.com/aws/en/sql/user/alerts/create#notification-templates. + */ @JsonProperty("custom_description") private String customDescription; - /** Custom summary for the alert. Interpreted according to `custom_template_format`. */ + /** + * Custom summary for the alert, used as the notification subject. Interpreted according to + * `custom_template_format`. + */ @JsonProperty("custom_summary") private String customSummary; @@ -47,7 +58,7 @@ public class AlertV2 { @JsonProperty("effective_run_as") private AlertV2RunAs effectiveRunAs; - /** */ + /** Condition evaluated against the query result, and who is notified when it is met. */ @JsonProperty("evaluation") private AlertV2Evaluation evaluation; @@ -55,7 +66,9 @@ public class AlertV2 { @JsonProperty("id") private String id; - /** Indicates whether the query is trashed. */ + /** + * Indicates whether the alert is active (`ACTIVE`) or has been moved to the trash (`DELETED`). + */ @JsonProperty("lifecycle_state") private AlertLifecycleState lifecycleState; @@ -104,15 +117,15 @@ public class AlertV2 { private AlertV2RunAs runAs; /** - * The run as username or application ID of service principal. On Create and Update, this field - * can be set to application ID of an active service principal. Setting this field requires the - * servicePrincipal/user role. Deprecated: Use `run_as` field instead. This field will be removed - * in a future release. + * Deprecated: Use `run_as` field instead. This field will be removed in a future release. The run + * as username or application ID of service principal. On Create and Update, this field can be set + * to application ID of an active service principal. Setting this field requires the + * servicePrincipal/user role. */ @JsonProperty("run_as_user_name") private String runAsUserName; - /** */ + /** Schedule on which the alert runs its query and evaluates the condition. */ @JsonProperty("schedule") private CronSchedule schedule; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Evaluation.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Evaluation.java index 5031da9d8..46d1bb151 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Evaluation.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Evaluation.java @@ -9,13 +9,16 @@ @Generated public class AlertV2Evaluation { - /** Operator used for comparison in alert evaluation. */ + /** + * Operator used for comparison in alert evaluation. The alert is triggered when the comparison of + * the source value with the threshold is true. `IS_NULL` and `IS_NOT_NULL` take no threshold. + */ @JsonProperty("comparison_operator") private ComparisonOperator comparisonOperator; /** - * Alert state if result is empty. Please avoid setting this field to be `UNKNOWN` because - * `UNKNOWN` state is planned to be deprecated. + * Alert state if result is empty. If not set, an empty result sets the state to `ERROR`. Please + * avoid setting this field to be `UNKNOWN` because `UNKNOWN` state is planned to be deprecated. */ @JsonProperty("empty_result_state") private AlertEvaluationState emptyResultState; @@ -32,11 +35,17 @@ public class AlertV2Evaluation { @JsonProperty("source") private AlertV2OperandColumn source; - /** Latest state of alert evaluation. */ + /** + * Latest state of alert evaluation: `TRIGGERED` when the condition was met, `OK` when it was not, + * and `ERROR` when the evaluation failed. + */ @JsonProperty("state") private AlertEvaluationState state; - /** Threshold to user for alert evaluation, can be a column or a value. */ + /** + * Threshold to compare the source column against, either another column or a fixed value. Not + * needed when `comparison_operator` is `IS_NULL` or `IS_NOT_NULL`. + */ @JsonProperty("threshold") private AlertV2Operand threshold; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Notification.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Notification.java index f46284e33..07d2d0496 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Notification.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Notification.java @@ -24,7 +24,7 @@ public class AlertV2Notification { @JsonProperty("retrigger_seconds") private Long retriggerSeconds; - /** */ + /** Users and notification destinations that receive notifications. */ @JsonProperty("subscriptions") private Collection subscriptions; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Operand.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Operand.java index 947ee092f..1cf010e6d 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Operand.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Operand.java @@ -9,11 +9,11 @@ @Generated public class AlertV2Operand { - /** */ + /** Compare the source against another column of the query result. */ @JsonProperty("column") private AlertV2OperandColumn column; - /** */ + /** Compare the source against a fixed value. */ @JsonProperty("value") private AlertV2OperandValue value; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandColumn.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandColumn.java index ca1ac3fe0..e12c63bbe 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandColumn.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandColumn.java @@ -9,15 +9,19 @@ @Generated public class AlertV2OperandColumn { - /** If not set, the behavior is equivalent to using `First row` in the UI. */ + /** + * Aggregation applied to the column across all rows of the query result: `SUM`, `COUNT`, + * `COUNT_DISTINCT`, `AVG`, `MEDIAN`, `MIN`, `MAX` or `STDDEV`. If not set, the value in the first + * row is used, which is equivalent to using `First row` in the UI. + */ @JsonProperty("aggregation") private Aggregation aggregation; - /** */ + /** Label for the column in notifications. Defaults to `name`. */ @JsonProperty("display") private String display; - /** */ + /** Name of the column in the query result. */ @JsonProperty("name") private String name; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandValue.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandValue.java index c1e883802..2e35ad4be 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandValue.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2OperandValue.java @@ -9,15 +9,15 @@ @Generated public class AlertV2OperandValue { - /** */ + /** Boolean threshold, for boolean columns. */ @JsonProperty("bool_value") private Boolean boolValue; - /** */ + /** Numeric threshold, for numeric columns. */ @JsonProperty("double_value") private Double doubleValue; - /** */ + /** String threshold, for string or timestamp columns. */ @JsonProperty("string_value") private String stringValue; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Subscription.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Subscription.java index cb0d96a42..10315175a 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Subscription.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertV2Subscription.java @@ -9,11 +9,13 @@ @Generated public class AlertV2Subscription { - /** */ + /** + * ID of the notification destination to notify, as returned by the Notification Destinations API. + */ @JsonProperty("destination_id") private String destinationId; - /** */ + /** Email address of the workspace user to notify. */ @JsonProperty("user_email") private String userEmail; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2API.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2API.java index 3659424f2..be6560166 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2API.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2API.java @@ -24,7 +24,10 @@ public AlertsV2API(AlertsV2Service mock) { impl = mock; } - /** Create Alert */ + /** + * Creates an alert that runs `query_text` on the given schedule and evaluates the result against + * the configured condition. + */ public AlertV2 createAlert(CreateAlertV2Request request) { return impl.createAlert(request); } @@ -66,7 +69,10 @@ public void trashAlert(TrashAlertV2Request request) { impl.trashAlert(request); } - /** Update alert */ + /** + * Updates an alert. Only the fields listed in `update_mask` are changed; all other fields keep + * their current values. + */ public AlertV2 updateAlert(UpdateAlertV2Request request) { return impl.updateAlert(request); } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2Service.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2Service.java index 65fb2d4cf..23ad21690 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2Service.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/AlertsV2Service.java @@ -12,7 +12,10 @@ */ @Generated public interface AlertsV2Service { - /** Create Alert */ + /** + * Creates an alert that runs `query_text` on the given schedule and evaluates the result against + * the configured condition. + */ AlertV2 createAlert(CreateAlertV2Request createAlertV2Request); /** Gets an alert. */ @@ -28,6 +31,9 @@ public interface AlertsV2Service { */ void trashAlert(TrashAlertV2Request trashAlertV2Request); - /** Update alert */ + /** + * Updates an alert. Only the fields listed in `update_mask` are changed; all other fields keep + * their current values. + */ AlertV2 updateAlert(UpdateAlertV2Request updateAlertV2Request); } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/CronSchedule.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/CronSchedule.java index d2245c416..d76948599 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/CronSchedule.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/CronSchedule.java @@ -9,12 +9,12 @@ @Generated public class CronSchedule { - /** Indicate whether this schedule is paused or not. */ + /** Indicates whether this schedule is paused. While paused, the alert is not evaluated. */ @JsonProperty("pause_status") private SchedulePauseStatus pauseStatus; /** - * A cron expression using quartz syntax that specifies the schedule for this pipeline. Should use + * A cron expression using quartz syntax that specifies the schedule for this alert. Should use * the quartz format described here: * http://www.quartz-scheduler.org/documentation/quartz-2.1.7/tutorials/tutorial-lesson-06.html */ diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/GetAlertV2Request.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/GetAlertV2Request.java index ed17fed9b..d493b321c 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/GetAlertV2Request.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/GetAlertV2Request.java @@ -9,7 +9,7 @@ @Generated public class GetAlertV2Request { - /** */ + /** ID of the alert to retrieve, as returned in the alert's `id` field. */ @JsonIgnore private String id; public GetAlertV2Request setId(String id) { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ListAlertsV2Request.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ListAlertsV2Request.java index ffc520a1d..8bc8c2338 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ListAlertsV2Request.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ListAlertsV2Request.java @@ -10,12 +10,15 @@ @Generated public class ListAlertsV2Request { - /** */ + /** Maximum number of alerts to return per page. Values above 100 are coerced to 100. */ @JsonIgnore @QueryParam("page_size") private Long pageSize; - /** */ + /** + * Page token returned as `next_page_token` by a previous call. Omit it to retrieve the first + * page. + */ @JsonIgnore @QueryParam("page_token") private String pageToken; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/TrashAlertV2Request.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/TrashAlertV2Request.java index ce97987f2..1f64de43b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/TrashAlertV2Request.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/TrashAlertV2Request.java @@ -10,7 +10,7 @@ @Generated public class TrashAlertV2Request { - /** */ + /** ID of the alert to move to the trash. */ @JsonIgnore private String id; /** Whether to permanently delete the alert. If not set, the alert will only be soft deleted. */ diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/UpdateAlertV2Request.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/UpdateAlertV2Request.java index 1f2503445..76e3c5efb 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/UpdateAlertV2Request.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/UpdateAlertV2Request.java @@ -19,15 +19,9 @@ public class UpdateAlertV2Request { @JsonIgnore private String id; /** - * The field mask must be a single string, with multiple fields separated by commas (no spaces). - * The field path is relative to the resource object, using a dot (`.`) to navigate sub-fields - * (e.g., `author.given_name`). Specification of elements in sequence or map fields is not - * allowed, as only the entire collection field can be specified. Field names must exactly match - * the resource field names. - * - *

A field mask of `*` indicates full replacement. It’s recommended to always explicitly list - * the fields being updated and avoid using `*` wildcards, as it can lead to unintended results if - * the API changes in the future. + * Comma-separated list of the alert fields to update, for example `display_name,query_text` or + * `schedule.pause_status`. Only the listed fields are changed; all other fields keep their + * current values. `parent_path` cannot be updated. */ @JsonIgnore @QueryParam("update_mask") diff --git a/examples/docs/pom.xml b/examples/docs/pom.xml index bd3503739..4f0c23cee 100644 --- a/examples/docs/pom.xml +++ b/examples/docs/pom.xml @@ -24,7 +24,7 @@ com.databricks databricks-sdk-java - 0.179.0 + 0.180.0 diff --git a/examples/spring-boot-oauth-u2m-demo/pom.xml b/examples/spring-boot-oauth-u2m-demo/pom.xml index 467c85449..044045393 100644 --- a/examples/spring-boot-oauth-u2m-demo/pom.xml +++ b/examples/spring-boot-oauth-u2m-demo/pom.xml @@ -40,7 +40,7 @@ com.databricks databricks-sdk-java - 0.179.0 + 0.180.0 diff --git a/lockfile.json b/lockfile.json index 94833daa1..a42a58036 100644 --- a/lockfile.json +++ b/lockfile.json @@ -1,7 +1,7 @@ { "artifactId": "databricks-sdk-parent", "groupId": "com.databricks", - "version": "0.179.0", + "version": "0.180.0", "lockFileVersion": 1, "dependencies": [], "mavenPlugins": [], diff --git a/pom.xml b/pom.xml index cc55fc3e6..d4a2d0cc7 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ 4.0.0 com.databricks databricks-sdk-parent - 0.179.0 + 0.180.0 pom Databricks SDK for Java The Databricks SDK for Java includes functionality to accelerate development with Java for diff --git a/shaded/pom.xml b/shaded/pom.xml index 95571bc3e..ac8958b17 100644 --- a/shaded/pom.xml +++ b/shaded/pom.xml @@ -4,7 +4,7 @@ 4.0.0 - 0.179.0 + 0.180.0 com.databricks