Add types for all the Databricks error detail types.

databricks-sdk-java/pom.xml

@@ -104,6 +104,12 @@
       <artifactId>jackson-datatype-jsr310</artifactId>
       <version>${jackson.version}</version>
     </dependency>
+    <!-- Jackson Guava module needed to serialize/deserialize AutoValue classes -->
+    <dependency>
+      <groupId>com.fasterxml.jackson.datatype</groupId>
+      <artifactId>jackson-datatype-guava</artifactId>
+      <version>${jackson.version}</version>
+    </dependency>
     <!-- Google Auto Value -->
     <dependency>
       <groupId>com.google.auto.value</groupId>

databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksError.java

@@ -14,8 +14,6 @@
  * unrecoverable way and this exception should be thrown, potentially wrapped in another exception.
  */
 public class DatabricksError extends DatabricksException {
-  private static final String ERROR_INFO_TYPE = "type.googleapis.com/google.rpc.ErrorInfo";
-  private final String message;
   private final Throwable cause;
   private final String errorCode;
   private final int statusCode;
@@ -51,14 +49,13 @@ private DatabricksError(
       List<ErrorDetail> details) {
     super(message, cause);
     this.errorCode = errorCode;
-    this.message = message;
     this.cause = cause;
     this.statusCode = statusCode;
     this.details = details == null ? Collections.emptyList() : details;
   }
 
   public List<ErrorDetail> getErrorInfo() {
-    return this.getDetailsByType(ERROR_INFO_TYPE);
+    return this.getDetailsByType("type.googleapis.com/google.rpc.ErrorInfo");
   }
 
   public String getErrorCode() {

databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/ApiErrorBody.java

@@ -1,7 +1,10 @@
 package com.databricks.sdk.core.error;
 
+import com.databricks.sdk.core.error.details.ErrorDetails;
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.Arrays;
+import java.util.Collections;
 import java.util.List;
 
 /**
@@ -21,21 +24,31 @@ public class ApiErrorBody {
 
   public ApiErrorBody() {}
 
+  /**
+   * Constructs an ApiErrorBody from the given parameters.
+   *
+   * <p>The error details are converted to a list of ErrorDetail objects. This only supports the
+   * ErrorInfo type.
+   *
+   * @param errorCode The error code.
+   * @param message The error message.
+   * @param scimDetail The SCIM detail.
+   */
   public ApiErrorBody(
       @JsonProperty("error_code") String errorCode,
       @JsonProperty("message") String message,
       @JsonProperty("detail") String scimDetail,
       @JsonProperty("status") String scimStatus,
       @JsonProperty("scimType") String scimType,
       @JsonProperty("error") String api12Error,
-      @JsonProperty("details") List<ErrorDetail> errorDetails) {
+      @JsonProperty("details") ErrorDetails errorDetails) {
     this.errorCode = errorCode;
     this.message = message;
     this.scimDetail = scimDetail;
     this.scimStatus = scimStatus;
     this.scimType = scimType;
     this.api12Error = api12Error;
-    this.errorDetails = errorDetails;
+    this.errorDetails = fromDetails(errorDetails);
   }
 
   public List<ErrorDetail> getErrorDetails() {
@@ -93,4 +106,26 @@ public String getApi12Error() {
   public void setApi12Error(String api12Error) {
     this.api12Error = api12Error;
   }
+
+  /**
+   * Converts the error details to a list of ErrorDetail objects. This only supports the ErrorInfo
+   * type.
+   *
+   * @param details The error details to convert.
+   * @return A list of ErrorDetail objects.
+   */
+  private static List<ErrorDetail> fromDetails(ErrorDetails details) {
+    if (details == null) {
+      return Collections.emptyList();
+    }
+    if (!details.errorInfo().isPresent()) {
+      return Collections.emptyList();
+    }
+    return Arrays.asList(
+        new ErrorDetail(
+            "type.googleapis.com/google.rpc.ErrorInfo",
+            details.errorInfo().get().reason(),
+            details.errorInfo().get().domain(),
+            details.errorInfo().get().metadata()));
+  }
 }

databricks-sdk-java/src/main/java/com/databricks/sdk/core/error/details/BadRequest.java

@@ -0,0 +1,192 @@
+package com.databricks.sdk.core.error.details;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.google.auto.value.AutoValue;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * BadRequest describes violations in a client request. This error type focuses on the syntactic
+ * aspects of the request.
+ *
+ * <p>BadRequest errors occur when the request format, structure, or content does not meet the
+ * service's requirements. This is different from business logic errors or system failures - it
+ * specifically indicates that the client sent a malformed or invalid request.
+ *
+ * <p>Examples of bad request violations might include:
+ *
+ * <ul>
+ *   <li>Missing required fields
+ *   <li>Invalid field values (wrong type, format, or range)
+ *   <li>Malformed JSON or XML
+ *   <li>Unsupported field combinations
+ *   <li>Invalid enum values
+ *   <li>Field length or size violations
+ * </ul>
+ *
+ * <p>This information helps clients:
+ *
+ * <ul>
+ *   <li>Identify what's wrong with their request
+ *   <li>Fix the request format before retrying
+ *   <li>Understand the service's input requirements
+ *   <li>Implement proper input validation
+ * </ul>
+ */
+@AutoValue
+@JsonDeserialize(builder = AutoValue_BadRequest.Builder.class)
+@JsonIgnoreProperties(ignoreUnknown = true)
+public abstract class BadRequest {
+
+  /**
+   * Describes all field violations in the request.
+   *
+   * <p>This list contains details about each specific field or aspect of the request that violated
+   * the service's requirements. Multiple violations can occur if the request has multiple problems.
+   *
+   * @return the list of field violations
+   */
+  @JsonProperty("field_violations")
+  public abstract List<BadRequestFieldViolation> fieldViolations();
+
+  /**
+   * Creates a new builder for constructing BadRequest instances.
+   *
+   * @return a new builder instance
+   */
+  public static Builder builder() {
+    return new AutoValue_BadRequest.Builder();
+  }
+
+  /** Builder for constructing BadRequest instances. */
+  @AutoValue.Builder
+  @JsonIgnoreProperties(ignoreUnknown = true)
+  public abstract static class Builder {
+
+    /**
+     * Sets the field violations.
+     *
+     * @param fieldViolations the list of field violations
+     * @return this builder for method chaining
+     */
+    @JsonProperty("field_violations")
+    public abstract Builder setFieldViolations(List<BadRequestFieldViolation> fieldViolations);
+
+    /**
+     * Builds the BadRequest instance.
+     *
+     * @return a new BadRequest instance
+     */
+    public BadRequest build() {
+      if (fieldViolations() == null) {
+        setFieldViolations(Collections.emptyList());
+      }
+      return autoBuild();
+    }
+
+    abstract List<BadRequestFieldViolation> fieldViolations();
+
+    abstract BadRequest autoBuild();
+  }
+
+  /**
+   * BadRequestFieldViolation describes a specific field violation in a request.
+   *
+   * <p>Each violation provides details about what specific field or aspect of the request was
+   * invalid and how the client can fix it.
+   */
+  @AutoValue
+  @JsonDeserialize(builder = AutoValue_BadRequest_BadRequestFieldViolation.Builder.class)
+  @JsonIgnoreProperties(ignoreUnknown = true)
+  public abstract static class BadRequestFieldViolation {
+
+    /**
+     * A path leading to a field in the request body.
+     *
+     * <p>This field identifies the specific location of the violation within the request structure.
+     * The path format depends on the request format but typically follows a hierarchical structure.
+     *
+     * <p>Examples of field paths:
+     *
+     * <ul>
+     *   <li>"name" - top-level field
+     *   <li>"user.email" - nested field
+     *   <li>"items[0].id" - array element field
+     *   <li>"metadata.api_key" - deeply nested field
+     *   <li>"settings.notifications.enabled" - multi-level nested field
+     * </ul>
+     *
+     * <p>This path helps clients quickly locate and fix the problematic field in their request.
+     *
+     * @return the path to the violating field
+     */
+    @JsonProperty("field")
+    public abstract String field();
+
+    /**
+     * A description of why the request element is bad.
+     *
+     * <p>This field provides a human-readable explanation of what's wrong with the field and how to
+     * fix it. The description should be clear enough for developers to understand and resolve the
+     * issue.
+     *
+     * <p>Examples of field violation descriptions:
+     *
+     * <ul>
+     *   <li>"Field is required and cannot be empty"
+     *   <li>"Value must be a positive integer"
+     *   <li>"Invalid email format"
+     *   <li>"String length must be between 1 and 100 characters"
+     *   <li>"Unsupported enum value. Must be one of: [A, B, C]"
+     *   <li>"Field cannot contain special characters"
+     *   <li>"Date must be in ISO 8601 format (YYYY-MM-DD)"
+     * </ul>
+     *
+     * @return description of why the field is invalid
+     */
+    @JsonProperty("description")
+    public abstract String description();
+
+    /**
+     * Creates a new builder for constructing BadRequestFieldViolation instances.
+     *
+     * @return a new builder instance
+     */
+    public static Builder builder() {
+      return new AutoValue_BadRequest_BadRequestFieldViolation.Builder();
+    }
+
+    /** Builder for constructing BadRequestFieldViolation instances. */
+    @AutoValue.Builder
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public abstract static class Builder {
+
+      /**
+       * Sets the field path.
+       *
+       * @param field the path to the violating field
+       * @return this builder for method chaining
+       */
+      @JsonProperty("field")
+      public abstract Builder setField(String field);
+
+      /**
+       * Sets the violation description.
+       *
+       * @param description description of why the field is invalid
+       * @return this builder for method chaining
+       */
+      @JsonProperty("description")
+      public abstract Builder setDescription(String description);
+
+      /**
+       * Builds the BadRequestFieldViolation instance.
+       *
+       * @return a new BadRequestFieldViolation instance
+       */
+      public abstract BadRequestFieldViolation build();
+    }
+  }
+}