github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/google/r/compute_network.html.markdown (about)

     1  ---
     2  layout: "google"
     3  page_title: "Google: google_compute_network"
     4  sidebar_current: "docs-google-compute-network"
     5  description: |-
     6    Manages a network within GCE.
     7  ---
     8  
     9  # google\_compute\_network
    10  
    11  Manages a network within GCE.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "google_compute_network" "default" {
    17    name                    = "test"
    18    auto_create_subnetworks = "true"
    19  }
    20  ```
    21  
    22  ## Argument Reference
    23  
    24  The following arguments are supported:
    25  
    26  * `name` - (Required) A unique name for the resource, required by GCE.
    27      Changing this forces a new resource to be created.
    28  
    29  - - -
    30  
    31  * `auto_create_subnetworks` - (Optional) If set to true, this network will be
    32      created in auto subnet mode, and Google will create a subnet for each region
    33      automatically. If set to false, and `ipv4_range` is not set, a custom
    34      subnetted network will be created that can support
    35      `google_compute_subnetwork` resources. This attribute may not be used if
    36      `ipv4_range` is specified.
    37  
    38  * `description` - (Optional) A brief description of this resource.
    39  
    40  * `ipv4_range` - (DEPRECATED, Optional) The IPv4 address range that machines in this network
    41      are assigned to, represented as a CIDR block. If not set, an auto or custom
    42      subnetted network will be created, depending on the value of
    43      `auto_create_subnetworks` attribute. This attribute may not be used if
    44      `auto_create_subnetworks` is specified. This attribute is deprecated.
    45  
    46  * `project` - (Optional) The project in which the resource belongs. If it
    47      is not provided, the provider project is used.
    48  
    49  ## Attributes Reference
    50  
    51  In addition to the arguments listed above, the following computed attributes are
    52  exported:
    53  
    54  * `gateway_ipv4` - The IPv4 address of the gateway.
    55  
    56  * `name` - The unique name of the network.
    57  
    58  * `self_link` - The URI of the created resource.
    59  
    60  
    61  ## Import
    62  
    63  Networks can be imported using the `name`, e.g.
    64  
    65  ```
    66  $ terraform import google_compute_network.public my_network_name
    67  ```