github.com/candidpartners/terraform@v0.9.5-0.20171005231213-29f5f88820f6/website/source/docs/providers/netapp/r/cloud_volume.html.markdown (about)

     1  ---
     2  layout: "netapp"
     3  page_title: "NetApp: netapp_cloud_volume"
     4  sidebar_current: "docs-netapp-resource-cloud-volume"
     5  description: |-
     6    Creates and manages NetApp OCCM volumes.
     7  ---
     8  
     9  # netapp\_cloud\_volume
    10  
    11  The ``netapp_cloud_volume`` resource creates and manages NetApp OCCM volumes.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "netapp_cloud_volume" "vsa-cifs-volume" {
    17    workenv_id = "${data.netapp_cloud_workenv.vsa-workenv.public_id}"
    18    svm_name = "${data.netapp_cloud_workenv.vsa-workenv.svm_name}"
    19    name = "cifs_vol"
    20    type = "cifs"
    21    size = 1
    22    size_unit = "GB"
    23    snapshot_policy = "default"
    24    provider_volume_type = "sc1"
    25    share {
    26      name = "my_cifs_share"
    27      permission {
    28        type = "read"
    29        users = ["Everyone"]
    30      }
    31    }
    32  }
    33  ```
    34  
    35  ```hcl
    36  resource "netapp_cloud_volume" "vsa-nfs-volume" {
    37    workenv_id = "${data.netapp_cloud_workenv.vsa-workenv.public_id}"
    38    svm_name = "${data.netapp_cloud_workenv.vsa-workenv.svm_name}"
    39    name = "nfs_vol"
    40    type = "nfs"
    41    size = 1
    42    size_unit = "GB"
    43    snapshot_policy = "default"
    44    export_policy = ["10.11.12.13/32"]
    45    provider_volume_type = "gp2"
    46  }
    47  ```
    48  
    49  ## Argument Reference
    50  
    51  The following arguments are supported:
    52  
    53  * `workenv_id` - (Required) Volume working environment ID.
    54  
    55  * `svm_name` - (Required) Volume SVN name.
    56  
    57  * `aggregate_name` - (Optional) Aggregate name where the volume should be created.
    58  
    59  * `name` - (Required) Name for the volume.
    60  
    61  * `type` - (Required) Volume type (`nfs` or `cifs`)
    62  
    63  * `size` - (Required) Numeric volume size.
    64  
    65  * `size_unit` - (Required) Size unit (`GB` or `TB`).
    66  
    67  * `initial_size` - (Optional) Numeric initial volume size.
    68  
    69  * `initial_size_unit` - (Optional) Initial size unit (`GB` or `TB`).
    70  
    71  * `snapshot_policy` - (Optional) Snapshot policy name for volume.
    72  
    73  * `export_policy` - (Optional) Export policy for NFS volumes (default value is `none`).
    74  
    75  * `share` - (Required for CIFS) Share details for CIFS volumes.
    76  
    77  * `thin_provisioning` - (Optional) Volume thin provisioning flag (default value is `true`).
    78  
    79  * `compression` - (Optional) Volume compression flag (default value is `true`).
    80  
    81  * `deduplication` - (Optional) Volume deduplication flag (default value is `true`).
    82  
    83  * `max_num_disks_approved_to_add` - (Optional) Maximum number of disks allowed to be added when creating the volume.
    84  
    85  * `verify_name_uniqueness` - (Optional) Indicates if name uniqueness check should be performed.
    86  
    87  * `provider_volume_type` - (Optional) Disk type for the volume (`gp2`, `st1`, `io1` or `sc1`, default value is `gp2`).
    88  
    89  * `iops` - (Required for `io1` disk type) IOPS to provision for the volume.
    90  
    91  * `sync_to_s3` - (Optional) Indicates if volume data should be sent to S3. Only applicable for working environments that support S3 sync.
    92  
    93  * `capacity_tier` - (Optional) Volume capacity tier (i.e. `S3`).
    94  
    95  * `create_aggregate_if_not_found` - (Optional) Used with `aggregate_name`, if aggregate name does not exist, this flag controls whether the aggregate will get created.
    96  
    97  ## Import
    98  
    99  Volumes can be imported using the `resource name`, e.g.
   100  
   101  ```shell
   102  $ terraform import netapp_cloud_volume.vol1 example
   103  ```