github.com/atsaki/terraform@v0.4.3-0.20150919165407-25bba5967654/website/source/docs/providers/openstack/r/blockstorage_volume_v1.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "OpenStack: openstack_blockstorage_volume_v1"
     4  sidebar_current: "docs-openstack-resource-blockstorage-volume-v1"
     5  description: |-
     6    Manages a V1 volume resource within OpenStack.
     7  ---
     8  
     9  # openstack\_blockstorage\_volume_v1
    10  
    11  Manages a V1 volume resource within OpenStack.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "openstack_blockstorage_volume_v1" "volume_1" {
    17    region = "RegionOne"
    18    name = "tf-test-volume"
    19    description = "first test volume"
    20    size = 3
    21  }
    22  ```
    23  
    24  ## Argument Reference
    25  
    26  The following arguments are supported:
    27  
    28  * `region` - (Required) The region in which to create the volume. If
    29      omitted, the `OS_REGION_NAME` environment variable is used. Changing this
    30      creates a new volume.
    31  
    32  * `size` - (Required) The size of the volume to create (in gigabytes). Changing
    33      this creates a new volume.
    34  
    35  * `name` - (Optional) A unique name for the volume. Changing this updates the
    36      volume's name.
    37  
    38  * `description` - (Optional) A description of the volume. Changing this updates
    39      the volume's description.
    40  
    41  * `availability_zone` - (Optional) The availability zone for the volume.
    42      Changing this creates a new volume.
    43  
    44  * `image_id` - (Optional) The image ID from which to create the volume.
    45      Changing this creates a new volume.
    46  
    47  * `snapshot_id` - (Optional) The snapshot ID from which to create the volume.
    48      Changing this creates a new volume.
    49  
    50  * `source_vol_id` - (Optional) The volume ID from which to create the volume.
    51      Changing this creates a new volume.
    52  
    53  * `metadata` - (Optional) Metadata key/value pairs to associate with the volume.
    54      Changing this updates the existing volume metadata.
    55  
    56  * `volume_type` - (Optional) The type of volume to create.
    57      Changing this creates a new volume.
    58  
    59  ## Attributes Reference
    60  
    61  The following attributes are exported:
    62  
    63  * `region` - See Argument Reference above.
    64  * `size` - See Argument Reference above.
    65  * `name` - See Argument Reference above.
    66  * `description` - See Argument Reference above.
    67  * `availability_zone` - See Argument Reference above.
    68  * `image_id` - See Argument Reference above.
    69  * `source_vol_id` - See Argument Reference above.
    70  * `snapshot_id` - See Argument Reference above.
    71  * `metadata` - See Argument Reference above.
    72  * `volume_type` - See Argument Reference above.
    73  * `attachment` - If a volume is attached to an instance, this attribute will
    74      display the Attachment ID, Instance ID, and the Device as the Instance
    75      sees it.