108 lines
3.2 KiB
Markdown
108 lines
3.2 KiB
Markdown
|
---
|
||
|
|
layout: "azurerm"
|
||
|
|
page_title: "Azure Resource Manager: azurerm_managed_disk"
|
||
|
|
sidebar_current: "docs-azurerm-resource-managed-disk"
|
||
|
|
description: |-
|
||
|
|
Create a Managed Disk.
|
||
|
|
---
|
||
|
|
|
||
|
|
# azurerm\_managed\_disk
|
||
|
|
|
||
|
|
Create a managed disk.
|
||
|
|
|
||
|
|
## Example Usage with Create Empty
|
||
|
|
|
||
|
|
```
|
||
|
|
resource "azurerm_resource_group" "test" {
|
||
|
|
name = "acctestrg"
|
||
|
|
location = "West US 2"
|
||
|
|
}
|
||
|
|
|
||
|
|
resource "azurerm_managed_disk" "test" {
|
||
|
|
name = "acctestmd"
|
||
|
|
location = "West US 2"
|
||
|
|
resource_group_name = "${azurerm_resource_group.test.name}"
|
||
|
|
storage_account_type = "Standard_LRS"
|
||
|
|
create_option = "Empty"
|
||
|
|
disk_size_gb = "1"
|
||
|
|
|
||
|
|
tags {
|
||
|
|
environment = "staging"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example Usage with Create Copy
|
||
|
|
|
||
|
|
```
|
||
|
|
resource "azurerm_resource_group" "test" {
|
||
|
|
name = "acctestrg"
|
||
|
|
location = "West US 2"
|
||
|
|
}
|
||
|
|
|
||
|
|
resource "azurerm_managed_disk" "source" {
|
||
|
|
name = "acctestmd1"
|
||
|
|
location = "West US 2"
|
||
|
|
resource_group_name = "${azurerm_resource_group.test.name}"
|
||
|
|
storage_account_type = "Standard_LRS"
|
||
|
|
create_option = "Empty"
|
||
|
|
disk_size_gb = "1"
|
||
|
|
|
||
|
|
tags {
|
||
|
|
environment = "staging"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
resource "azurerm_managed_disk" "copy" {
|
||
|
|
name = "acctestmd2"
|
||
|
|
location = "West US 2"
|
||
|
|
resource_group_name = "${azurerm_resource_group.test.name}"
|
||
|
|
storage_account_type = "Standard_LRS"
|
||
|
|
create_option = "Copy"
|
||
|
|
source_resource_id = "${azurerm_managed_disk.source.id}"
|
||
|
|
disk_size_gb = "1"
|
||
|
|
|
||
|
|
tags {
|
||
|
|
environment = "staging"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Argument Reference
|
||
|
|
|
||
|
|
The following arguments are supported:
|
||
|
|
|
||
|
|
* `name` - (Required) Specifies the name of the managed disk. Changing this forces a
|
||
|
|
new resource to be created.
|
||
|
|
* `resource_group_name` - (Required) The name of the resource group in which to create
|
||
|
|
the managed disk.
|
||
|
|
* `location` - (Required) Specified the supported Azure location where the resource exists.
|
||
|
|
Changing this forces a new resource to be created.
|
||
|
|
* `storage_account_type` - (Required) The type of storage to use for the managed disk.
|
||
|
|
Allowable values are `Standard_LRS` or `Premium_LRS`.
|
||
|
|
* `create_option` - (Required) The method to use when creating the managed disk.
|
||
|
|
* `Import` - Import a VHD file in to the managed disk (VHD specified with `source_uri`).
|
||
|
|
* `Empty` - Create an empty managed disk.
|
||
|
|
* `Copy` - Copy an existing managed disk or snapshot (specified with `source_resource_id`).
|
||
|
|
* `source_uri` - (Optional) URI to a valid VHD file to be used when `create_option` is `Import`.
|
||
|
|
* `source_resource_id` - (Optional) ID of an existing managed disk to copy when `create_option` is `Copy`.
|
||
|
|
* `os_type` - (Optional) Specify a value when the source of an `Import` or `Copy`
|
||
|
|
operation targets a source that contains an operating system. Valid values are `Linux` or `Windows`
|
||
|
|
* `disk_size_gb` - (Required) Specifies the size of the managed disk to create in gigabytes.
|
||
|
|
If `create_option` is `Copy`, then the value must be equal to or greater than the source's size.
|
||
|
|
* `tags` - (Optional) A mapping of tags to assign to the resource.
|
||
|
|
|
||
|
|
## Attributes Reference
|
||
|
|
|
||
|
|
The following attributes are exported:
|
||
|
|
|
||
|
|
* `id` - The managed disk ID.
|
||
|
|
|
||
|
|
## Import
|
||
|
|
|
||
|
|
Managed Disks can be imported using the `resource id`, e.g.
|
||
|
|
|
||
|
|
```
|
||
|
|
terraform import azurerm_managed_disk.test /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/microsoft.compute/disks/manageddisk1
|
||
|
|
```
|