From 21ea9e0de7c65116da8686122a6c5dd1caa8ed73 Mon Sep 17 00:00:00 2001 From: "databricks-ci-ghec-1[bot]" <184311507+databricks-ci-ghec-1[bot]@users.noreply.github.com> Date: Tue, 22 Sep 2026 04:44:14 +0000 Subject: [PATCH] Update SDK to d17c0e60047be7ab12fafbb2c8b865c0348e10c4 --- .codegen/_openapi_sha | 2 +- NEXT_CHANGELOG.md | 5 +++++ service/apps/model.go | 21 +++++++++++---------- service/bundledeployments/model.go | 8 +++----- service/cleanrooms/model.go | 6 +++--- service/jobs/model.go | 21 +++++++++++++++++++++ service/ml/model.go | 26 ++++++++++++++++++++++++++ service/oauth2/model.go | 4 +++- service/pipelines/model.go | 4 ++-- service/tags/model.go | 10 +++++----- 10 files changed, 80 insertions(+), 27 deletions(-) diff --git a/.codegen/_openapi_sha b/.codegen/_openapi_sha index 444b180c2..10f358627 100644 --- a/.codegen/_openapi_sha +++ b/.codegen/_openapi_sha @@ -1 +1 @@ -4648d66fa37e7683468dc92cc043c6aa7a34f301 \ No newline at end of file +d17c0e60047be7ab12fafbb2c8b865c0348e10c4 \ No newline at end of file diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md index 984bf5ad2..a317ccfaa 100644 --- a/NEXT_CHANGELOG.md +++ b/NEXT_CHANGELOG.md @@ -13,3 +13,8 @@ ### Internal Changes ### API Changes +* Add `OnMaintenanceComplete` and `OnMaintenanceStart` fields for [jobs.JobEmailNotifications](https://pkg.go.dev/github.com/databricks/databricks-sdk-go/service/jobs#JobEmailNotifications). +* Add `OnMaintenanceComplete` and `OnMaintenanceStart` fields for [jobs.TaskEmailNotifications](https://pkg.go.dev/github.com/databricks/databricks-sdk-go/service/jobs#TaskEmailNotifications). +* Add `OnMaintenanceComplete` and `OnMaintenanceStart` fields for [jobs.WebhookNotifications](https://pkg.go.dev/github.com/databricks/databricks-sdk-go/service/jobs#WebhookNotifications). +* Add `BudgetPolicyId` and `Tags` fields for [ml.BackfillFeaturesRequest](https://pkg.go.dev/github.com/databricks/databricks-sdk-go/service/ml#BackfillFeaturesRequest). +* Add `BudgetPolicyId` and `Tags` fields for [ml.PurgeFeatureEntitiesRequest](https://pkg.go.dev/github.com/databricks/databricks-sdk-go/service/ml#PurgeFeatureEntitiesRequest). \ No newline at end of file diff --git a/service/apps/model.go b/service/apps/model.go index 5b4f40b3f..57ccc95bf 100644 --- a/service/apps/model.go +++ b/service/apps/model.go @@ -19,11 +19,11 @@ type App struct { AppStatus *ApplicationStatus `json:"app_status,omitempty"` BudgetPolicyId string `json:"budget_policy_id,omitempty"` - // Maximum number of app instances. Must be set together with - // `compute_min_instances`. + // Maximum number of app instances the app is configured to run. Must be set + // together with `compute_min_instances`. ComputeMaxInstances int `json:"compute_max_instances,omitempty"` - // Minimum number of app instances. Must be set together with - // `compute_max_instances`. + // Minimum number of app instances the app is configured to run. Must be set + // together with `compute_max_instances`. ComputeMinInstances int `json:"compute_min_instances,omitempty"` ComputeSize ComputeSize `json:"compute_size,omitempty"` @@ -1454,11 +1454,11 @@ func (s AppThumbnail) MarshalJSON() ([]byte, error) { type AppUpdate struct { BudgetPolicyId string `json:"budget_policy_id,omitempty"` - // Maximum number of app instances. Must be set together with - // `compute_min_instances`. + // Maximum number of app instances the app is configured to run. Must be set + // together with `compute_min_instances`. ComputeMaxInstances int `json:"compute_max_instances,omitempty"` - // Minimum number of app instances. Must be set together with - // `compute_max_instances`. + // Minimum number of app instances the app is configured to run. Must be set + // together with `compute_max_instances`. ComputeMinInstances int `json:"compute_min_instances,omitempty"` ComputeSize ComputeSize `json:"compute_size,omitempty"` @@ -1596,7 +1596,7 @@ func (f *ApplicationState) Type() string { type ApplicationStatus struct { // Application status message Message string `json:"message,omitempty"` - // The number of running instances of this application. + // The number of app instances whose application process is running. RunningInstances int `json:"running_instances,omitempty"` // State of the application. State ApplicationState `json:"state,omitempty"` @@ -1727,7 +1727,8 @@ func (f *ComputeState) Type() string { } type ComputeStatus struct { - // The number of compute instances used and billed for this application. + // The number of active compute instances currently used and billed for this + // application. ActiveInstances int `json:"active_instances,omitempty"` // Compute status message Message string `json:"message,omitempty"` diff --git a/service/bundledeployments/model.go b/service/bundledeployments/model.go index be57dc230..7a98c1bf2 100644 --- a/service/bundledeployments/model.go +++ b/service/bundledeployments/model.go @@ -12,13 +12,11 @@ import ( // A request to complete a Version. type CompleteVersionRequest struct { - // The reason for completing the version. Must be a terminal reason: - // VERSION_COMPLETE_SUCCESS, VERSION_COMPLETE_FAILURE, or - // VERSION_COMPLETE_FORCE_ABORT. + // The reason for completing the version. Must be VERSION_COMPLETE_SUCCESS + // or VERSION_COMPLETE_FAILURE. CompletionReason VersionComplete `json:"completion_reason"` // If true, force-completes the version even if the caller is not the - // original creator. The completion_reason must be - // VERSION_COMPLETE_FORCE_ABORT when force is true. + // original creator. Force bool `json:"force,omitempty"` // The name of the version to complete. Format: // deployments/{deployment_id}/versions/{version_id} diff --git a/service/cleanrooms/model.go b/service/cleanrooms/model.go index d5bcaec37..8aa71a812 100644 --- a/service/cleanrooms/model.go +++ b/service/cleanrooms/model.go @@ -138,10 +138,10 @@ type CleanRoomAsset struct { // if and only if **asset_type** is **TABLE** or **STREAMING_TABLE** TableLocalDetails *CleanRoomAssetTableLocalDetails `json:"table_local_details,omitempty"` // View details available to all collaborators of the clean room. Present if - // and only if **asset_type** is **VIEW** + // and only if **asset_type** is **VIEW** or **METRIC_VIEW** View *CleanRoomAssetView `json:"view,omitempty"` // Local details for a view that are only available to its owner. Present if - // and only if **asset_type** is **VIEW** + // and only if **asset_type** is **VIEW** or **METRIC_VIEW** ViewLocalDetails *CleanRoomAssetViewLocalDetails `json:"view_local_details,omitempty"` // Local details for a volume that are only available to its owner. Present // if and only if **asset_type** is **VOLUME** @@ -235,7 +235,7 @@ type CleanRoomAssetJarAnalysis struct { // Optional description of the jar analysis shown to all collaborators. Description string `json:"description,omitempty"` // The serverless environment version used to execute the JAR analysis (e.g. - // "4"). Defaults to "4-scala-preview" if not specified. + // "4"). If not specified, uses the service-configured JAR analysis default. EnvironmentVersion string `json:"environment_version,omitempty"` // Server generated etag that represents the jar analysis version. Etag string `json:"etag,omitempty"` diff --git a/service/jobs/model.go b/service/jobs/model.go index df61f3aa3..e7b31bf21 100644 --- a/service/jobs/model.go +++ b/service/jobs/model.go @@ -2478,6 +2478,12 @@ type JobEmailNotifications struct { // `TIMED_OUT` result_state. If this is not specified on job creation, // reset, or update the list is empty, and notifications are not sent. OnFailure []string `json:"on_failure,omitempty"` + // A list of email addresses to notify when platform-initiated maintenance + // completes for a continuous job. + OnMaintenanceComplete []string `json:"on_maintenance_complete,omitempty"` + // A list of email addresses to notify when platform-initiated maintenance + // starts for a continuous job. + OnMaintenanceStart []string `json:"on_maintenance_start,omitempty"` // A list of email addresses to be notified when a run begins. If not // specified on job creation, reset, or update, the list is empty, and // notifications are not sent. @@ -6653,6 +6659,12 @@ type TaskEmailNotifications struct { // `TIMED_OUT` result_state. If this is not specified on job creation, // reset, or update the list is empty, and notifications are not sent. OnFailure []string `json:"on_failure,omitempty"` + // A list of email addresses to notify when platform-initiated maintenance + // completes for a continuous job. + OnMaintenanceComplete []string `json:"on_maintenance_complete,omitempty"` + // A list of email addresses to notify when platform-initiated maintenance + // starts for a continuous job. + OnMaintenanceStart []string `json:"on_maintenance_start,omitempty"` // A list of email addresses to be notified when a run begins. If not // specified on job creation, reset, or update, the list is empty, and // notifications are not sent. @@ -7400,6 +7412,15 @@ type WebhookNotifications struct { // An optional list of system notification IDs to call when the run fails. A // maximum of 3 destinations can be specified for the `on_failure` property. OnFailure []Webhook `json:"on_failure,omitempty"` + // An optional list of system notification IDs to call when + // platform-initiated maintenance completes for a continuous job. A maximum + // of 3 destinations can be specified for the `on_maintenance_complete` + // property. + OnMaintenanceComplete []Webhook `json:"on_maintenance_complete,omitempty"` + // An optional list of system notification IDs to call when + // platform-initiated maintenance starts for a continuous job. A maximum of + // 3 destinations can be specified for the `on_maintenance_start` property. + OnMaintenanceStart []Webhook `json:"on_maintenance_start,omitempty"` // An optional list of system notification IDs to call when the run starts. // A maximum of 3 destinations can be specified for the `on_start` property. OnStart []Webhook `json:"on_start,omitempty"` diff --git a/service/ml/model.go b/service/ml/model.go index f8c33cdd6..35ca1d520 100644 --- a/service/ml/model.go +++ b/service/ml/model.go @@ -364,10 +364,23 @@ func (s *AvgFunction) UnmarshalJSON(b []byte) error { type BackfillFeaturesRequest struct { // Output ranges to backfill. BackfillRanges []BackfillRange `json:"backfill_ranges"` + // The budget policy ID, in UUID format, used to attribute the serverless + // compute cost of this backfill. If not specified, a default budget policy + // may be applied. + BudgetPolicyId string `json:"budget_policy_id,omitempty"` // Full names of the features to backfill. FeatureFullNames []string `json:"feature_full_names"` // Idempotency token for the request. RequestId string `json:"request_id,omitempty"` + // Custom tags to associate with this backfill. They are applied to the + // backfill job and forwarded to the underlying compute as Databricks + // resource tags, so backfill cost can be attributed in the billing system + // tables. These tags apply only to the backfill compute; they are not + // applied to the Unity Catalog Feature resources themselves, whose tags are + // managed separately through the Unity Catalog tagging API. A maximum of 25 + // tags is supported; keys and values are subject to the same limitations as + // Databricks resource tags. + Tags map[string]string `json:"tags,omitempty"` ForceSendFields []string `json:"-" url:"-"` } @@ -4928,6 +4941,10 @@ func (f *PurgeFeatureEntitiesMetadataState) Type() string { // Request to purge materialized feature values for entities listed in a Unity // Catalog Delta table. type PurgeFeatureEntitiesRequest struct { + // The budget policy ID, in UUID format, used to attribute the serverless + // compute cost of this purge. If not specified, a default budget policy may + // be applied. + BudgetPolicyId string `json:"budget_policy_id,omitempty"` // Fully qualified name of the Unity Catalog Delta table containing the // entity keys to purge. The table may contain a subset of each feature's // entity-key columns. A partial key match deletes all feature rows matching @@ -4941,6 +4958,15 @@ type PurgeFeatureEntitiesRequest struct { Features []string `json:"features"` // Optional UUID4 idempotency token for the request. RequestId string `json:"request_id,omitempty"` + // Custom tags to associate with this purge. They are applied to the purge + // job and forwarded to the underlying compute as Databricks resource tags, + // so purge cost can be attributed in the billing system tables. These tags + // apply only to the purge compute; they are not applied to the Unity + // Catalog Feature resources themselves, whose tags are managed separately + // through the Unity Catalog tagging API. A maximum of 25 tags is supported; + // keys and values are subject to the same limitations as Databricks + // resource tags. + Tags map[string]string `json:"tags,omitempty"` ForceSendFields []string `json:"-" url:"-"` } diff --git a/service/oauth2/model.go b/service/oauth2/model.go index 683972616..efce5a8ed 100644 --- a/service/oauth2/model.go +++ b/service/oauth2/model.go @@ -232,7 +232,9 @@ type FederationPolicy struct { // which does not need to be specified in create or update requests. If // specified in a request, must match the value in the request URL. Name string `json:"name,omitempty"` - + // audit_mode INCLUDE is required on both this message field and its leaf + // fields so the OIDC policy configuration is captured in create/update + // audit logs (see go/auditlogs). OidcPolicy *OidcFederationPolicy `json:"oidc_policy,omitempty"` // The ID of the federation policy. Output only. PolicyId string `json:"policy_id,omitempty"` diff --git a/service/pipelines/model.go b/service/pipelines/model.go index 74887e324..aad4f3dc0 100644 --- a/service/pipelines/model.go +++ b/service/pipelines/model.go @@ -68,7 +68,7 @@ func (s AutoFullRefreshPolicy) MarshalJSON() ([]byte, error) { type AvroTransformerOptions struct { // (Optional) Parse mode for Avro data. Valid values: FAILFAST, PERMISSIVE. - // Defaults to FAILFAST. + // Defaults to PERMISSIVE. ParseMode ParseMode `json:"parse_mode,omitempty"` // Inline Avro JSON schema string. Schema string `json:"schema,omitempty"` @@ -3194,7 +3194,7 @@ type ProtobufTransformerOptions struct { // Required: fully-qualified message type name. MessageName string `json:"message_name,omitempty"` // (Optional) Parse mode for Protobuf data. Valid values: FAILFAST, - // PERMISSIVE. Defaults to FAILFAST. + // PERMISSIVE. Defaults to PERMISSIVE. ParseMode ParseMode `json:"parse_mode,omitempty"` // (Optional) Maximum expansion depth for recursive protobuf fields. Spark // SQL does not natively support recursive types, so recursive fields are diff --git a/service/tags/model.go b/service/tags/model.go index 494b4a27f..64d79b850 100644 --- a/service/tags/model.go +++ b/service/tags/model.go @@ -27,7 +27,7 @@ type DeleteTagAssignmentRequest struct { // entity_id is the app name EntityId string `json:"-" url:"-"` // The type of entity to which the tag is assigned. Allowed values are apps, - // dashboards, designerfiles, geniespaces, notebooks + // dashboards, designer-files, geniespaces, notebooks EntityType string `json:"-" url:"-"` // The key of the tag. The characters , . : / - = and leading/trailing // spaces are not allowed @@ -51,7 +51,7 @@ type GetTagAssignmentRequest struct { // entity_id is the app name EntityId string `json:"-" url:"-"` // The type of entity to which the tag is assigned. Allowed values are apps, - // dashboards, designerfiles, geniespaces, notebooks + // dashboards, designer-files, geniespaces, notebooks EntityType string `json:"-" url:"-"` // The key of the tag. The characters , . : / - = and leading/trailing // spaces are not allowed @@ -75,7 +75,7 @@ type ListTagAssignmentsRequest struct { // entity_id is the app name EntityId string `json:"-" url:"-"` // The type of entity to which the tag is assigned. Allowed values are apps, - // dashboards, designerfiles, geniespaces, notebooks + // dashboards, designer-files, geniespaces, notebooks EntityType string `json:"-" url:"-"` // Optional. Maximum number of tag assignments to return in a single page PageSize int `json:"-" url:"page_size,omitempty"` @@ -152,7 +152,7 @@ type TagAssignment struct { // entity_id is the app name EntityId string `json:"entity_id"` // The type of entity to which the tag is assigned. Allowed values are apps, - // dashboards, designerfiles, geniespaces, notebooks + // dashboards, designer-files, geniespaces, notebooks EntityType string `json:"entity_type"` // The key of the tag. The characters , . : / - = and leading/trailing // spaces are not allowed @@ -201,7 +201,7 @@ type UpdateTagAssignmentRequest struct { // entity_id is the app name EntityId string `json:"-" url:"-"` // The type of entity to which the tag is assigned. Allowed values are apps, - // dashboards, designerfiles, geniespaces, notebooks + // dashboards, designer-files, geniespaces, notebooks EntityType string `json:"-" url:"-"` TagAssignment TagAssignment `json:"tag_assignment"`