The caller must provide a `deployment_id` which becomes the final component of the - * deployment's resource name. If a deployment with the same ID already exists, the server returns - * `ALREADY_EXISTS`. - */ + /** Creates a new deployment in the workspace. */ public Deployment createDeployment(CreateDeploymentRequest request) { return impl.createDeployment(request); } @@ -77,13 +71,7 @@ public void deleteDeployment(String name) { deleteDeployment(new DeleteDeploymentRequest().setName(name)); } - /** - * Deletes a deployment. - * - *
The deployment is marked as deleted. It and all its children (versions and their operations) - * will be permanently deleted after the retention policy expires. If the deployment has an - * in-progress version, the server returns `RESOURCE_CONFLICT`. - */ + /** Deletes a deployment. */ public void deleteDeployment(DeleteDeploymentRequest request) { impl.deleteDeployment(request); } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/BundleDeploymentsService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/BundleDeploymentsService.java index 39912b3e0..79a31a826 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/BundleDeploymentsService.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/BundleDeploymentsService.java @@ -21,13 +21,7 @@ public interface BundleDeploymentsService { */ Version completeVersion(CompleteVersionRequest completeVersionRequest); - /** - * Creates a new deployment in the workspace. - * - *
The caller must provide a `deployment_id` which becomes the final component of the - * deployment's resource name. If a deployment with the same ID already exists, the server returns - * `ALREADY_EXISTS`. - */ + /** Creates a new deployment in the workspace. */ Deployment createDeployment(CreateDeploymentRequest createDeploymentRequest); /** @@ -53,13 +47,7 @@ public interface BundleDeploymentsService { */ Version createVersion(CreateVersionRequest createVersionRequest); - /** - * Deletes a deployment. - * - *
The deployment is marked as deleted. It and all its children (versions and their operations) - * will be permanently deleted after the retention policy expires. If the deployment has an - * in-progress version, the server returns `RESOURCE_CONFLICT`. - */ + /** Deletes a deployment. */ void deleteDeployment(DeleteDeploymentRequest deleteDeploymentRequest); /** Retrieves a deployment by its resource name. */ diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/CreateDeploymentRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/CreateDeploymentRequest.java index aa582f638..0fa885063 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/CreateDeploymentRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/CreateDeploymentRequest.java @@ -3,29 +3,19 @@ package com.databricks.sdk.service.bundledeployments; 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 CreateDeploymentRequest { /** - * The deployment to create. Caller must set `initial_parent_path`; every other field is populated - * by the service. + * The deployment to create. The caller must set `initial_parent_path`. Other fields are ignored + * on input and populated by the service. */ @JsonProperty("deployment") private Deployment deployment; - /** - * The ID to use for the deployment, which will become the final component of the deployment's - * resource name (i.e. `deployments/{deployment_id}`). - */ - @JsonIgnore - @QueryParam("deployment_id") - private String deploymentId; - public CreateDeploymentRequest setDeployment(Deployment deployment) { this.deployment = deployment; return this; @@ -35,34 +25,21 @@ public Deployment getDeployment() { return deployment; } - public CreateDeploymentRequest setDeploymentId(String deploymentId) { - this.deploymentId = deploymentId; - return this; - } - - public String getDeploymentId() { - return deploymentId; - } - @Override public boolean equals(Object o) { if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; CreateDeploymentRequest that = (CreateDeploymentRequest) o; - return Objects.equals(deployment, that.deployment) - && Objects.equals(deploymentId, that.deploymentId); + return Objects.equals(deployment, that.deployment); } @Override public int hashCode() { - return Objects.hash(deployment, deploymentId); + return Objects.hash(deployment); } @Override public String toString() { - return new ToStringer(CreateDeploymentRequest.class) - .add("deployment", deployment) - .add("deploymentId", deploymentId) - .toString(); + return new ToStringer(CreateDeploymentRequest.class).add("deployment", deployment).toString(); } } diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Deployment.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Deployment.java index 82c96055f..3866a7718 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Deployment.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Deployment.java @@ -27,9 +27,8 @@ public class Deployment { private DeploymentMode deploymentMode; /** - * When the deployment was destroyed (i.e. `bundle destroy` completed). Unset if the deployment - * has not been destroyed. Named destroy_time (not delete_time) because this tracks the - * `databricks bundle destroy` command, not the API-level deletion. + * When deletion was recorded. Unset if deletion has not been recorded. This response metadata + * does not determine the deployment's lifecycle status. */ @JsonProperty("destroy_time") private Timestamp destroyTime; @@ -42,8 +41,8 @@ public class Deployment { private String destroyedBy; /** - * Human-readable name for the deployment. Output only: it is denormalized from the latest - * version, not set directly on the deployment. + * Human-readable name for the deployment, up to 256 characters. Output only: clients update it by + * setting `display_name` when creating a version. */ @JsonProperty("display_name") private String displayName; @@ -53,11 +52,12 @@ public class Deployment { private GitInfo gitInfo; /** - * The workspace path of the folder where the deployment is initially created. Includes a leading - * slash and no trailing slash. On create, the deployment is registered as a typed - * BUNDLE_DEPLOYMENT tree node under this folder, which must already exist. This field is input - * only and is not returned in create, get, or list responses. The service rejects create requests - * that omit it. + * The workspace path of the existing folder where the deployment is initially created. Must be + * absolute and canonical, with single separators, no `.` or `..` segments, and no trailing slash + * unless the path is `/`. It may contain at most 24 path segments, excluding an optional leading + * `/Workspace` segment. The complete path may contain up to 1,024 characters, and each segment + * may contain up to 511 characters. This field is input only and is not returned in create, get, + * or list responses. */ @JsonProperty("initial_parent_path") private String initialParentPath; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListDeploymentsRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListDeploymentsRequest.java index 0e81e71e3..2d65a6cf1 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListDeploymentsRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListDeploymentsRequest.java @@ -12,8 +12,8 @@ public class ListDeploymentsRequest { /** * The maximum number of deployments to return. The service may return fewer than this value. If - * unspecified, at most 50 deployments will be returned. The maximum value is 1000; values above - * 1000 will be coerced to 1000. + * unspecified, at most 20 deployments will be returned. The maximum value is 100; values above + * 100 will be coerced to 100. */ @JsonIgnore @QueryParam("page_size") diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListVersionsRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListVersionsRequest.java index 6e823f49e..fced0e784 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListVersionsRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/ListVersionsRequest.java @@ -12,8 +12,8 @@ public class ListVersionsRequest { /** * The maximum number of versions to return. The service may return fewer than this value. If - * unspecified, at most 50 versions will be returned. The maximum value is 1000; values above 1000 - * will be coerced to 1000. + * unspecified, at most 20 versions will be returned. The maximum value is 100; values above 100 + * will be coerced to 100. */ @JsonIgnore @QueryParam("page_size") diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Version.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Version.java index 0d9a70d3b..46e0a2996 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Version.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/bundledeployments/Version.java @@ -51,7 +51,11 @@ public class Version { @JsonProperty("deployment_mode") private DeploymentMode deploymentMode; - /** Display name for the deployment, captured at the time of this version. */ + /** + * Display name for the deployment, captured at the time of this version. Up to 256 characters. + * When present, creating the version updates the deployment display name. An empty value clears + * it; an absent value leaves the current deployment display name unchanged. + */ @JsonProperty("display_name") private String displayName; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/SpecialDestination.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/SpecialDestination.java index 105d24844..ca95fc942 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/SpecialDestination.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/SpecialDestination.java @@ -10,5 +10,10 @@ public enum SpecialDestination { SPECIAL_DESTINATION_CONNECTION_OWNER, SPECIAL_DESTINATION_CREDENTIAL_OWNER, SPECIAL_DESTINATION_EXTERNAL_LOCATION_OWNER, + SPECIAL_DESTINATION_FUNCTION_OWNER, SPECIAL_DESTINATION_METASTORE_OWNER, + SPECIAL_DESTINATION_REGISTERED_MODEL_OWNER, + SPECIAL_DESTINATION_SCHEMA_OWNER, + SPECIAL_DESTINATION_TABLE_OWNER, + SPECIAL_DESTINATION_VOLUME_OWNER, }