feat: Add per-notification operator/thresholdType control for Consumption Budget modules by Copilot · Pull Request #7132 · Azure/bicep-registry-modules

Copilot · 2026-06-05T00:16:23Z

This change adds additive, per-notification control for budget alerts so a single budget can mix Actual and Forecasted notifications with independent operators. Existing behavior is preserved by keeping the current thresholds + thresholdType path as fallback when notifications is not provided.

Module contract changes (all scopes: sub/mg/rg)
- Added exported notificationType user-defined type with operator, bounded threshold, and thresholdType.
- Added optional @maxLength(5) param notifications notificationType[]?.
- Marked thresholds and thresholdType descriptions as deprecated in favor of notifications.
Notification composition logic
- When notifications is non-empty, resource notifications are built from it.
- Otherwise, notifications are derived from legacy thresholds + operator + thresholdType to keep compatibility.
Generated module artifacts
- Regenerated scoped README.md and main.json files for sub-scope, mg-scope, and rg-scope via Set-AVMModule.
Versioning and CHANGELOG
- Bumped the MINOR version in version.json from 0.1 to 0.2 for all three scopes (sub-scope, mg-scope, rg-scope).
- Added a ## 0.2.0 section to each scope's CHANGELOG.md describing the new notifications parameter. This resolves the Module Compliance failure requiring the CHANGELOG to contain a section for the new module version.

param notifications notificationType[]?

var notificationSettings = !empty(notifications ?? []) ? notifications! : notificationsFromThresholds

var notificationsArray = [
  for notification in notificationSettings: {
    '${notification.thresholdType}_${notification.operator}_${notification.threshold}_Percentage': {
      enabled: true
      operator: notification.operator
      threshold: notification.threshold
      thresholdType: notification.thresholdType
    }
  }
]

Pipeline Reference

Pipeline

Type of Change

Azure Verified Module updates:
- Bugfix containing backwards-compatible bug fixes, and I have NOT bumped the MAJOR or MINOR version in version.json:
- Feature update backwards compatible feature updates, and I have bumped the MINOR version in version.json.
- Breaking changes and I have bumped the MAJOR version in version.json.
- Update to documentation
Update to CI Environment or utilities (Non-module affecting changes)

Checklist

I'm sure there are no other open Pull Requests for the same update/change
I have run Set-AVMModule locally to generate the supporting module files.
My corresponding pipelines / checks run clean and green without any errors or warnings
I have updated the module's CHANGELOG.md file with an entry for the next version

Co-authored-by: segraef <19261257+segraef@users.noreply.github.com>

segraef · 2026-06-09T09:46:17Z

@copilot have a look at https://github.com/Azure/bicep-registry-modules/actions/runs/27008032579/job/79704656273 in this regard.

Co-authored-by: segraef <19261257+segraef@users.noreply.github.com>

Copilot · 2026-06-09T09:51:13Z

@copilot have a look at https://github.com/Azure/bicep-registry-modules/actions/runs/27008032579/job/79704656273 in this regard.

The job failed on the CHANGELOG compliance test: [consumption/budget/rg-scope] and [sub-scope] required a ## 0.1.1 section because the module had changes but version.json wasn't bumped.

Since this PR adds a feature (the notifications parameter), I bumped the MINOR version in version.json from 0.1 to 0.2 and added a ## 0.2.0 section to the CHANGELOG for all three scopes (rg/sub/mg). The compliance test now expects and finds ## 0.2.0.

…Module)

AlexanderSehr · 2026-06-19T08:14:17Z


+@export()
+type notificationType = {
+  @description('Required. The comparison operator. The operator can be either `EqualTo`, `GreaterThan`, or `GreaterThanOrEqualTo`.')


Suggested change

@description('Required. The comparison operator. The operator can be either `EqualTo`, `GreaterThan`, or `GreaterThanOrEqualTo`.')

@description('Required. The comparison operator.')

Redundant information that is anyways suggested automatically to the user.

AlexanderSehr · 2026-06-19T08:14:30Z

+  @minValue(1)
+  @maxValue(1000)
+  threshold: int
+  @description('Required. The type of threshold to use for the budget. The threshold type can be either `Actual` or `Forecasted`.')


Suggested change

@description('Required. The type of threshold to use for the budget. The threshold type can be either `Actual` or `Forecasted`.')

@description('Required. The type of threshold to use for the budget.')

Redundant information that is anyways suggested automatically to the user.

AlexanderSehr · 2026-06-19T08:21:20Z

 targetScope = 'managementGroup'

+@export()
+type notificationType = {


We usually group all types in a // Definitions // section at the bottom of the file to somewhat imply order 😄

AlexanderSehr · 2026-06-19T09:48:00Z

 targetScope = 'subscription'

+@export()
+type notificationType = {


Same comment as per mg-scope

AlexanderSehr · 2026-06-19T09:50:10Z


 @maxLength(5)
-@description('Optional. Percent thresholds of budget for when to get a notification. Can be up to 5 thresholds, where each must be between 1 and 1000.')
+@description('Optional. Deprecated: use `notifications` for per-threshold control. Percent thresholds of budget for when to get a notification. Can be up to 5 thresholds, where each must be between 1 and 1000.')


Why not remove it? We're pre 1.0 and can/should upgrade the module version accordingly.
That's why we have a breaking change section in which we can also explain the migration/upgrade strategy 😉

AlexanderSehr · 2026-06-19T09:50:55Z

  'Forecasted'
 ])
-@description('Optional. The type of threshold to use for the budget. The threshold type can be either `Actual` or `Forecasted`.')
+@description('Optional. Deprecated: use `notifications` for per-threshold control. The type of threshold to use for the budget. The threshold type can be either `Actual` or `Forecasted`.')


Same comment as for 'thresholds'

AlexanderSehr · 2026-06-19T09:51:17Z

+type notificationType = {
+  @description('Required. The comparison operator. The operator can be either `EqualTo`, `GreaterThan`, or `GreaterThanOrEqualTo`.')


Same comment as per mg-scope

AlexanderSehr · 2026-07-06T07:00:15Z

ping @segraef

microsoft-github-policy-service · 2026-07-12T06:22:32Z

Important

@copilot, this issue has been automatically marked as stale because it has been marked as requiring author feedback but has not had any activity for 4 days.

Tip

To prevent further actions to take effect, one of the following conditions must be met:

The author must respond in a comment within 3 days of this comment.
The "Status: No Recent Activity 💤" label must be removed.
If applicable, the "Status: Long Term ⏳" or the "Needs: Module Owner 📣" label must be added.

Initial plan

86390fc

Copilot AI assigned Copilot and segraef Jun 5, 2026

Copilot started work on behalf of segraef June 5, 2026 00:16 View session

Copilot AI linked an issue Jun 5, 2026 that may be closed by this pull request

[AVM Module Issue]: Fine control for notification thresholds in budget #6518

Open

1 task

microsoft-github-policy-service Bot added Needs: Triage 🔍 Maintainers need to triage still Type: AVM 🅰️ ✌️ Ⓜ️ This is an AVM related issue labels Jun 5, 2026

Copilot AI and others added 2 commits June 5, 2026 00:25

feat: add per-threshold notifications for budget modules

ef7156f

Co-authored-by: segraef <19261257+segraef@users.noreply.github.com>

chore: regenerate budget module artifacts and docs

aedd27e

Co-authored-by: segraef <19261257+segraef@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add fine control for notification thresholds in budget~~ Add per-notification operator/thresholdType control for Consumption Budget modules Jun 5, 2026

Copilot finished work on behalf of segraef June 5, 2026 00:34

Copilot AI requested a review from segraef June 5, 2026 00:34

Copilot started work on behalf of segraef June 5, 2026 01:02 View session

Copilot AI changed the title ~~Add per-notification operator/thresholdType control for Consumption Budget modules~~ feat: Add per-notification operator/thresholdType control for Consumption Budget modules Jun 5, 2026

Copilot finished work on behalf of segraef June 5, 2026 01:07

segraef marked this pull request as ready for review June 5, 2026 09:24

segraef requested review from a team as code owners June 5, 2026 09:24

Merge branch 'main' into copilot/avm-module-fine-control-thresholds

fa5572d

Copilot started work on behalf of segraef June 9, 2026 09:46 View session

fix: bump budget module version to 0.2.0 and add CHANGELOG entries

f0a708a

Co-authored-by: segraef <19261257+segraef@users.noreply.github.com>

Copilot finished work on behalf of segraef June 9, 2026 09:52

segraef added 3 commits June 10, 2026 09:18

Merge branch 'main' into copilot/avm-module-fine-control-thresholds

3679d0b

fix: regenerate budget module README and sub-scope main.json (Set-AVM…

287c570

…Module)

fix: remove reference block from unpublished budget wrapper README

b517790

segraef temporarily deployed to avm-validation June 10, 2026 02:32 — with GitHub Actions Inactive

segraef temporarily deployed to avm-validation June 10, 2026 06:44 — with GitHub Actions Inactive

segraef had a problem deploying to avm-validation June 10, 2026 06:44 — with GitHub Actions Failure

segraef temporarily deployed to avm-validation June 10, 2026 06:44 — with GitHub Actions Inactive

segraef had a problem deploying to avm-validation June 10, 2026 06:44 — with GitHub Actions Failure

segraef temporarily deployed to avm-validation June 10, 2026 06:44 — with GitHub Actions Inactive

segraef temporarily deployed to avm-validation June 10, 2026 09:38 — with GitHub Actions Inactive

segraef enabled auto-merge (squash) June 10, 2026 10:25

segraef added 2 commits June 11, 2026 09:47

Merge branch 'main' into copilot/avm-module-fine-control-thresholds

ad3531e

Merge branch 'main' into copilot/avm-module-fine-control-thresholds

2406af2

AlexanderSehr reviewed Jun 19, 2026

View reviewed changes

AlexanderSehr added the Needs: Author Feedback 👂 Awaiting feedback from the issue/PR author label Jul 6, 2026

microsoft-github-policy-service Bot added the Status: No Recent Activity 💤 When an issue/PR has not been modified for X amount of days label Jul 12, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Add per-notification operator/thresholdType control for Consumption Budget modules#7132

feat: Add per-notification operator/thresholdType control for Consumption Budget modules#7132
segraef with Copilot wants to merge 12 commits into
mainfrom
copilot/avm-module-fine-control-thresholds

Copilot AI commented Jun 5, 2026 •

edited by segraef

Loading

Uh oh!

segraef commented Jun 9, 2026

Uh oh!

Copilot AI commented Jun 9, 2026

Uh oh!

AlexanderSehr Jun 19, 2026

Uh oh!

AlexanderSehr Jun 19, 2026

Uh oh!

AlexanderSehr Jun 19, 2026

Uh oh!

AlexanderSehr Jun 19, 2026 •

edited

Loading

Uh oh!

AlexanderSehr Jun 19, 2026 •

edited

Loading

Uh oh!

AlexanderSehr Jun 19, 2026

Uh oh!

AlexanderSehr Jun 19, 2026

Uh oh!

AlexanderSehr commented Jul 6, 2026

Uh oh!

microsoft-github-policy-service Bot commented Jul 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	@description('Required. The comparison operator. The operator can be either `EqualTo`, `GreaterThan`, or `GreaterThanOrEqualTo`.')
	@description('Required. The comparison operator.')

	@description('Required. The type of threshold to use for the budget. The threshold type can be either `Actual` or `Forecasted`.')
	@description('Required. The type of threshold to use for the budget.')

		type notificationType = {
		@description('Required. The comparison operator. The operator can be either `EqualTo`, `GreaterThan`, or `GreaterThanOrEqualTo`.')

Uh oh!

Conversation

Copilot AI commented Jun 5, 2026 • edited by segraef Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pipeline Reference

Type of Change

Checklist

Uh oh!

segraef commented Jun 9, 2026

Uh oh!

Copilot AI commented Jun 9, 2026

Uh oh!

AlexanderSehr Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

AlexanderSehr Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

AlexanderSehr Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

AlexanderSehr Jun 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

AlexanderSehr Jun 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

AlexanderSehr Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

AlexanderSehr Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

AlexanderSehr commented Jul 6, 2026

Uh oh!

microsoft-github-policy-service Bot commented Jul 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Jun 5, 2026 •

edited by segraef

Loading

AlexanderSehr Jun 19, 2026 •

edited

Loading

AlexanderSehr Jun 19, 2026 •

edited

Loading