--- layout: "azurerm" page_title: "Azure Resource Manager: azure_subnet" sidebar_current: "docs-azurerm-resource-network-subnet" description: |- Creates a new subnet. Subnets represent network segments within the IP space defined by the virtual network. --- # azurerm\_subnet Creates a new subnet. Subnets represent network segments within the IP space defined by the virtual network. ## Example Usage ```hcl resource "azurerm_resource_group" "test" { name = "acceptanceTestResourceGroup1" location = "West US" } resource "azurerm_virtual_network" "test" { name = "acceptanceTestVirtualNetwork1" address_space = ["10.0.0.0/16"] location = "West US" resource_group_name = "${azurerm_resource_group.test.name}" } resource "azurerm_subnet" "test" { name = "testsubnet" resource_group_name = "${azurerm_resource_group.test.name}" virtual_network_name = "${azurerm_virtual_network.test.name}" address_prefix = "10.0.1.0/24" } ``` ## Argument Reference The following arguments are supported: * `name` - (Required) The name of the subnet. Changing this forces a new resource to be created. * `resource_group_name` - (Required) The name of the resource group in which to create the subnet. * `virtual_network_name` - (Required) The name of the virtual network to which to attach the subnet. * `address_prefix` - (Required) The address prefix to use for the subnet. * `network_security_group_id` - (Optional) The ID of the Network Security Group to associate with the subnet. * `route_table_id` - (Optional) The ID of the Route Table to associate with the subnet. ## Attributes Reference The following attributes are exported: * `id` - The subnet ID. * `ip_configurations` - The collection of IP Configurations with IPs within this subnet. * `name` - The name of the subnet. * `resource_group_name` - The name of the resource group in which the subnet is created in. * `virtual_network_name` - The name of the virtual network in which the subnet is created in * `address_prefix` - The address prefix for the subnet ## Import Subnets can be imported using the `resource id`, e.g. ``` terraform import azurerm_subnet.testSubnet /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/virtualNetworks/myvnet1/subnets/mysubnet1 ```