AzureBreaking change
avm-res-resources-resourcegroup 0.5.0: breaking changes
Release date of version 0.5.0 of the Azure Verified Module avm-res-resources-resourcegroup: 6 Nov 2026. Breaking changes listed in the release notes: 8.
Breaking since , 6 Nov 2026
What breaks
Breaking changes listed in the release notes:
- Back up state and inspect the complete plan before applying. These changes are not a guarantee of a safe or replacement-free upgrade.
- Resource-group state now uses a counted AzAPI address. The move chain is azurerm_resource_group.this → azapi_resource.this → azapi_resource.this[0]; the last step also covers v0.4.0's unkeyed AzAPI address. Cross-provider conversion requires supported provider versions and usable Azure resource IDs. If conversion cannot be performed, explicit migration or import may be required.
- The new ignore_tag_changes input defaults to false. Do not toggle it on an existing group without a reviewed migration: switching resource definitions can plan a delete and create of the resource group, with potential loss of its contents.
- Lock configuration now includes notes = null; v0.4.0 omitted notes and older AzureRM-based versions supplied notes. Azure's handling of the explicit null has not been verified. Review existing notes and the plan.
- For AzureRM-era role assignments, explicitly set role_assignments[*].name to the existing assignment GUID before migration and inspect the plan; otherwise a new UUID can result in a different assignment name.
- The full resource output changes shape: a resource attribute is added (null in the default synthetic fixture). With ignore_tag_changes = true, reported tags are null. Consumers relying on the exact output object should review their use.
- AzAPI changes from ~> 2.4 to ~> 2.12; Terraform remains >= 1.9, < 2.0. Interfaces changes from 0.6.0 to 0.10.0. Active ModTM telemetry is replaced by subscription-scope AzAPI deployments. When telemetry is enabled, deployment read, write and delete permissions are required at subscription scope. Old telemetry state may need its old providers for a final initialization; removed telemetry resources are forgotten without destruction. Telemetry can be disabled with enable_telemetry = false.
- Offline synthetic-state/mock-provider plans covered the v0.4.0 and older AzureRM address chains; they do not prove live Azure behavior or all provider/Terraform version combinations. No live upgrade was performed.
Who is affected
Affected versions
0.5.0
What to do
- Breaking changes listed in the release notes for 0.5.0: 8. HashiCorp recommends explicitly constraining the acceptable version numbers to avoid unexpected or unwanted changes.
- Check the
versionargument of the module block that installs avm-res-resources-resourcegroup from the Terraform Registry. Terraform uses the newest installed version that meets the constraint. When no acceptable version is installed, it downloads the newest version that meets the constraint, so a constraint that allows 0.5.0 can bring in this release. A module block with noversionargument defaults to the latest version available from the source. - The AVM versioning specification requires that, until a module's first major version 1.0.0 is released, the minor version is bumped for breaking changes and the major version is not bumped.
- To stay on an earlier version for now, require a specific version. HashiCorp recommends this for third-party modules so that updates only happen when convenient to you.
- To adopt 0.5.0, set the
versionargument to it, then runterraform initso that Terraform can update the local code.
Replacement
Not stated by vendor.
Sources
- Official sourcegithub.comOfficial
- Additional sourceregistry.terraform.ioOfficial
Last checked against the first source in this list on .
Related
avm-res-resources-resourcegroupbreaking changes by version
- , 15 Sep 2026avm-res-web-site 0.23.0: breaking changesSource
- , 7 Oct 2026avm-res-network-networksecuritygroup 0.6.0: breaking changesSource
- , 12 Oct 2026avm-res-web-site 0.24.0: breaking changesSource
- , 22 Oct 2026avm-res-network-privateendpoint 0.3.0: breaking changesSource
- , 27 Oct 2026avm-res-managedidentity-userassignedidentity 0.6.0: breaking changesSource
- , 27 Oct 2026avm-res-network-routetable 0.6.0: breaking changesSource
Found an error? Report it
The text on this page is drafted with AI assistance from the vendor's text, checked against the official source and approved by a person before it is published. How items are written
Last checked · Added · Changelog for this item