Support for summarizedGatewayPrefixes in azurerm_virtual_network

[luisfeliz79]

Is there an existing issue for this?

• I have searched the existing issues

ARM API Version Stability

• I confirm that this feature request relies on a stable ARM API, or I have read the guide and believe this request qualifies for an exception.

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• Please do not leave comments along the lines of "+1", "me too" or "any updates", they generate extra noise for issue followers and do not help prioritize the request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment and review the contribution guide to help.

Description

Azure Virtual Networks now support in GA a feature called "Advertised gateway prefixes" (summarizedGatewayPrefixes) which allows customers to reduce the number of ranges advertised to On-premises network by specifying their own list of summarized ranges and overwrite what the SDN normally programs.

Public documentation can be found here:
https://learn.microsoft.com/en-us/azure/virtual-network/advertised-gateway-prefixes-overview

API Reference can be found here:
https://learn.microsoft.com/en-us/rest/api/virtualnetwork/virtual-networks/create-or-update?view=rest-virtualnetwork-2025-07-01&tabs=HTTP#request-body

The ask is to add an attribute called summarized_gateway_prefixes under azurerm_virtual_network which allows for configuration of this setting

New or Affected Resource(s)/Data Source(s)

azurerm_virtual_network

Potential Terraform Configuration

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_network_security_group" "example" {
  name                = "example-security-group"
  location            = azurerm_resource_group.example.location
  resource_group_name = azurerm_resource_group.example.name
}

resource "azurerm_virtual_network" "example" {
  name                = "example-network"
  location            = azurerm_resource_group.example.location
  resource_group_name = azurerm_resource_group.example.name
  address_space       = ["10.0.0.0/16"]
  dns_servers         = ["10.0.0.4", "10.0.0.5"]

  subnet {
    name             = "subnet1"
    address_prefixes = ["10.0.1.0/24"]
  }

  subnet {
    name             = "subnet2"
    address_prefixes = ["10.0.2.0/24"]
    security_group   = azurerm_network_security_group.example.id
  }

   # EXAMPLE:
   summarized_gateway_prefixes = ["10.1.0.0/16", "10.128.0.0/9", "2001:db8:abcd:0012::1/64"]

  tags = {
    environment = "Production"
  }
}

References

API Reference:
https://learn.microsoft.com/en-us/rest/api/virtualnetwork/virtual-networks/create-or-update?view=rest-virtualnetwork-2025-07-01&tabs=HTTP#request-body

Public documentation can be found here:
https://learn.microsoft.com/en-us/azure/virtual-network/advertised-gateway-prefixes-overview

[v-yhyeo0202]

@luisfeliz79 it is verified that network API version 2025-01-01 which does not support summarized_gateway_prefixes property is used for azurerm_virtual_network. A PR will be opened soon to update the version and add the property.