For new workloads, Databricks recommends the [Postgres API], which supports the latest + * Lakebase features. + * + *
[Postgres API]: https://docs.databricks.com/api/postgres/v1/postgres
+ */
public DatabaseAPI database() {
return databaseAPI;
}
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 6c81aa24d..b8581593e 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.171.0";
+ private static final String version = "0.172.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/billing/AlertSpendStatus.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/billing/AlertSpendStatus.java
new file mode 100644
index 000000000..6b51044e9
--- /dev/null
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/billing/AlertSpendStatus.java
@@ -0,0 +1,124 @@
+// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT.
+
+package com.databricks.sdk.service.billing;
+
+import com.databricks.sdk.support.Generated;
+import com.databricks.sdk.support.ToStringer;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.Objects;
+
+/**
+ * The calling user's spend against a single blocking threshold. Values may be omitted if live spend
+ * or threshold data is temporarily unavailable.
+ */
+@Generated
+public class AlertSpendStatus {
+ /**
+ * Percentage of the threshold consumed, as a decimal string rounded down to one decimal place
+ * (for example, "68.4" means 68.4%). May exceed 100 when spend is over the threshold. Returns
+ * "0.0" if there's no spend, and is omitted if the threshold is $0. For shared thresholds, this
+ * is the only value returned; the absolute `spend` and `threshold` dollar amounts are withheld.
+ */
+ @JsonProperty("percent_consumed")
+ private String percentConsumed;
+
+ /**
+ * Whether the threshold is evaluated per individual user
+ * (`ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER`) or on the shared spend across all users
+ * (`ALERT_CONFIGURATION_SCOPE_TYPE_SHARED`).
+ */
+ @JsonProperty("scope_type")
+ private AlertConfigurationScopeType scopeType;
+
+ /**
+ * The calling user's live spend against this threshold, in USD at list price. Returns "0" if the
+ * caller has no usage. Omitted for shared thresholds, where only `percent_consumed` is returned.
+ */
+ @JsonProperty("spend")
+ private String spend;
+
+ /**
+ * The calling user's effective threshold, in USD at list price. The effective threshold is the
+ * actual threshold amount that applies to the user, after adjusting for any user or group
+ * overrides. Omitted for shared thresholds, where only `percent_consumed` is returned.
+ */
+ @JsonProperty("threshold")
+ private String threshold;
+
+ /** The time window the threshold applies to, for example `MONTH`. */
+ @JsonProperty("time_period")
+ private AlertConfigurationTimePeriod timePeriod;
+
+ public AlertSpendStatus setPercentConsumed(String percentConsumed) {
+ this.percentConsumed = percentConsumed;
+ return this;
+ }
+
+ public String getPercentConsumed() {
+ return percentConsumed;
+ }
+
+ public AlertSpendStatus setScopeType(AlertConfigurationScopeType scopeType) {
+ this.scopeType = scopeType;
+ return this;
+ }
+
+ public AlertConfigurationScopeType getScopeType() {
+ return scopeType;
+ }
+
+ public AlertSpendStatus setSpend(String spend) {
+ this.spend = spend;
+ return this;
+ }
+
+ public String getSpend() {
+ return spend;
+ }
+
+ public AlertSpendStatus setThreshold(String threshold) {
+ this.threshold = threshold;
+ return this;
+ }
+
+ public String getThreshold() {
+ return threshold;
+ }
+
+ public AlertSpendStatus setTimePeriod(AlertConfigurationTimePeriod timePeriod) {
+ this.timePeriod = timePeriod;
+ return this;
+ }
+
+ public AlertConfigurationTimePeriod getTimePeriod() {
+ return timePeriod;
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) return true;
+ if (o == null || getClass() != o.getClass()) return false;
+ AlertSpendStatus that = (AlertSpendStatus) o;
+ return Objects.equals(percentConsumed, that.percentConsumed)
+ && Objects.equals(scopeType, that.scopeType)
+ && Objects.equals(spend, that.spend)
+ && Objects.equals(threshold, that.threshold)
+ && Objects.equals(timePeriod, that.timePeriod);
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(percentConsumed, scopeType, spend, threshold, timePeriod);
+ }
+
+ @Override
+ public String toString() {
+ return new ToStringer(AlertSpendStatus.class)
+ .add("percentConsumed", percentConsumed)
+ .add("scopeType", scopeType)
+ .add("spend", spend)
+ .add("threshold", threshold)
+ .add("timePeriod", timePeriod)
+ .toString();
+ }
+}
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/billing/BudgetSpendStatus.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/billing/BudgetSpendStatus.java
new file mode 100644
index 000000000..0699df6c0
--- /dev/null
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/billing/BudgetSpendStatus.java
@@ -0,0 +1,68 @@
+// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT.
+
+package com.databricks.sdk.service.billing;
+
+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;
+
+/** The calling user's live spend against the blocking thresholds of a single budget. */
+@Generated
+public class BudgetSpendStatus {
+ /**
+ * The calling user's spend against each blocking threshold on this budget, one entry per scope
+ * type and time period. A blocking threshold is a threshold that, once reached, blocks further
+ * requests through Unity Gateway.
+ */
+ @JsonProperty("alert_spend_statuses")
+ private Collection For new workloads, Databricks recommends the [Postgres API], which supports the latest
+ * Lakebase features.
+ *
+ * [Postgres API]: https://docs.databricks.com/api/postgres/v1/postgres
+ */
@Generated
public class DatabaseAPI {
private static final Logger LOG = LoggerFactory.getLogger(DatabaseAPI.class);
@@ -70,12 +77,24 @@ public DatabaseInstance waitGetDatabaseInstanceDatabaseAvailable(
throw new TimeoutException(String.format("timed out after %s: %s", timeout, statusMessage));
}
- /** Create a Database Catalog. */
+ /**
+ * Create a Database Catalog.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Create a catalog].
+ *
+ * [Create a catalog]: https://docs.databricks.com/api/postgres/v1/create-catalog
+ */
public DatabaseCatalog createDatabaseCatalog(CreateDatabaseCatalogRequest request) {
return impl.createDatabaseCatalog(request);
}
- /** Create a Database Instance. */
+ /**
+ * Create a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Create a project].
+ *
+ * [Create a project]: https://docs.databricks.com/api/postgres/v1/create-project
+ */
public Wait For new workloads, Databricks recommends the Postgres API equivalent: [Create a role].
+ *
+ * [Create a role]: https://docs.databricks.com/api/postgres/v1/create-role
+ */
public DatabaseInstanceRole createDatabaseInstanceRole(
CreateDatabaseInstanceRoleRequest request) {
return impl.createDatabaseInstanceRole(request);
@@ -99,7 +124,14 @@ public DatabaseTable createDatabaseTable(CreateDatabaseTableRequest request) {
return impl.createDatabaseTable(request);
}
- /** Create a Synced Database Table. */
+ /**
+ * Create a Synced Database Table.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Create a synced
+ * table].
+ *
+ * [Create a synced table]: https://docs.databricks.com/api/postgres/v1/create-synced-table
+ */
public SyncedDatabaseTable createSyncedDatabaseTable(CreateSyncedDatabaseTableRequest request) {
return impl.createSyncedDatabaseTable(request);
}
@@ -108,7 +140,13 @@ public void deleteDatabaseCatalog(String name) {
deleteDatabaseCatalog(new DeleteDatabaseCatalogRequest().setName(name));
}
- /** Delete a Database Catalog. */
+ /**
+ * Delete a Database Catalog.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a catalog].
+ *
+ * [Delete a catalog]: https://docs.databricks.com/api/postgres/v1/delete-catalog
+ */
public void deleteDatabaseCatalog(DeleteDatabaseCatalogRequest request) {
impl.deleteDatabaseCatalog(request);
}
@@ -117,7 +155,13 @@ public void deleteDatabaseInstance(String name) {
deleteDatabaseInstance(new DeleteDatabaseInstanceRequest().setName(name));
}
- /** Delete a Database Instance. */
+ /**
+ * Delete a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a project].
+ *
+ * [Delete a project]: https://docs.databricks.com/api/postgres/v1/delete-project
+ */
public void deleteDatabaseInstance(DeleteDatabaseInstanceRequest request) {
impl.deleteDatabaseInstance(request);
}
@@ -127,7 +171,13 @@ public void deleteDatabaseInstanceRole(String instanceName, String name) {
new DeleteDatabaseInstanceRoleRequest().setInstanceName(instanceName).setName(name));
}
- /** Deletes a role for a Database Instance. */
+ /**
+ * Deletes a role for a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a role].
+ *
+ * [Delete a role]: https://docs.databricks.com/api/postgres/v1/delete-role
+ */
public void deleteDatabaseInstanceRole(DeleteDatabaseInstanceRoleRequest request) {
impl.deleteDatabaseInstanceRole(request);
}
@@ -145,7 +195,14 @@ public void deleteSyncedDatabaseTable(String name) {
deleteSyncedDatabaseTable(new DeleteSyncedDatabaseTableRequest().setName(name));
}
- /** Delete a Synced Database Table. */
+ /**
+ * Delete a Synced Database Table.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a synced
+ * table].
+ *
+ * [Delete a synced table]: https://docs.databricks.com/api/postgres/v1/delete-synced-table
+ */
public void deleteSyncedDatabaseTable(DeleteSyncedDatabaseTableRequest request) {
impl.deleteSyncedDatabaseTable(request);
}
@@ -155,7 +212,15 @@ public DatabaseInstance findDatabaseInstanceByUid(FindDatabaseInstanceByUidReque
return impl.findDatabaseInstanceByUid(request);
}
- /** Generates a credential that can be used to access database instances. */
+ /**
+ * Generates a credential that can be used to access database instances.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Generate a database
+ * credential].
+ *
+ * [Generate a database credential]:
+ * https://docs.databricks.com/api/postgres/v1/generate-database-credential
+ */
public DatabaseCredential generateDatabaseCredential(GenerateDatabaseCredentialRequest request) {
return impl.generateDatabaseCredential(request);
}
@@ -164,7 +229,13 @@ public DatabaseCatalog getDatabaseCatalog(String name) {
return getDatabaseCatalog(new GetDatabaseCatalogRequest().setName(name));
}
- /** Get a Database Catalog. */
+ /**
+ * Get a Database Catalog.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a catalog].
+ *
+ * [Get a catalog]: https://docs.databricks.com/api/postgres/v1/get-catalog
+ */
public DatabaseCatalog getDatabaseCatalog(GetDatabaseCatalogRequest request) {
return impl.getDatabaseCatalog(request);
}
@@ -173,7 +244,13 @@ public DatabaseInstance getDatabaseInstance(String name) {
return getDatabaseInstance(new GetDatabaseInstanceRequest().setName(name));
}
- /** Get a Database Instance. */
+ /**
+ * Get a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a project].
+ *
+ * [Get a project]: https://docs.databricks.com/api/postgres/v1/get-project
+ */
public DatabaseInstance getDatabaseInstance(GetDatabaseInstanceRequest request) {
return impl.getDatabaseInstance(request);
}
@@ -183,7 +260,13 @@ public DatabaseInstanceRole getDatabaseInstanceRole(String instanceName, String
new GetDatabaseInstanceRoleRequest().setInstanceName(instanceName).setName(name));
}
- /** Gets a role for a Database Instance. */
+ /**
+ * Gets a role for a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a role].
+ *
+ * [Get a role]: https://docs.databricks.com/api/postgres/v1/get-role
+ */
public DatabaseInstanceRole getDatabaseInstanceRole(GetDatabaseInstanceRoleRequest request) {
return impl.getDatabaseInstanceRole(request);
}
@@ -201,7 +284,13 @@ public SyncedDatabaseTable getSyncedDatabaseTable(String name) {
return getSyncedDatabaseTable(new GetSyncedDatabaseTableRequest().setName(name));
}
- /** Get a Synced Database Table. */
+ /**
+ * Get a Synced Database Table.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a synced table].
+ *
+ * [Get a synced table]: https://docs.databricks.com/api/postgres/v1/get-synced-table
+ */
public SyncedDatabaseTable getSyncedDatabaseTable(GetSyncedDatabaseTableRequest request) {
return impl.getSyncedDatabaseTable(request);
}
@@ -231,10 +320,11 @@ public Iterable For new workloads, Databricks recommends the Postgres API equivalent: [List roles].
+ *
+ * [List roles]: https://docs.databricks.com/api/postgres/v1/list-roles
*/
public Iterable For new workloads, Databricks recommends the Postgres API equivalent: [List projects].
+ *
+ * [List projects]: https://docs.databricks.com/api/postgres/v1/list-projects
+ */
public Iterable For new workloads, Databricks recommends the Postgres API equivalents: [Update a project]
+ * and [Update an endpoint].
+ *
+ * [Update a project]: https://docs.databricks.com/api/postgres/v1/update-project [Update an
+ * endpoint]: https://docs.databricks.com/api/postgres/v1/update-endpoint
+ */
public DatabaseInstance updateDatabaseInstance(UpdateDatabaseInstanceRequest request) {
return impl.updateDatabaseInstance(request);
}
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/database/DatabaseService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/database/DatabaseService.java
index 78aa7cebd..1aa709e8f 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/database/DatabaseService.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/database/DatabaseService.java
@@ -6,20 +6,43 @@
/**
* Database Instances provide access to a database via REST API or direct SQL.
*
+ * For new workloads, Databricks recommends the [Postgres API], which supports the latest
+ * Lakebase features.
+ *
+ * [Postgres API]: https://docs.databricks.com/api/postgres/v1/postgres
+ *
* This is the high-level interface, that contains generated methods.
*
* Evolving: this interface is under development. Method signatures may change.
*/
@Generated
public interface DatabaseService {
- /** Create a Database Catalog. */
+ /**
+ * Create a Database Catalog.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Create a catalog].
+ *
+ * [Create a catalog]: https://docs.databricks.com/api/postgres/v1/create-catalog
+ */
DatabaseCatalog createDatabaseCatalog(CreateDatabaseCatalogRequest createDatabaseCatalogRequest);
- /** Create a Database Instance. */
+ /**
+ * Create a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Create a project].
+ *
+ * [Create a project]: https://docs.databricks.com/api/postgres/v1/create-project
+ */
DatabaseInstance createDatabaseInstance(
CreateDatabaseInstanceRequest createDatabaseInstanceRequest);
- /** Create a role for a Database Instance. */
+ /**
+ * Create a role for a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Create a role].
+ *
+ * [Create a role]: https://docs.databricks.com/api/postgres/v1/create-role
+ */
DatabaseInstanceRole createDatabaseInstanceRole(
CreateDatabaseInstanceRoleRequest createDatabaseInstanceRoleRequest);
@@ -29,48 +52,112 @@ DatabaseInstanceRole createDatabaseInstanceRole(
*/
DatabaseTable createDatabaseTable(CreateDatabaseTableRequest createDatabaseTableRequest);
- /** Create a Synced Database Table. */
+ /**
+ * Create a Synced Database Table.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Create a synced
+ * table].
+ *
+ * [Create a synced table]: https://docs.databricks.com/api/postgres/v1/create-synced-table
+ */
SyncedDatabaseTable createSyncedDatabaseTable(
CreateSyncedDatabaseTableRequest createSyncedDatabaseTableRequest);
- /** Delete a Database Catalog. */
+ /**
+ * Delete a Database Catalog.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a catalog].
+ *
+ * [Delete a catalog]: https://docs.databricks.com/api/postgres/v1/delete-catalog
+ */
void deleteDatabaseCatalog(DeleteDatabaseCatalogRequest deleteDatabaseCatalogRequest);
- /** Delete a Database Instance. */
+ /**
+ * Delete a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a project].
+ *
+ * [Delete a project]: https://docs.databricks.com/api/postgres/v1/delete-project
+ */
void deleteDatabaseInstance(DeleteDatabaseInstanceRequest deleteDatabaseInstanceRequest);
- /** Deletes a role for a Database Instance. */
+ /**
+ * Deletes a role for a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a role].
+ *
+ * [Delete a role]: https://docs.databricks.com/api/postgres/v1/delete-role
+ */
void deleteDatabaseInstanceRole(
DeleteDatabaseInstanceRoleRequest deleteDatabaseInstanceRoleRequest);
/** Delete a Database Table. */
void deleteDatabaseTable(DeleteDatabaseTableRequest deleteDatabaseTableRequest);
- /** Delete a Synced Database Table. */
+ /**
+ * Delete a Synced Database Table.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Delete a synced
+ * table].
+ *
+ * [Delete a synced table]: https://docs.databricks.com/api/postgres/v1/delete-synced-table
+ */
void deleteSyncedDatabaseTable(DeleteSyncedDatabaseTableRequest deleteSyncedDatabaseTableRequest);
/** Find a Database Instance by uid. */
DatabaseInstance findDatabaseInstanceByUid(
FindDatabaseInstanceByUidRequest findDatabaseInstanceByUidRequest);
- /** Generates a credential that can be used to access database instances. */
+ /**
+ * Generates a credential that can be used to access database instances.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Generate a database
+ * credential].
+ *
+ * [Generate a database credential]:
+ * https://docs.databricks.com/api/postgres/v1/generate-database-credential
+ */
DatabaseCredential generateDatabaseCredential(
GenerateDatabaseCredentialRequest generateDatabaseCredentialRequest);
- /** Get a Database Catalog. */
+ /**
+ * Get a Database Catalog.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a catalog].
+ *
+ * [Get a catalog]: https://docs.databricks.com/api/postgres/v1/get-catalog
+ */
DatabaseCatalog getDatabaseCatalog(GetDatabaseCatalogRequest getDatabaseCatalogRequest);
- /** Get a Database Instance. */
+ /**
+ * Get a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a project].
+ *
+ * [Get a project]: https://docs.databricks.com/api/postgres/v1/get-project
+ */
DatabaseInstance getDatabaseInstance(GetDatabaseInstanceRequest getDatabaseInstanceRequest);
- /** Gets a role for a Database Instance. */
+ /**
+ * Gets a role for a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a role].
+ *
+ * [Get a role]: https://docs.databricks.com/api/postgres/v1/get-role
+ */
DatabaseInstanceRole getDatabaseInstanceRole(
GetDatabaseInstanceRoleRequest getDatabaseInstanceRoleRequest);
/** Get a Database Table. */
DatabaseTable getDatabaseTable(GetDatabaseTableRequest getDatabaseTableRequest);
- /** Get a Synced Database Table. */
+ /**
+ * Get a Synced Database Table.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [Get a synced table].
+ *
+ * [Get a synced table]: https://docs.databricks.com/api/postgres/v1/get-synced-table
+ */
SyncedDatabaseTable getSyncedDatabaseTable(
GetSyncedDatabaseTableRequest getSyncedDatabaseTableRequest);
@@ -79,15 +166,22 @@ ListDatabaseCatalogsResponse listDatabaseCatalogs(
ListDatabaseCatalogsRequest listDatabaseCatalogsRequest);
/**
- * START OF PG ROLE APIs Section These APIs are marked a PUBLIC with stage < PUBLIC_PREVIEW. With
- * more recent Lakebase V2 plans, we don't plan to ever advance these to PUBLIC_PREVIEW. These
- * APIs will remain effectively undocumented/UI-only and we'll aim for a new public roles API as
- * part of V2 PuPr.
+ * List roles for a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [List roles].
+ *
+ * [List roles]: https://docs.databricks.com/api/postgres/v1/list-roles
*/
ListDatabaseInstanceRolesResponse listDatabaseInstanceRoles(
ListDatabaseInstanceRolesRequest listDatabaseInstanceRolesRequest);
- /** List Database Instances. */
+ /**
+ * List Database Instances.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalent: [List projects].
+ *
+ * [List projects]: https://docs.databricks.com/api/postgres/v1/list-projects
+ */
ListDatabaseInstancesResponse listDatabaseInstances(
ListDatabaseInstancesRequest listDatabaseInstancesRequest);
@@ -98,7 +192,15 @@ ListSyncedDatabaseTablesResponse listSyncedDatabaseTables(
/** This API is currently unimplemented, but exposed for Terraform support. */
DatabaseCatalog updateDatabaseCatalog(UpdateDatabaseCatalogRequest updateDatabaseCatalogRequest);
- /** Update a Database Instance. */
+ /**
+ * Update a Database Instance.
+ *
+ * For new workloads, Databricks recommends the Postgres API equivalents: [Update a project]
+ * and [Update an endpoint].
+ *
+ * [Update a project]: https://docs.databricks.com/api/postgres/v1/update-project [Update an
+ * endpoint]: https://docs.databricks.com/api/postgres/v1/update-endpoint
+ */
DatabaseInstance updateDatabaseInstance(
UpdateDatabaseInstanceRequest updateDatabaseInstanceRequest);
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2API.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2API.java
index fd92f8da1..515bf2409 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2API.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2API.java
@@ -546,6 +546,8 @@ public Group updateGroup(UpdateGroupRequest request) {
* Updates an existing service principal in the Databricks account. Only the fields named in the
* update mask are modified. Returns the updated ServicePrincipal resource.
*
+ * For locally managed service principals, is_agent must be set to true or false when updated.
+ *
* When AIM is enabled and the service principal is an external identity (its external_id is
* set), only external_id can be updated; its other fields are sourced from your identity
* provider.
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2Service.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2Service.java
index d9130f85f..d66ce253c 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2Service.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/AccountIamV2Service.java
@@ -281,6 +281,8 @@ ResolveServicePrincipalResponse resolveServicePrincipal(
* Updates an existing service principal in the Databricks account. Only the fields named in the
* update mask are modified. Returns the updated ServicePrincipal resource.
*
+ * For locally managed service principals, is_agent must be set to true or false when updated.
+ *
* When AIM is enabled and the service principal is an external identity (its external_id is
* set), only external_id can be updated; its other fields are sourced from your identity
* provider.
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/DirectGroupMember.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/DirectGroupMember.java
index 3b615b67d..296903d52 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/DirectGroupMember.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/DirectGroupMember.java
@@ -14,7 +14,7 @@ public class DirectGroupMember {
@JsonProperty("display_name")
private String displayName;
- /** The external ID of the principal in Databricks. */
+ /** The external ID of the principal in the customer's IdP. */
@JsonProperty("external_id")
private String externalId;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupProxyRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupProxyRequest.java
index 92a78a90c..1b94dc7a5 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupProxyRequest.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupProxyRequest.java
@@ -18,7 +18,7 @@ public class UpdateGroupProxyRequest {
/** Required. Internal ID of the group in Databricks. */
@JsonIgnore private String groupId;
- /** Optional. The list of fields to update. */
+ /** Required. The list of fields to update. */
@JsonIgnore
@QueryParam("update_mask")
private String updateMask;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupRequest.java
index 3a4147719..782aadc28 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupRequest.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateGroupRequest.java
@@ -18,7 +18,7 @@ public class UpdateGroupRequest {
/** Required. Internal ID of the group in Databricks. */
@JsonIgnore private String groupId;
- /** Optional. The list of fields to update. */
+ /** Required. The list of fields to update. */
@JsonIgnore
@QueryParam("update_mask")
private String updateMask;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalProxyRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalProxyRequest.java
index 334d7f1bb..394b3933e 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalProxyRequest.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalProxyRequest.java
@@ -18,7 +18,7 @@ public class UpdateServicePrincipalProxyRequest {
/** Required. Internal ID of the service principal in Databricks. */
@JsonIgnore private String servicePrincipalId;
- /** Optional. The list of fields to update. */
+ /** Required. The list of fields to update. */
@JsonIgnore
@QueryParam("update_mask")
private String updateMask;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalRequest.java
index a7b5de289..8d38ca62b 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalRequest.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateServicePrincipalRequest.java
@@ -18,7 +18,7 @@ public class UpdateServicePrincipalRequest {
/** Required. Internal ID of the service principal in Databricks. */
@JsonIgnore private String servicePrincipalId;
- /** Optional. The list of fields to update. */
+ /** Required. The list of fields to update. */
@JsonIgnore
@QueryParam("update_mask")
private String updateMask;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserProxyRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserProxyRequest.java
index 5eae94056..cefe2c876 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserProxyRequest.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserProxyRequest.java
@@ -11,7 +11,7 @@
@Generated
public class UpdateUserProxyRequest {
- /** Optional. The list of fields to update. */
+ /** Required. The list of fields to update. */
@JsonIgnore
@QueryParam("update_mask")
private String updateMask;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserRequest.java
index 52d0f32c2..4c836e322 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserRequest.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/UpdateUserRequest.java
@@ -11,7 +11,7 @@
@Generated
public class UpdateUserRequest {
- /** Optional. The list of fields to update. */
+ /** Required. The list of fields to update. */
@JsonIgnore
@QueryParam("update_mask")
private String updateMask;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2API.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2API.java
index 52b708b2f..f94addd67 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2API.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2API.java
@@ -485,6 +485,8 @@ public Group updateGroupProxy(UpdateGroupProxyRequest request) {
* workspace. Only the fields named in the update mask are modified. Returns the updated
* ServicePrincipal resource.
*
+ * For locally managed service principals, is_agent must be set to true or false when updated.
+ *
* When AIM is enabled and the service principal is an external identity (its external_id is
* set), only external_id can be updated; its other fields are sourced from your identity
* provider.
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2Service.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2Service.java
index d34be2028..26af04e2e 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2Service.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/iamv2/WorkspaceIamV2Service.java
@@ -260,6 +260,8 @@ ResolveServicePrincipalResponse resolveServicePrincipalProxy(
* workspace. Only the fields named in the update mask are modified. Returns the updated
* ServicePrincipal resource.
*
+ * For locally managed service principals, is_agent must be set to true or false when updated.
+ *
* When AIM is enabled and the service principal is an external identity (its external_id is
* set), only external_id can be updated; its other fields are sourced from your identity
* provider.
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 6aa712e8e..cc977548a 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
@@ -14,11 +14,11 @@ public class AlertV2 {
@JsonProperty("create_time")
private String createTime;
- /** Custom description for the alert. support mustache template. */
+ /** Custom description for the alert. Interpreted according to `custom_template_format`. */
@JsonProperty("custom_description")
private String customDescription;
- /** Custom summary for the alert. support mustache template. */
+ /** Custom summary for the alert. Interpreted according to `custom_template_format`. */
@JsonProperty("custom_summary")
private String customSummary;
diff --git a/examples/docs/pom.xml b/examples/docs/pom.xml
index fed6fdb4f..22fc161aa 100644
--- a/examples/docs/pom.xml
+++ b/examples/docs/pom.xml
@@ -24,7 +24,7 @@