github.com/ves/terraform@v0.8.0-beta2/website/source/docs/providers/aws/r/volume_attachment.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_volume_attachment"
     4  sidebar_current: "docs-aws-resource-volume-attachment"
     5  description: |-
     6    Provides an AWS EBS Volume Attachment
     7  ---
     8  
     9  # aws\_volume\_attachment
    10  
    11  Provides an AWS EBS Volume Attachment as a top level resource, to attach and
    12  detach volumes from AWS Instances.
    13  
    14  ~> **NOTE on EBS block devices:** If you use `ebs_block_device` on an `aws_instance`, Terraform will assume management over the full set of non-root EBS block devices for the instance, and treats additional block devices as drift. For this reason, `ebs_block_device` cannot be mixed with external `aws_ebs_volume` + `aws_ebs_volume_attachment` resources for a given instance.
    15  
    16  ## Example Usage
    17  
    18  ```
    19  resource "aws_volume_attachment" "ebs_att" {
    20    device_name = "/dev/sdh"
    21    volume_id = "${aws_ebs_volume.example.id}"
    22    instance_id = "${aws_instance.web.id}"
    23  }
    24  
    25  resource "aws_instance" "web" {
    26    ami = "ami-21f78e11"
    27    availability_zone = "us-west-2a"
    28    instance_type = "t1.micro"
    29    tags {
    30      Name = "HelloWorld"
    31    }
    32  }
    33  
    34  resource "aws_ebs_volume" "example" {
    35    availability_zone = "us-west-2a"
    36    size = 1
    37  }
    38  ```
    39  
    40  ## Argument Reference
    41  
    42  The following arguments are supported:
    43  
    44  * `device_name` - (Required) The device name to expose to the instance (for 
    45  example, `/dev/sdh` or `xvdh`)
    46  * `instance_id` - (Required) ID of the Instance to attach to
    47  * `volume_id` - (Required) ID of the Volume to be attached
    48  * `force_detach` - (Optional, Boolean) Set to `true` if you want to force the
    49  volume to detach. Useful if previous attempts failed, but use this option only 
    50  as a last resort, as this can result in **data loss**. See 
    51  [Detaching an Amazon EBS Volume from an Instance][1] for more information.
    52  * `skip_destroy` - (Optional, Boolean) Set this to true if you do not wish 
    53  to detach the volume from the instance to which it is attached at destroy 
    54  time, and instead just remove the attachment from Terraform state. This is 
    55  useful when destroying an instance which has volumes created by some other 
    56  means attached.
    57  
    58  ## Attributes Reference
    59  
    60  * `device_name` - The device name exposed to the instance
    61  * `instance_id` - ID of the Instance
    62  * `volume_id` - ID of the Volume 
    63  
    64  [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-detaching-volume.html