github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/packet/r/volume.html.markdown (about)

     1  ---
     2  layout: "packet"
     3  page_title: "Packet: packet_volume"
     4  sidebar_current: "docs-packet-resource-volume"
     5  description: |-
     6    Provides a Packet Block Storage Volume Resource.
     7  ---
     8  
     9  # packet\_volume
    10  
    11  Provides a Packet Block Storage Volume resource to allow you to
    12  manage block volumes on your account.
    13  Once created by Terraform, they must then be attached and mounted
    14  using the api and `packet_block_attach` and `packet_block_detach`
    15  scripts.
    16  
    17  ## Example Usage
    18  
    19  ```hcl
    20  # Create a new block volume
    21  resource "packet_volume" "volume1" {
    22    description   = "terraform-volume-1"
    23    facility      = "ewr1"
    24    project_id    = "${packet_project.cool_project.id}"
    25    plan          = "storage_1"
    26    size          = 100
    27    billing_cycle = "hourly"
    28  
    29    snapshot_policies = {
    30      snapshot_frequency = "1day"
    31  
    32      snapshot_count = 7
    33    }
    34  
    35    snapshot_policies = {
    36      snapshot_frequency = "1month"
    37  
    38      snapshot_count = 6
    39    }
    40  }
    41  ```
    42  
    43  ## Argument Reference
    44  
    45  The following arguments are supported:
    46  
    47  * `plan` - (Required) The service plan slug of the volume
    48  * `facility` - (Required) The facility to create the volume in
    49  * `project_id` - (Required) The packet project ID to deploy the volume in
    50  * `size` - (Required) The size in GB to make the volume
    51  * `billing_cycle` - The billing cycle, defaults to "hourly"
    52  * `description` - Optional description for the volume
    53  * `snapshot_policies` - Optional list of snapshot policies
    54  
    55  ## Attributes Reference
    56  
    57  The following attributes are exported:
    58  
    59  * `id` - The unique ID of the volume
    60  * `name` - The name of the volume
    61  * `description` - The description of the volume
    62  * `size` - The size in GB of the volume
    63  * `plan` - Performance plan the volume is on
    64  * `billing_cycle` - The billing cycle, defaults to hourly
    65  * `facility` - The facility slug the volume resides in
    66  * `state` - The state of the volume
    67  * `locked` - Whether the volume is locked or not
    68  * `project_id ` - The project id the volume is in
    69  * `created` - The timestamp for when the volume was created
    70  * `updated` - The timestamp for the last time the volume was updated