Search

Please login in for more filter options

Kickstart your project with AVM templates.

AVM Bicep Modules
AVM Terraform Modules

network-virtualnetwork

avm-terraform

report
Report Package network-virtualnetwork

If you believe that this package or its contents contain harmful information, please inform us.
Please be aware that we will never share your credentials.

Please let us know what this package contains.
Please enter a valid email address.

This Terraform Azure Verified Module deploys: terraform-azurerm-avm-res-network-virtualnetwork

ipm add --package avm-terraform/network-virtualnetwork --version 0.19.0

Published: 29-08-2026

Project URL: https://ipmhub.io/avm-terraform

Package Type: Terraform

License: MIT

No readme file uploaded for this version

Release History

Version 0.19.0 - 2026-06-17

What's Changed

⚠️ Breaking Changes

  • Interfaces converted from azurerm to azapi (#52) — the resource lock, role assignment, and diagnostic settings interfaces are now implemented with azapi_resource via the Azure/avm-utl-interfaces utility module. The azurerm provider dependency has been removed from the module entirely. (#108)

Input/output compatibility: the lock, role_assignments, and diagnostic_settings variable schemas are unchanged — no inputs or outputs were added, removed, or renamed. Existing configurations do not need to change.

Upgrade impact on terraform apply:

  • Locks & diagnostic settings migrate in place via moved blocks — no recreation.
  • Role assignments are recreated once. Their underlying resource name changes from the azurerm-generated GUID to the utility module's generated name, so Terraform will destroy and re-create each role assignment on the first apply after upgrading. This is a metadata-only churn — the effective access (principal, role, scope) is identical before and after. Plan carefully if you have policies that react to role-assignment lifecycle events.

Why

Aligns the module with the AVM direction of using azapi + shared interface utility modules, reduces provider surface area, and removes the dual-provider (azurerm + azapi) requirement for consumers.

Contributors

  • @kewalaka — original implementation (#52 / #108)
  • @haflidif — maintainer, takeover & CI
  • @jaredfholgate — review

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.18.2...v0.19.0

Version 0.18.2 - 2026-06-17

What's Changed

Bug Fixes

  • Fix extended_location validation (#54) — the validation used contains() with a string as its first argument instead of a list, causing it to error at plan time for any non-null extended_location, making the variable unusable. The check is now a direct equality comparison (var.extended_location.type == "EdgeZone") and is covered by a new unit test. (#107)

Maintenance

  • Repository hygiene (#42) — removed tracked .DS_Store files and ignored them going forward. (#107)
  • Dependencies — consolidated Dependabot bumps for example-only helper modules: Azure/avm-utl-regions/azurerm 0.9.0 → 0.12.0 and Azure/naming/azurerm 0.4.2 → 0.4.3. No impact on the module, its inputs, outputs, or consumers. (#106)

Patch release. The only consumer-facing change is the extended_location validation fix — no inputs or outputs were added, removed, or renamed.

Contributors

  • @haflidif — maintainer
  • @T0biii — repository hygiene (.DS_Store cleanup)
  • @jaredfholgate — review

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.18.1...v0.18.2

Version 0.18.1 - 2026-06-15

What's Changed

Documentation

  • Clarify IPAM allocation rules and pool constraints in the module README (#105). Documents the Azure AVNM platform behavior verified against API 2025-09-01:
    • One IPv4 pool + one IPv6 pool per virtual network (and per subnet) — the RP rejects duplicate or multiple same-family pools (CannotHaveDuplicatePoolIds, only one association of each IP type is allowed).
    • No mixing of IPAM pool allocation and static address_prefixes in the same VNet/subnet (CannotMixAddressPrefixAndPoolInPayload).
    • Subnet pools must be a subset of the parent VNet's pools (SubnetPoolsMustBeSubsetOfVnetPools).
    • Summarization vs. fragmentation of a single number_of_ip_addresses allocation: Azure resolves one allocation entry into one or more CIDRs depending on contiguity of free space — this is read-only and causes no Terraform drift.
  • New "IPAM Allocation Rules and Sizing" section plus expanded IPAM troubleshooting with RP error codes.

Docs-only patch release. No module behavior, inputs, or outputs changed. The validation introduced in v0.18.0 (one IPv4 + one IPv6 pool per VNet) was confirmed correct against the latest Azure API.

Contributors

  • @haflidif — maintainer
  • @jaredfholgate — review

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.18.0...v0.18.1

Version 0.18.0 - 2026-06-15

What's Changed

Features

  • Pass through number_of_ip_addresses for IPAM pools (root module + subnet submodule), enabling single address-count IPAM allocation. Originally contributed by @timja in #67.

Bug Fixes

  • Require number_of_ip_addresses or prefix_length per IPAM pool (XOR validation), preventing a plan-time crash when neither is set. Contributed by @martinopedal in #67.
  • Fix regex for IPAM pool ID validation. Contributed by @walkerk1980 in #65.
  • Stop emitting the unsupported enabled_metric diagnostic block for virtual networks (interface-compliant: the metric_categories input is retained). Contributed by @deni-cpu and @martinopedal in #69.
  • Align IPv6 IPAM pool validation with IPv4 (full /48–/64 range, null-guarded). By @haflidif.

Tests

  • Add terraform test unit coverage for ipam_pools variable validations (9 runs). By @haflidif.

Issues fixed

  • Closes #66 — IPAM allocation by address count
  • Closes #64 — regex now allows . in IPAM pool names
  • Closes #43 — removes the unsupported dynamic enabled_metric for virtual networks

Contributors

Huge thanks to everyone whose work is included in this release 🙏

  • @timja — #67
  • @martinopedal — #67, #69
  • @walkerk1980 — #65
  • @deni-cpu — #69
  • @jaredfholgate — review
  • @haflidif — maintainer

Note: External contributions were reimplemented on an owner-controlled release branch (#104) because fork PRs cannot run the AVM CI directly; original authorship is preserved via commit Co-authored-by trailers. Multi-pool IPAM (#102) remains out of scope per the Azure AVNM API constraints discussed in #71 (one IPv4 + one IPv6 pool per VNet, no mixing). #70 is tracked separately.

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.17.1...v0.18.0

Version 0.17.1 - 2026-01-19

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.17.0...v0.17.1

Version 0.17.0 - 2026-01-07

What's Changed

Issues fixed

fixed #48

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.16.0...v0.17.0

Version 0.16.0 - 2025-11-14

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.15.0...v0.16.0

Version 0.15.0 - 2025-10-15

Breaking changes

The deprecated service_endpoints input for subnets has been removed.

We have had to separate the implementation of subnets using IPAM. If you have deployed a subnet with IPAM since that change went out, you'll need to add a moved block to your code into order to migrate the state. E.g.

moved {
  from = module.vnet.module.subnet["subnet01"].azapi_resource.subnet
  to   = module.vnet.module.subnet["subnet01"].azapi_resource.subnet_ipam[0]
}

If you are not using IPAM your state will automatically be migrated.

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.14.1...v0.15.0

Version 0.14.1 - 2025-10-07

What's Changed

Thanks to @Arhughes14 for contributing this change

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.14.0...v0.14.1

Version 0.14.0 - 2025-10-07

🎉 Major New Feature: IPAM Support

This release introduces comprehensive IP Address Management (IPAM) support through Azure Virtual Network Manager, enabling centralized IP governance and automatic conflict prevention.

✨ New Capabilities

  • 🏢 VNet IPAM Allocation - Automatically allocate VNet address space from centralized IPAM pools
  • 🔗 Subnet IPAM Allocation - Dynamic subnet addressing with automatic conflict resolution
  • 🔀 Mixed Addressing - Combine IPAM and traditional subnets within the same VNet
  • 🔄 Enhanced Subnet Module - Standalone subnet module now supports IPAM allocation
  • ⚡ Retry Logic - Robust conflict resolution with 15-second intervals (300s max timeout)

📍 Regional Availability

IPAM is supported in all Azure regions where Virtual Network Manager is available, except: chilecentral, jioindiawest, malaysiawest, qatarcentral, southafricawest, westindia, westus3

🛠 What's New

Core Module

  • Added ipam_pools variable for VNet address space allocation
  • Enhanced subnet configuration with IPAM pool support
  • Integrated retry mechanisms for reliable IPAM operations
  • Maintained full backwards compatibility (zero breaking changes)

Subnet Module

  • Added IPAM allocation capabilities to standalone subnet module
  • Support for dynamic IP assignment from IPAM pools
  • Consistent interface with main module IPAM features

New Examples

  • ipam_basic - Complete IPAM usage with VNet and multiple subnets
  • existing_vnet_ipam_subnets - Adding IPAM subnets to existing IPAM-enabled VNets
  • ipam_vnet_only - IPAM VNet creation with traditional subnet management

🔧 Technical Requirements

  • Azure Virtual Network Manager required for IPAM functionality
  • azapi provider version ~> 2.4
  • Removed time provider dependency (replaced with native azapi retry logic)

📚 Migration Notes

  • No breaking changes - existing configurations work unchanged
  • Optional feature - IPAM can be adopted gradually alongside traditional addressing
  • State compatibility - no state migration required

🐛 Other Improvements

  • Enhanced error handling and retry mechanisms
  • Comprehensive documentation and troubleshooting guides

🙏 Acknowledgments

Special thanks to @ChrisChapman-gh for his initial structure and shell that helped lay the foundation for this IPAM implementation.

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.13.0...v0.14.0

Version 0.13.0 - 2025-10-06

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.12.0...v0.13.0

Version 0.12.0 - 2025-09-29

Breaking Change

This PR removes some of the retry options, but very unlikely they are being used so not expecting much impact.

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.11.0...v0.12.0

Version 0.11.0 - 2025-09-26

Breaking Changes

This release includes a significant breaking change to the module interface.

We have removed the resource_group_name and subscription_id inputs. The resource group ID must now be explicitly provided via the parent_id input.

This change was necessary to align to forthcoming AVM v1 specs as well as fix an underlying idempotency issue with the existing implementation.

We try very hard not to make breaking changes to module interfaces like this and understand the impact it has to consumers of our modules. We do not anticipate any further breaking changes to the interface of this module prior to v1.

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.10.0...v0.11.0

Version 0.10.0 - 2025-08-01

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.9.3...v0.10.0

Version 0.9.3 - 2025-07-24

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/0.9.1...v0.9.3

Version 0.9.1 - 2025-07-03

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/0.9.0...0.9.1

Version 0.9.2 - 2025-07-03

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/0.9.0...0.9.2

Version 0.9.0 - 2025-06-24

Breaking changes

We no longer support azurerm v3 or azapi v1

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.8.1...0.9.0

Version 0.8.1 - 2025-02-06

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.8.0...v0.8.1

Version 0.8.0 - 2025-01-31

What's Changed

Breaking change

  • Update to the version of Terraform CLI support

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.7.2...v0.8.0

Version 0.7.2 - 2025-01-28

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.7.1...v0.7.2

Version 0.7.1 - 2024-11-16

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.7.0...v0.7.1

Version 0.7.0 - 2024-11-15

What's Changed

Releasing as a minor in this dependency change has impact on peering usage.

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.6.0...v0.7.0

Version 0.6.0 - 2024-11-01

What's Changed

This release adds support for v2 of the azapi provider. We have incremented the minor version, but there are no breaking changes and it is backwards compatible with v1 of azapi.

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.5.0...v0.6.0

Version 0.5.0 - 2024-10-29

What's Changed

Added backwards compatible support for v4 of azurerm.

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.4.2...v0.5.0

Version 0.4.2 - 2024-10-11

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.4.1...v0.4.2

Version 0.4.1 - 2024-10-11

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.4.0...v0.4.1

Version 0.4.0 - 2024-07-26

What's Changed

Added the capability to properly peer by subnet and fixed a non-backwards compatible default on peering.

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.3.0...v0.4.0

Version 0.3.0 - 2024-07-17

What's Changed

We added some missing properties and enabled automatic feature enablement for some preview features.

We added the address_prefix singular vartiable to the subnet submodule to support some cases where the address_prefixes variable is not being read by resources that use a subnet.

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.2.4...v0.3.0

Version 0.2.4 - 2024-07-05

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.2.3...v0.2.4

Version 0.2.3 - 2024-05-30

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.2.2...v0.2.3

Version 0.2.2 - 2024-05-29

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.2.1...v0.2.2

Version 0.2.1 - 2024-05-28

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.2.0...v0.2.1

Version 0.2.0 - 2024-05-28

Breaking Changes

v0.2.0 is a re-write of the module, it changes the interface and internal implementation considerably and you will have to update any code and state that is dependent on this module. We try to avoid making updates like this, but in this case we considered the updates valuable enough to make this change. The interface will be stable moving forward.

What's Changed

v0.2.0 moves the module to an AzAPI implementation. The primary driver for this is to support customers that implement common landing zone policies requiring route table and network security groups. You are now able to create a virtual network that meets your policy requirements in one atomic operation avoiding issues with policy blocking deployment.

We have also updated the module to better support common subscription vending scenarios, where application teams manage subnets, but don't managed the virtual network or peering.

We have broken out subnet and peering in sub modules that can be consumed independently. See the documentation and examples for more details on this.

A huge thanks to @kewalaka and @haflidif for all the work on this.

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.1.4...v0.2.0

Version 0.1.4 - 2024-03-20

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.1.3...v0.1.4

Version 0.1.3 - 2023-12-04

What's Changed

New Contributors

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.1.1...v0.1.3

Version 0.1.2 - 2023-10-16

  • changed approach in defining subnets
  • removed ability to create a DDOS plan as this should be a separate module. This module still accepts an existing ddos plan to be integrated to the vnet
  • added capability create a one side peer to another existing vnet

Version 0.1.1 - 2023-10-16

What's Changed

Full Changelog: https://github.com/Azure/terraform-azurerm-avm-res-network-virtualnetwork/compare/v0.1.0...v0.1.1

Version 0.1.0 - 2023-09-29

No release notes were published in the GitHub Release for this version.

 
 {
  "workingFolder": "packages",
  "packages": [
    // packages defined earlier
    {
      "name": "avm-terraform/network-virtualnetwork",
      "version": "0.19.0"
    }
  ]
}

This package has no dependencies

Stats

Selected version:

0.19.0

Downloads this version:

0

Downloads all versions:

48

Latest version:

0.22.2

Latest update:

29-08-2026

avm-terraform

Other versions (42)

0.22.2

0.22.1

0.22.0

0.21.0

0.20.0

0.19.0

0.18.2

0.18.1

0.18.0

0.17.1

Other packages

from avm-terraform

apimanagement-service

app-containerapp

app-job

View all from publisher

Ready to End Infrastructure Code Chaos?

Join infrastructure teams who've moved from scattered repositories to unified package management

Built by infrastructure experts
Who understand your challenges
Complete solutions
No scattered files
See what's deployed where
When it needs updates
Zero vendor lock-in
Packages work without us
Start Free Trial Book Live Demo Schedule Assessment
No setup fees or contracts Free migration assistance Cancel anytime with no penalties
Direct founder access Zero security incidents in 2+ years Works with any cloud, any CI/CD platform