Update SDK API to 9b38571bfe7bf0bc595480f28eb93a8db3116985 (#606)

This PR updates the SDK to the latest API changes.

NO_CHANGELOG=true

Co-authored-by: databricks-ci-ghec-1[bot] <184311507+databricks-ci-ghec-1[bot]@users.noreply.github.com>

Author: databricks-ci-ghec-1[bot]

.codegen/_openapi_sha

@@ -1 +1 @@
-f21f4933da405cac4bc77c9732044dc45b4f0c5a
+9b38571bfe7bf0bc595480f28eb93a8db3116985

NEXT_CHANGELOG.md

@@ -15,4 +15,4 @@
 ### API Changes
 * Add `TABLE_DELTASHARING_OPEN_DIR_BASED` enum value for `com.databricks.sdk.service.catalog.SecurableKind`.
 * Add `CREATING` and `CREATE_FAILED` enum values for `com.databricks.sdk.service.settings.NccPrivateEndpointRulePrivateLinkConnectionState`.
-* [Breaking] Remove `accessModes` and `storageLocation` fields for `com.databricks.sdk.service.sharing.Table`.
+* [Breaking] Remove `accessModes` and `storageLocation` fields for `com.databricks.sdk.service.sharing.Table`.

databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/SecurableKind.java

@@ -4,7 +4,7 @@
 
 import com.databricks.sdk.support.Generated;
 
-/** Latest kind: TABLE_DELTASHARING_OPEN_DIR_BASED = 290; Next id:291 */
+/** Latest kind: CONNECTION_WORKDAY_HCM_USERNAME_PASSWORD = 292; Next id: 293 */
 @Generated
 public enum SecurableKind {
   TABLE_DB_STORAGE,

databricks-sdk-java/src/main/java/com/databricks/sdk/service/jobs/JobsAPI.java

@@ -300,6 +300,12 @@ public JobPermissions setPermissions(JobPermissionsRequest request) {
    * Submit a one-time run. This endpoint allows you to submit a workload directly without creating
    * a job. Runs submitted using this endpoint don’t display in the UI. Use the `jobs/runs/get` API
    * to check the run state after the job is submitted.
+   *
+   * <p>**Important:** Jobs submitted using this endpoint are not saved as a job. They do not show
+   * up in the Jobs UI, and do not retry when they fail. Because they are not saved, Databricks
+   * cannot auto-optimize serverless compute in case of failure. If your job fails, you may want to
+   * use classic compute to specify the compute needs for the job. Alternatively, use the `POST
+   * /jobs/create` and `POST /jobs/run-now` endpoints to create and run a saved job.
    */
   public Wait<Run, SubmitRunResponse> submit(SubmitRun request) {
     SubmitRunResponse response = impl.submit(request);

databricks-sdk-java/src/main/java/com/databricks/sdk/service/jobs/JobsService.java

@@ -129,6 +129,12 @@ GetJobPermissionLevelsResponse getPermissionLevels(
    * Submit a one-time run. This endpoint allows you to submit a workload directly without creating
    * a job. Runs submitted using this endpoint don’t display in the UI. Use the `jobs/runs/get` API
    * to check the run state after the job is submitted.
+   *
+   * <p>**Important:** Jobs submitted using this endpoint are not saved as a job. They do not show
+   * up in the Jobs UI, and do not retry when they fail. Because they are not saved, Databricks
+   * cannot auto-optimize serverless compute in case of failure. If your job fails, you may want to
+   * use classic compute to specify the compute needs for the job. Alternatively, use the `POST
+   * /jobs/create` and `POST /jobs/run-now` endpoints to create and run a saved job.
    */
   SubmitRunResponse submit(SubmitRun submitRun);
 

databricks-sdk-java/src/main/java/com/databricks/sdk/service/settings/NccPrivateEndpointRule.java

@@ -26,7 +26,10 @@ public class NccPrivateEndpointRule {
    * and is ready to use in your serverless compute resources. - REJECTED: Connection was rejected
    * by the private link resource owner. - DISCONNECTED: Connection was removed by the private link
    * resource owner, the private endpoint becomes informative and should be deleted for clean-up. -
-   * EXPIRED: If the endpoint was created but not approved in 14 days, it will be EXPIRED.
+   * EXPIRED: If the endpoint was created but not approved in 14 days, it will be EXPIRED. -
+   * CREATING: The endpoint creation is in progress. Once successfully created, the state will
+   * transition to PENDING. - CREATE_FAILED: The endpoint creation failed. You can check the
+   * error_message field for more details.
    */
   @JsonProperty("connection_state")
   private NccPrivateEndpointRulePrivateLinkConnectionState connectionState;

databricks-sdk-java/src/main/java/com/databricks/sdk/service/sharing/ProvidersAPI.java

@@ -61,8 +61,10 @@ public ProviderInfo get(GetProviderRequest request) {
 
   /**
    * Gets an array of available authentication providers. The caller must either be a metastore
-   * admin or the owner of the providers. Providers not owned by the caller are not included in the
-   * response. There is no guarantee of a specific ordering of the elements in the array.
+   * admin, have the **USE_PROVIDER** privilege on the providers, or be the owner of the providers.
+   * Providers not owned by the caller and for which the caller does not have the **USE_PROVIDER**
+   * privilege are not included in the response. There is no guarantee of a specific ordering of the
+   * elements in the array.
    */
   public Iterable<ProviderInfo> list(ListProvidersRequest request) {
 

databricks-sdk-java/src/main/java/com/databricks/sdk/service/sharing/ProvidersService.java

@@ -33,8 +33,10 @@ public interface ProvidersService {
 
   /**
    * Gets an array of available authentication providers. The caller must either be a metastore
-   * admin or the owner of the providers. Providers not owned by the caller are not included in the
-   * response. There is no guarantee of a specific ordering of the elements in the array.
+   * admin, have the **USE_PROVIDER** privilege on the providers, or be the owner of the providers.
+   * Providers not owned by the caller and for which the caller does not have the **USE_PROVIDER**
+   * privilege are not included in the response. There is no guarantee of a specific ordering of the
+   * elements in the array.
    */
   ListProvidersResponse list(ListProvidersRequest listProvidersRequest);