Budget

View as Markdown

Get budgetGET /api/2.1/accounts/{account_id}/budgets/{budget_id}Get all budgetsGET /api/2.1/accounts/{account_id}/budgetsCreate new budgetPOST /api/2.1/accounts/{account_id}/budgetsModify budgetPUT /api/2.1/accounts/{account_id}/budgets/{budget_id}Delete budgetDELETE /api/2.1/accounts/{account_id}/budgets/{budget_id}

BudgetConfiguration object

budget_configuration_idstringuuid

<Databricks> budget configuration ID.

account_idstringuuid

<Databricks> account ID.

create_timeint64

Creation time of this budget configuration.

update_timeint64

Update time of this budget configuration.

alert_configurationsarray of object

Alerts to configure when this budget is in a triggered state. Budgets must have at least one alert configuration. A budget can have up to four shared alerts per time period, each with a unique quantity_threshold. Budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY can also use per-user alerts, with optional principal_overrides. These budgets can have at most one per-user alert per time period, and can use shared alerts, a per-user alert, or both. The BLOCK_USAGE action is only supported on budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. At most one shared alert per time period can have a BLOCK_USAGE action, and it must be the shared alert with the highest threshold in that period.

Show child attributesHide child attributes

alert_configuration_idstringuuid

<Databricks> alert configuration ID.

time_periodstring

The time window of usage data for the budget.

Values:

• MONTH

trigger_typestring

The evaluation method to determine when this budget alert is in a triggered state.

Values:

• CUMULATIVE_SPENDING_EXCEEDED

quantity_typestring

The way to calculate cost for this budget alert. This is what quantity_threshold is measured in.

Values:

• LIST_PRICE_DOLLARS_USD

quantity_thresholdstring

The threshold for the budget alert to determine if it is in a triggered state. The number is evaluated based on quantity_type.

action_configurationsarray of object

Configured actions for this alert. These define what happens when an alert enters a triggered state.

Show child attributesHide child attributes

action_configuration_idstringuuid

<Databricks> action configuration ID.

action_typestring

The type of the action.

Values:

• EMAIL_NOTIFICATION
• BLOCK_USAGE Beta

targetstring

Target for the action. For example, an email address.

scope_typestringBeta

How the alert threshold is evaluated. Determines whether spend is tracked in aggregate or per individual user.

Values:

• ALERT_CONFIGURATION_SCOPE_TYPE_SHARED
• ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER

principal_overridesarray of objectBeta

Per-principal threshold overrides for this alert. Only applies to per-user alerts (scope_type = ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER); ignored for shared alerts.

Show child attributesHide child attributes

principal_idint64Beta

Account-level principal id (user, group, or service principal).

override_thresholdstringBeta

Dollar amount that overrides the parent alert's quantity_threshold for this principal.

filterobject

Configured filters for this budget. These are applied to your account's usage to limit the scope of what is considered for this budget. Leave empty to include all usage for this account. All provided filters must be matched for usage to be included.

Show child attributesHide child attributes

workspace_idobject

If provided, usage must match with the provided <Databricks> workspace IDs.

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of int64

tagsarray of object

A list of tag keys and values that will limit the budget to usage that includes those specific custom tags. Tags are case-sensitive and should be entered exactly as they appear in your usage data.

Show child attributesHide child attributes

keystring

valueobject

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of string

display_namestring

Human-readable name of budget configuration. Max Length: 128

include_external_spendbooleanBeta

Whether this budget tracks external pass-through spend (third-party costs billed through a <Databricks> product) in addition to internal <Databricks> spend. Only applicable to Unity Gateway budgets, i.e. when resource_type is BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. This field is immutable after create.

resource_typestringBeta

The resource scope for this budget. Determines whether the budget tracks all resources or a specific resource.

Values:

• BUDGET_RESOURCE_TYPE_ALL_RESOURCES
• BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY

View as Markdown

The BudgetConfiguration object

{
  "budget_configuration_id": "string",
  "account_id": "string",
  "create_time": 0,
  "update_time": 0,
  "alert_configurations": [
    {
      "alert_configuration_id": "string",
      "time_period": "MONTH",
      "trigger_type": "CUMULATIVE_SPENDING_EXCEEDED",
      "quantity_type": "LIST_PRICE_DOLLARS_USD",
      "quantity_threshold": "string",
      "action_configurations": [
        {}
      ],
      "scope_type": "ALERT_CONFIGURATION_SCOPE_TYPE_SHARED",
      "principal_overrides": [
        {}
      ]
    }
  ],
  "filter": {
    "workspace_id": {},
    "tags": [
      {}
    ]
  },
  "display_name": "string",
  "include_external_spend": true,
  "resource_type": "BUDGET_RESOURCE_TYPE_ALL_RESOURCES"
}

Get budget GA

GET /api/2.1/accounts/{account_id}/budgets/{budget_id}

Gets a budget configuration for an account. Both account and budget configuration are specified by ID.

API scopes: billing

Parameters

account_idstringuuidRequiredpath

<Databricks> account ID.

budget_idstringuuidRequiredpath

The budget configuration ID

Response

budgetobject

Show child attributesHide child attributes

budget_configuration_idstringuuid

<Databricks> budget configuration ID.

account_idstringuuid

<Databricks> account ID.

create_timeint64

Creation time of this budget configuration.

update_timeint64

Update time of this budget configuration.

alert_configurationsarray of object

Alerts to configure when this budget is in a triggered state. Budgets must have at least one alert configuration. A budget can have up to four shared alerts per time period, each with a unique quantity_threshold. Budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY can also use per-user alerts, with optional principal_overrides. These budgets can have at most one per-user alert per time period, and can use shared alerts, a per-user alert, or both. The BLOCK_USAGE action is only supported on budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. At most one shared alert per time period can have a BLOCK_USAGE action, and it must be the shared alert with the highest threshold in that period.

Show child attributesHide child attributes

alert_configuration_idstringuuid

<Databricks> alert configuration ID.

time_periodstring

The time window of usage data for the budget.

Values:

• MONTH

trigger_typestring

The evaluation method to determine when this budget alert is in a triggered state.

Values:

• CUMULATIVE_SPENDING_EXCEEDED

quantity_typestring

The way to calculate cost for this budget alert. This is what quantity_threshold is measured in.

Values:

• LIST_PRICE_DOLLARS_USD

quantity_thresholdstring

The threshold for the budget alert to determine if it is in a triggered state. The number is evaluated based on quantity_type.

action_configurationsarray of object

Configured actions for this alert. These define what happens when an alert enters a triggered state.

Show child attributesHide child attributes

action_configuration_idstringuuid

<Databricks> action configuration ID.

action_typestring

The type of the action.

Values:

• EMAIL_NOTIFICATION
• BLOCK_USAGE Beta

targetstring

Target for the action. For example, an email address.

scope_typestringBeta

How the alert threshold is evaluated. Determines whether spend is tracked in aggregate or per individual user.

Values:

• ALERT_CONFIGURATION_SCOPE_TYPE_SHARED
• ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER

principal_overridesarray of objectBeta

Per-principal threshold overrides for this alert. Only applies to per-user alerts (scope_type = ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER); ignored for shared alerts.

Show child attributesHide child attributes

principal_idint64Beta

Account-level principal id (user, group, or service principal).

override_thresholdstringBeta

Dollar amount that overrides the parent alert's quantity_threshold for this principal.

filterobject

Configured filters for this budget. These are applied to your account's usage to limit the scope of what is considered for this budget. Leave empty to include all usage for this account. All provided filters must be matched for usage to be included.

Show child attributesHide child attributes

workspace_idobject

If provided, usage must match with the provided <Databricks> workspace IDs.

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of int64

tagsarray of object

A list of tag keys and values that will limit the budget to usage that includes those specific custom tags. Tags are case-sensitive and should be entered exactly as they appear in your usage data.

Show child attributesHide child attributes

keystring

valueobject

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of string

display_namestring

Human-readable name of budget configuration. Max Length: 128

include_external_spendbooleanBeta

Whether this budget tracks external pass-through spend (third-party costs billed through a <Databricks> product) in addition to internal <Databricks> spend. Only applicable to Unity Gateway budgets, i.e. when resource_type is BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. This field is immutable after create.

resource_typestringBeta

The resource scope for this budget. Determines whether the budget tracks all resources or a specific resource.

Values:

• BUDGET_RESOURCE_TYPE_ALL_RESOURCES
• BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY

View as Markdown

Response

{
  "budget": {
    "budget_configuration_id": "string",
    "account_id": "string",
    "create_time": 0,
    "update_time": 0,
    "alert_configurations": [
      {}
    ],
    "filter": {},
    "display_name": "string",
    "include_external_spend": true,
    "resource_type": "BUDGET_RESOURCE_TYPE_ALL_RESOURCES"
  }
}

Get all budgets GA

GET /api/2.1/accounts/{account_id}/budgets

Gets all budgets associated with this account.

API scopes: billing

Parameters

account_idstringuuidRequiredpath

<Databricks> account ID.

page_tokenstringquery

A page token received from a previous get all budget configurations call. This token can be used to retrieve the subsequent page. Requests first page if absent.

Response

Returns a list of BudgetConfiguration objects.

View as Markdown

Response

{
  "budgets": [
    {
      "budget_configuration_id": "string",
      "account_id": "string",
      "create_time": 0,
      "update_time": 0,
      "alert_configurations": [
        {}
      ],
      "filter": {},
      "display_name": "string",
      "include_external_spend": true,
      "resource_type": "BUDGET_RESOURCE_TYPE_ALL_RESOURCES"
    }
  ],
  "next_page_token": "string"
}

Create new budget GA

POST /api/2.1/accounts/{account_id}/budgets

Create a new budget configuration for an account. For full details, see https://docs.databricks.com/en/admin/account-settings/budgets.html.

API scopes: billing

Parameters

account_idstringuuidRequiredpath

<Databricks> account ID.

Request body

budgetobjectRequired

Properties of the new budget configuration.

Show child attributesHide child attributes

alert_configurationsarray of object

Alerts to configure when this budget is in a triggered state. Budgets must have at least one alert configuration. A budget can have up to four shared alerts per time period, each with a unique quantity_threshold. Budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY can also use per-user alerts, with optional principal_overrides. These budgets can have at most one per-user alert per time period, and can use shared alerts, a per-user alert, or both. The BLOCK_USAGE action is only supported on budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. At most one shared alert per time period can have a BLOCK_USAGE action, and it must be the shared alert with the highest threshold in that period.

Show child attributesHide child attributes

time_periodstring

The time window of usage data for the budget.

Values:

• MONTH

trigger_typestring

The evaluation method to determine when this budget alert is in a triggered state.

Values:

• CUMULATIVE_SPENDING_EXCEEDED

quantity_typestring

The way to calculate cost for this budget alert. This is what quantity_threshold is measured in.

Values:

• LIST_PRICE_DOLLARS_USD

quantity_thresholdstring

The threshold for the budget alert to determine if it is in a triggered state. The number is evaluated based on quantity_type.

action_configurationsarray of object

Configured actions for this alert. These define what happens when an alert enters a triggered state.

Show child attributesHide child attributes

action_typestring

The type of the action.

Values:

• EMAIL_NOTIFICATION
• BLOCK_USAGE Beta

targetstring

Target for the action. For example, an email address.

scope_typestringBeta

How the alert threshold is evaluated. Determines whether spend is tracked in aggregate or per individual user.

Values:

• ALERT_CONFIGURATION_SCOPE_TYPE_SHARED
• ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER

principal_overridesarray of objectBeta

Per-principal threshold overrides for this alert. Only applies to per-user alerts (scope_type = ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER); ignored for shared alerts.

Show child attributesHide child attributes

principal_idint64Beta

Account-level principal id (user, group, or service principal).

override_thresholdstringBeta

Dollar amount that overrides the parent alert's quantity_threshold for this principal.

filterobject

Configured filters for this budget. These are applied to your account's usage to limit the scope of what is considered for this budget. Leave empty to include all usage for this account. All provided filters must be matched for usage to be included.

Show child attributesHide child attributes

workspace_idobject

If provided, usage must match with the provided <Databricks> workspace IDs.

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of int64

tagsarray of object

A list of tag keys and values that will limit the budget to usage that includes those specific custom tags. Tags are case-sensitive and should be entered exactly as they appear in your usage data.

Show child attributesHide child attributes

keystring

valueobject

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of string

display_namestring

Human-readable name of budget configuration. Max Length: 128

include_external_spendbooleanBeta

Whether this budget tracks external pass-through spend (third-party costs billed through a <Databricks> product) in addition to internal <Databricks> spend. Only applicable to Unity Gateway budgets, i.e. when resource_type is BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. This field is immutable after create.

resource_typestringBeta

The resource scope for this budget. Determines whether the budget tracks all resources or a specific resource.

Values:

• BUDGET_RESOURCE_TYPE_ALL_RESOURCES
• BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY

Response

budgetobject

The created budget configuration.

Show child attributesHide child attributes

budget_configuration_idstringuuid

<Databricks> budget configuration ID.

account_idstringuuid

<Databricks> account ID.

create_timeint64

Creation time of this budget configuration.

update_timeint64

Update time of this budget configuration.

alert_configurationsarray of object

Alerts to configure when this budget is in a triggered state. Budgets must have at least one alert configuration. A budget can have up to four shared alerts per time period, each with a unique quantity_threshold. Budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY can also use per-user alerts, with optional principal_overrides. These budgets can have at most one per-user alert per time period, and can use shared alerts, a per-user alert, or both. The BLOCK_USAGE action is only supported on budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. At most one shared alert per time period can have a BLOCK_USAGE action, and it must be the shared alert with the highest threshold in that period.

Show child attributesHide child attributes

alert_configuration_idstringuuid

<Databricks> alert configuration ID.

time_periodstring

The time window of usage data for the budget.

Values:

• MONTH

trigger_typestring

The evaluation method to determine when this budget alert is in a triggered state.

Values:

• CUMULATIVE_SPENDING_EXCEEDED

quantity_typestring

The way to calculate cost for this budget alert. This is what quantity_threshold is measured in.

Values:

• LIST_PRICE_DOLLARS_USD

quantity_thresholdstring

The threshold for the budget alert to determine if it is in a triggered state. The number is evaluated based on quantity_type.

action_configurationsarray of object

Configured actions for this alert. These define what happens when an alert enters a triggered state.

Show child attributesHide child attributes

action_configuration_idstringuuid

<Databricks> action configuration ID.

action_typestring

The type of the action.

Values:

• EMAIL_NOTIFICATION
• BLOCK_USAGE Beta

targetstring

Target for the action. For example, an email address.

scope_typestringBeta

How the alert threshold is evaluated. Determines whether spend is tracked in aggregate or per individual user.

Values:

• ALERT_CONFIGURATION_SCOPE_TYPE_SHARED
• ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER

principal_overridesarray of objectBeta

Per-principal threshold overrides for this alert. Only applies to per-user alerts (scope_type = ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER); ignored for shared alerts.

Show child attributesHide child attributes

principal_idint64Beta

Account-level principal id (user, group, or service principal).

override_thresholdstringBeta

Dollar amount that overrides the parent alert's quantity_threshold for this principal.

filterobject

Configured filters for this budget. These are applied to your account's usage to limit the scope of what is considered for this budget. Leave empty to include all usage for this account. All provided filters must be matched for usage to be included.

Show child attributesHide child attributes

workspace_idobject

If provided, usage must match with the provided <Databricks> workspace IDs.

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of int64

tagsarray of object

A list of tag keys and values that will limit the budget to usage that includes those specific custom tags. Tags are case-sensitive and should be entered exactly as they appear in your usage data.

Show child attributesHide child attributes

keystring

valueobject

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of string

display_namestring

Human-readable name of budget configuration. Max Length: 128

include_external_spendbooleanBeta

Whether this budget tracks external pass-through spend (third-party costs billed through a <Databricks> product) in addition to internal <Databricks> spend. Only applicable to Unity Gateway budgets, i.e. when resource_type is BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. This field is immutable after create.

resource_typestringBeta

The resource scope for this budget. Determines whether the budget tracks all resources or a specific resource.

Values:

• BUDGET_RESOURCE_TYPE_ALL_RESOURCES
• BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY

View as Markdown

Request

{
  "budget": {
    "alert_configurations": [
      {}
    ],
    "filter": {},
    "display_name": "string",
    "include_external_spend": true,
    "resource_type": "BUDGET_RESOURCE_TYPE_ALL_RESOURCES"
  }
}

Response

{
  "budget": {
    "budget_configuration_id": "string",
    "account_id": "string",
    "create_time": 0,
    "update_time": 0,
    "alert_configurations": [
      {}
    ],
    "filter": {},
    "display_name": "string",
    "include_external_spend": true,
    "resource_type": "BUDGET_RESOURCE_TYPE_ALL_RESOURCES"
  }
}

Modify budget GA

PUT /api/2.1/accounts/{account_id}/budgets/{budget_id}

Updates a budget configuration for an account. Both account and budget configuration are specified by ID.

API scopes: billing

Parameters

account_idstringuuidRequiredpath

<Databricks> account ID.

budget_idstringRequiredpath

The <Databricks> budget configuration ID.

Request body

budgetobjectRequired

The updated budget. This will overwrite the budget specified by the budget ID.

Show child attributesHide child attributes

budget_configuration_idstringuuid

<Databricks> budget configuration ID.

alert_configurationsarray of object

Alerts to configure when this budget is in a triggered state. Budgets must have at least one alert configuration. A budget can have up to four shared alerts per time period, each with a unique quantity_threshold. Budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY can also use per-user alerts, with optional principal_overrides. These budgets can have at most one per-user alert per time period, and can use shared alerts, a per-user alert, or both. The BLOCK_USAGE action is only supported on budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. At most one shared alert per time period can have a BLOCK_USAGE action, and it must be the shared alert with the highest threshold in that period.

Show child attributesHide child attributes

alert_configuration_idstringuuid

<Databricks> alert configuration ID.

time_periodstring

The time window of usage data for the budget.

Values:

• MONTH

trigger_typestring

The evaluation method to determine when this budget alert is in a triggered state.

Values:

• CUMULATIVE_SPENDING_EXCEEDED

quantity_typestring

The way to calculate cost for this budget alert. This is what quantity_threshold is measured in.

Values:

• LIST_PRICE_DOLLARS_USD

quantity_thresholdstring

The threshold for the budget alert to determine if it is in a triggered state. The number is evaluated based on quantity_type.

action_configurationsarray of object

Configured actions for this alert. These define what happens when an alert enters a triggered state.

Show child attributesHide child attributes

action_configuration_idstringuuid

<Databricks> action configuration ID.

action_typestring

The type of the action.

Values:

• EMAIL_NOTIFICATION
• BLOCK_USAGE Beta

targetstring

Target for the action. For example, an email address.

scope_typestringBeta

How the alert threshold is evaluated. Determines whether spend is tracked in aggregate or per individual user.

Values:

• ALERT_CONFIGURATION_SCOPE_TYPE_SHARED
• ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER

principal_overridesarray of objectBeta

Per-principal threshold overrides for this alert. Only applies to per-user alerts (scope_type = ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER); ignored for shared alerts.

Show child attributesHide child attributes

principal_idint64Beta

Account-level principal id (user, group, or service principal).

override_thresholdstringBeta

Dollar amount that overrides the parent alert's quantity_threshold for this principal.

filterobject

Configured filters for this budget. These are applied to your account's usage to limit the scope of what is considered for this budget. Leave empty to include all usage for this account. All provided filters must be matched for usage to be included.

Show child attributesHide child attributes

workspace_idobject

If provided, usage must match with the provided <Databricks> workspace IDs.

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of int64

tagsarray of object

A list of tag keys and values that will limit the budget to usage that includes those specific custom tags. Tags are case-sensitive and should be entered exactly as they appear in your usage data.

Show child attributesHide child attributes

keystring

valueobject

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of string

display_namestring

Human-readable name of budget configuration. Max Length: 128

include_external_spendbooleanBeta

Whether this budget tracks external pass-through spend (third-party costs billed through a <Databricks> product) in addition to internal <Databricks> spend. Only applicable to Unity Gateway budgets, i.e. when resource_type is BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. This field is immutable after create.

resource_typestringBeta

The resource scope for this budget. Determines whether the budget tracks all resources or a specific resource.

Values:

• BUDGET_RESOURCE_TYPE_ALL_RESOURCES
• BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY

Response

budgetobject

The updated budget.

Show child attributesHide child attributes

budget_configuration_idstringuuid

<Databricks> budget configuration ID.

account_idstringuuid

<Databricks> account ID.

create_timeint64

Creation time of this budget configuration.

update_timeint64

Update time of this budget configuration.

alert_configurationsarray of object

Alerts to configure when this budget is in a triggered state. Budgets must have at least one alert configuration. A budget can have up to four shared alerts per time period, each with a unique quantity_threshold. Budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY can also use per-user alerts, with optional principal_overrides. These budgets can have at most one per-user alert per time period, and can use shared alerts, a per-user alert, or both. The BLOCK_USAGE action is only supported on budgets with resource_type set to BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. At most one shared alert per time period can have a BLOCK_USAGE action, and it must be the shared alert with the highest threshold in that period.

Show child attributesHide child attributes

alert_configuration_idstringuuid

<Databricks> alert configuration ID.

time_periodstring

The time window of usage data for the budget.

Values:

• MONTH

trigger_typestring

The evaluation method to determine when this budget alert is in a triggered state.

Values:

• CUMULATIVE_SPENDING_EXCEEDED

quantity_typestring

The way to calculate cost for this budget alert. This is what quantity_threshold is measured in.

Values:

• LIST_PRICE_DOLLARS_USD

quantity_thresholdstring

The threshold for the budget alert to determine if it is in a triggered state. The number is evaluated based on quantity_type.

action_configurationsarray of object

Configured actions for this alert. These define what happens when an alert enters a triggered state.

Show child attributesHide child attributes

action_configuration_idstringuuid

<Databricks> action configuration ID.

action_typestring

The type of the action.

Values:

• EMAIL_NOTIFICATION
• BLOCK_USAGE Beta

targetstring

Target for the action. For example, an email address.

scope_typestringBeta

How the alert threshold is evaluated. Determines whether spend is tracked in aggregate or per individual user.

Values:

• ALERT_CONFIGURATION_SCOPE_TYPE_SHARED
• ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER

principal_overridesarray of objectBeta

Per-principal threshold overrides for this alert. Only applies to per-user alerts (scope_type = ALERT_CONFIGURATION_SCOPE_TYPE_PER_USER); ignored for shared alerts.

Show child attributesHide child attributes

principal_idint64Beta

Account-level principal id (user, group, or service principal).

override_thresholdstringBeta

Dollar amount that overrides the parent alert's quantity_threshold for this principal.

filterobject

Configured filters for this budget. These are applied to your account's usage to limit the scope of what is considered for this budget. Leave empty to include all usage for this account. All provided filters must be matched for usage to be included.

Show child attributesHide child attributes

workspace_idobject

If provided, usage must match with the provided <Databricks> workspace IDs.

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of int64

tagsarray of object

A list of tag keys and values that will limit the budget to usage that includes those specific custom tags. Tags are case-sensitive and should be entered exactly as they appear in your usage data.

Show child attributesHide child attributes

keystring

valueobject

Show child attributesHide child attributes

operatorstring

Values:

• IN

valuesarray of string

display_namestring

Human-readable name of budget configuration. Max Length: 128

include_external_spendbooleanBeta

Whether this budget tracks external pass-through spend (third-party costs billed through a <Databricks> product) in addition to internal <Databricks> spend. Only applicable to Unity Gateway budgets, i.e. when resource_type is BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY. This field is immutable after create.

resource_typestringBeta

The resource scope for this budget. Determines whether the budget tracks all resources or a specific resource.

Values:

• BUDGET_RESOURCE_TYPE_ALL_RESOURCES
• BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY

View as Markdown

Request

{
  "budget": {
    "budget_configuration_id": "string",
    "alert_configurations": [
      {}
    ],
    "filter": {},
    "display_name": "string",
    "include_external_spend": true,
    "resource_type": "BUDGET_RESOURCE_TYPE_ALL_RESOURCES"
  }
}

Response

{
  "budget": {
    "budget_configuration_id": "string",
    "account_id": "string",
    "create_time": 0,
    "update_time": 0,
    "alert_configurations": [
      {}
    ],
    "filter": {},
    "display_name": "string",
    "include_external_spend": true,
    "resource_type": "BUDGET_RESOURCE_TYPE_ALL_RESOURCES"
  }
}

Delete budget GA

DELETE /api/2.1/accounts/{account_id}/budgets/{budget_id}

Deletes a budget configuration for an account. Both account and budget configuration are specified by ID. This cannot be undone.

API scopes: billing

Parameters

account_idstringuuidRequiredpath

<Databricks> account ID.

budget_idstringuuidRequiredpath

The <Databricks> budget configuration ID.

View as Markdown

Response

{}