terraform/website/source/docs/providers/azurerm/r/subnet.html.markdown

74 lines
2.3 KiB
Markdown
Raw Normal View History

2016-01-08 23:50:01 +01:00
---
layout: "azurerm"
page_title: "Azure Resource Manager: azure_subnet"
sidebar_current: "docs-azurerm-resource-network-subnet"
2016-01-08 23:50:01 +01:00
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
2016-01-08 23:50:01 +01:00
resource "azurerm_resource_group" "test" {
name = "acceptanceTestResourceGroup1"
location = "West US"
2016-01-08 23:50:01 +01:00
}
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}"
2016-01-08 23:50:01 +01:00
}
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"
2016-01-08 23:50:01 +01:00
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Required) The name of the subnet. Changing this forces a
2016-01-08 23:50:01 +01:00
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.
2016-01-08 23:50:01 +01:00
* `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
```