github.com/IBM-Cloud/terraform@v0.6.4-0.20170726051544-8872b87621df/website/source/docs/providers/azurerm/r/express_route_circuit.html.markdown (about)

     1  ---
     2  layout: "azurerm"
     3  page_title: "Azure Resource Manager: azurerm_express_route_circuit"
     4  sidebar_current: "docs-azurerm-resource-express-route-circuit"
     5  description: |-
     6    Creates an ExpressRoute circuit.
     7  ---
     8  
     9  # azurerm\_express\_route\_circuit
    10  
    11  Creates an ExpressRoute circuit.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "azurerm_resource_group" "test" {
    17    name     = "exprtTest"
    18    location = "West US"
    19  }
    20  
    21  resource "azurerm_express_route_circuit" "test" {
    22    name                     = "expressRoute1"
    23    resource_group_name      = "${azurerm_resource_group.test.name}"
    24    location                 = "West US"
    25    service_provider_name    = "Equinix"
    26    peering_location         = "Silicon Valley"
    27    bandwidth_in_mbps        = 50
    28    sku {
    29      tier   = "Standard"
    30      family = "MeteredData"
    31    }
    32    allow_classic_operations = false
    33  
    34    tags {
    35      environment = "Production"
    36    }
    37  }
    38  ```
    39  
    40  ## Argument Reference
    41  
    42  The following arguments are supported:
    43  
    44  * `name` - (Required) The name of the ExpressRoute circuit. Changing this forces a
    45      new resource to be created.
    46  
    47  * `resource_group_name` - (Required) The name of the resource group in which to
    48      create the namespace. Changing this forces a new resource to be created.
    49  
    50  * `location` - (Required) Specifies the supported Azure location where the resource exists.
    51      Changing this forces a new resource to be created.
    52  
    53  * `service_provider_name` - (Required) The name of the ExpressRoute Service Provider.
    54  
    55  * `peering_location` - (Required) The name of the peering location and not the ARM resource location.
    56  
    57  * `bandwidth_in_mbps` - (Required) The bandwidth in Mbps of the circuit being created. Once you increase your bandwidth, 
    58      you will not be able to decrease it to its previous value.
    59  
    60  * `sku` - (Required) Chosen SKU of ExpressRoute circuit as documented below.
    61  
    62  * `allow_classic_operations` - (Optional) Allow the circuit to interact with classic (RDFE) resources.
    63      The default value is false.
    64  
    65  * `tags` - (Optional) A mapping of tags to assign to the resource.
    66  
    67  `sku` supports the following:
    68  
    69  * `tier` - (Required) The service tier. Value must be either "Premium" or "Standard".
    70  
    71  * `family` - (Required) The billing mode. Value must be either "MeteredData" or "UnlimitedData". 
    72     Once you set the billing model to "UnlimitedData", you will not be able to switch to "MeteredData".
    73  
    74  ## Attributes Reference
    75  
    76  The following attributes are exported:
    77  
    78  * `id` - The Resource ID of the ExpressRoute circuit.
    79  * `service_provider_provisioning_state` - The ExpressRoute circuit provisioning state from your chosen service provider. 
    80      Possible values are "NotProvisioned", "Provisioning", "Provisioned", and "Deprovisioning".
    81  * `service_key` - The string needed by the service provider to provision the ExpressRoute circuit.
    82  
    83  ## Import
    84  
    85  ExpressRoute circuits can be imported using the `resource id`, e.g.
    86  
    87  ```
    88  terraform import azurerm_express_route_circuit.myExpressRoute /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/expressRouteCircuits/myExpressRoute
    89  ```