github.com/vtorhonen/terraform@v0.9.0-beta2.0.20170307220345-5d894e4ffda7/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  * `gateway` - (Optional) Gateway that will be provided to the instances in this
    38      network. Defaults to the first usable IP in the range.
    39  
    40  * `startip` - (Optional) Start of the IP block that will be available on the
    41      network. Defaults to the second available IP in the range.
    42  
    43  * `endip` - (Optional) End of the IP block that will be available on the
    44      network. Defaults to the last available IP in the range.
    45  
    46  * `network_domain` - (Optional) DNS domain for the network.
    47  
    48  * `network_offering` - (Required) The name or ID of the network offering to use
    49      for this network.
    50  
    51  * `vlan` - (Optional) The VLAN number (1-4095) the network will use. This might be
    52      required by the Network Offering if specifyVlan=true is set. Only the ROOT
    53      admin can set this value.
    54  
    55  * `vpc_id` - (Optional) The VPC ID in which to create this network. Changing
    56      this forces a new resource to be created.
    57  
    58  * `acl_id` - (Optional) The ACL ID that should be attached to the network or
    59      `none` if you do not want to attach an ACL. You can dynamically attach and
    60      swap ACL's, but if you want to detach an attached ACL and revert to using
    61      `none`, this will force a new resource to be created. (defaults `none`)
    62  
    63  * `project` - (Optional) The name or ID of the project to deploy this
    64      instance to. Changing this forces a new resource to be created.
    65  
    66  * `zone` - (Required) The name or ID of the zone where this network will be
    67      available. Changing this forces a new resource to be created.
    68  
    69  * `tags` - (Optional) A mapping of tags to assign to the resource.
    70  
    71  ## Attributes Reference
    72  
    73  The following attributes are exported:
    74  
    75  * `id` - The ID of the network.
    76  * `display_text` - The display text of the network.
    77  * `network_domain` - DNS domain for the network.