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

layout	page_title	sidebar_current	description
alicloud	Alicloud: alicloud_disk	docs-alicloud-resource-disk	Provides a ECS Disk resource.

alicloud_disk

Provides a ECS disk resource.

~> NOTE: One of size or snapshot_id is required when specifying an ECS disk. If all of them be specified, size must more than the size of snapshot which snapshot_id represents. Currently, alicloud_disk doesn't resize disk.

Example Usage

# Create a new ECS disk.
resource "alicloud_disk" "ecs_disk" {
    # cn-beijing
    availability_zone = "cn-beijing-b"
    name = "New-disk"
    description = "Hello ecs disk."
    category = "cloud_efficiency"
    size = "30"

    tags {
        Name = "TerraformTest"
    }
}

Argument Reference

The following arguments are supported:

• availability_zone - (Required, Forces new resource) The Zone to create the disk in.
• name - (Optional) Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.
• description - (Optional) Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
• category - (Optional, Forces new resource) Category of the disk. Valid values are cloud, cloud_efficiency and cloud_ssd. Default is cloud.
• size - (Required) The size of the disk in GiBs, and its value depends on Category. cloud disk value range: 5GB ~ 2000GB and other category disk value range: 20 ~ 32768.
• snapshot_id - (Optional) A snapshot to base the disk off of. If it is specified, size will be invalid and the disk size is equals to the snapshot size.
• tags - (Optional) A mapping of tags to assign to the resource.

Attributes Reference

The following attributes are exported:

• id - The disk ID.
• availability_zone - The Zone to create the disk in.
• name - The disk name.
• description - The disk description.
• status - The disk status.
• category - The disk category.
• size - The disk size.
• snapshot_id - The disk snapshot ID.
• tags - The disk tags.