github.com/erriapo/terraform@v0.6.12-0.20160203182612-0340ea72354f/website/source/docs/providers/cloudstack/r/network.html.markdown (about)

     1  ---
     2  layout: "cloudstack"
     3  page_title: "CloudStack: cloudstack_network"
     4  sidebar_current: "docs-cloudstack-resource-network"
     5  description: |-
     6    Creates a network.
     7  ---
     8  
     9  # cloudstack\_network
    10  
    11  Creates a network.
    12  
    13  ## Example Usage
    14  
    15  Basic usage:
    16  
    17  ```
    18  resource "cloudstack_network" "default" {
    19      name = "test-network"
    20      cidr = "10.0.0.0/16"
    21      network_offering = "Default Network"
    22      zone = "zone-1"
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `name` - (Required) The name of the network.
    31  
    32  * `display_text` - (Optional) The display text of the network.
    33  
    34  * `cidr` - (Required) The CIDR block for the network. Changing this forces a new
    35      resource to be created.
    36  
    37  * `startip` - (Optional) Start of the IP block that will be available on the 
    38      network. Defaults to the second available IP in the range.
    39  
    40  * `endip` - (Optional) End of the IP block that will be available on the 
    41      network. Defaults to the last available IP in the range.
    42  
    43  * `gateway` - (Optional) Gateway that will be provided to the instances in this
    44      network. Defaults to the first usable IP in the range.
    45  
    46  * `network_offering` - (Required) The name or ID of the network offering to use
    47      for this network.
    48  
    49  * `vlan` - (Optional) The VLAN number (1-4095) the network will use. This might be
    50      required by the Network Offering if specifyVlan=true is set. Only the ROOT 
    51      admin can set this value.
    52  
    53  * `vpc` - (Optional) The name or ID of the VPC to create this network for. Changing
    54      this forces a new resource to be created.
    55  
    56  * `aclid` - (Optional) The ID of a network ACL that should be attached to the
    57      network. Changing this forces a new resource to be created.
    58  
    59  * `project` - (Optional) The name or ID of the project to deploy this
    60      instance to. Changing this forces a new resource to be created.
    61  
    62  * `zone` - (Required) The name or ID of the zone where this disk volume will be
    63      available. Changing this forces a new resource to be created.
    64  
    65  * `tags` - (Optional) A mapping of tags to assign to the resource. 
    66  
    67  ## Attributes Reference
    68  
    69  The following attributes are exported:
    70  
    71  * `id` - The ID of the network.
    72  * `display_text` - The display text of the network.