terraform/website/source/docs/providers/alicloud/r/disk_attachment.html.markdown

---
layout: "alicloud"
page_title: "Alicloud: alicloud_disk_attachment"
sidebar_current: "docs-alicloud-resource-disk-attachment"
description: |-
  Provides a ECS Disk Attachment resource.
---

# alicloud\_disk\_attachment

Provides an Alicloud ECS Disk Attachment as a resource, to attach and detach disks from ECS Instances.

## Example Usage

Basic usage

```
# Create a new ECS disk-attachment and use it attach one disk to a new instance.

resource "alicloud_security_group" "ecs_sg" {
  name        = "terraform-test-group"
  description = "New security group"
}

resource "alicloud_disk" "ecs_disk" {
  availability_zone = "cn-beijing-a"
  size              = "50"

  tags {
    Name = "TerraformTest-disk"
  }
}

resource "alicloud_instance" "ecs_instance" {
  image_id              = "ubuntu_140405_64_40G_cloudinit_20161115.vhd"
  instance_type         = "ecs.s1.small"
  availability_zone     = "cn-beijing-a"
  security_groups       = ["${alicloud_security_group.ecs_sg.id}"]
  instance_name         = "Hello"
  instance_network_type = "classic"
  internet_charge_type  = "PayByBandwidth"

  tags {
    Name = "TerraformTest-instance"
  }
}

resource "alicloud_disk_attachment" "ecs_disk_att" {
  disk_id     = "${alicloud_disk.ecs_disk.id}"
  instance_id = "${alicloud_instance.ecs_instance.id}"
  device_name = "/dev/xvdb"
}
```
## Argument Reference

The following arguments are supported:

* `instance_id` - (Required, Forces new resource) ID of the Instance to attach to.
* `disk_id` - (Required, Forces new resource) ID of the Disk to be attached.
* `device_name` - (Required, Forces new resource) The device name to expose to the instance (for example, /dev/xvdb).

## Attributes Reference

The following attributes are exported:

* `instance_id` - ID of the Instance.
* `disk_id` - ID of the Disk.
* `device_name` - The device name exposed to the instance.