DataDisk Class

Describes a data disk.

Variables are only populated by the server, and will be ignored when sending a request.

All required parameters must be populated in order to send to server.

Constructor

DataDisk(*, lun: int, create_option: str | _models.DiskCreateOptionTypes, name: str | None = None, vhd: _models.VirtualHardDisk | None = None, image: _models.VirtualHardDisk | None = None, caching: str | _models.CachingTypes | None = None, write_accelerator_enabled: bool | None = None, disk_size_gb: int | None = None, managed_disk: _models.ManagedDiskParameters | None = None, to_be_detached: bool | None = None, detach_option: str | _models.DiskDetachOptionTypes | None = None, delete_option: str | _models.DiskDeleteOptionTypes | None = None, **kwargs: Any)

Keyword-Only Parameters

Name	Description
lun	int Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. Required.
name	str The disk name. Default value: None
vhd	VirtualHardDisk The virtual hard disk. Default value: None
image	VirtualHardDisk The source user image virtual hard disk. The virtual hard disk will be copied before being attached to the virtual machine. If SourceImage is provided, the destination virtual hard drive must not exist. Default value: None
caching	str or CachingTypes Specifies the caching requirements. <br>``<br> Possible values are: <br>``<br> None <br>``<br> ReadOnly <br>``<br> ReadWrite <br>``<br> Default: None for Standard storage. ReadOnly for Premium storage. Known values are: "None", "ReadOnly", and "ReadWrite". Default value: None
write_accelerator_enabled	bool Specifies whether writeAccelerator should be enabled or disabled on the disk. Default value: None
create_option	str or DiskCreateOptionTypes Specifies how the virtual machine should be created.<br>``<br> Possible values are:<br>``<br> Attach u2013 This value is used when you are using a specialized disk to create the virtual machine.<br>``<br> FromImage u2013 This value is used when you are using an image to create the virtual machine. If you are using a platform image, you also use the imageReference element described above. If you are using a marketplace image, you also use the plan element previously described. Required. Known values are: "FromImage", "Empty", and "Attach".
disk_size_gb	int Specifies the size of an empty data disk in gigabytes. This element can be used to overwrite the size of the disk in a virtual machine image. <br>``<br> This value cannot be larger than 1023 GB. Default value: None
managed_disk	ManagedDiskParameters The managed disk parameters. Default value: None
to_be_detached	bool Specifies whether the data disk is in process of detachment from the VirtualMachine/VirtualMachineScaleset. Default value: None
detach_option	str or DiskDetachOptionTypes Specifies the detach behavior to be used while detaching a disk or which is already in the process of detachment from the virtual machine. Supported values: ForceDetach. <br>``<br> detachOption: ForceDetach is applicable only for managed data disks. If a previous detachment attempt of the data disk did not complete due to an unexpected failure from the virtual machine and the disk is still not released then use force-detach as a last resort option to detach the disk forcibly from the VM. All writes might not have been flushed when using this detach behavior. <br>``<br> This feature is still in preview mode and is not supported for VirtualMachineScaleSet. To force-detach a data disk update toBeDetached to 'true' along with setting detachOption: 'ForceDetach'. "ForceDetach" Default value: None
delete_option	str or DiskDeleteOptionTypes Specifies whether data disk should be deleted or detached upon VM deletion.<br>``<br> Possible values: <br>``<br> Delete If this value is used, the data disk is deleted when VM is deleted.<br>``<br> Detach If this value is used, the data disk is retained after VM is deleted.<br>``<br> The default value is set to detach. Known values are: "Delete" and "Detach". Default value: None

Variables

Name	Description
lun	int Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. Required.
name	str The disk name.
vhd	VirtualHardDisk The virtual hard disk.
image	VirtualHardDisk The source user image virtual hard disk. The virtual hard disk will be copied before being attached to the virtual machine. If SourceImage is provided, the destination virtual hard drive must not exist.
caching	str or CachingTypes Specifies the caching requirements. <br>``<br> Possible values are: <br>``<br> None <br>``<br> ReadOnly <br>``<br> ReadWrite <br>``<br> Default: None for Standard storage. ReadOnly for Premium storage. Known values are: "None", "ReadOnly", and "ReadWrite".
write_accelerator_enabled	bool Specifies whether writeAccelerator should be enabled or disabled on the disk.
create_option	str or DiskCreateOptionTypes Specifies how the virtual machine should be created.<br>``<br> Possible values are:<br>``<br> Attach u2013 This value is used when you are using a specialized disk to create the virtual machine.<br>``<br> FromImage u2013 This value is used when you are using an image to create the virtual machine. If you are using a platform image, you also use the imageReference element described above. If you are using a marketplace image, you also use the plan element previously described. Required. Known values are: "FromImage", "Empty", and "Attach".
disk_size_gb	int Specifies the size of an empty data disk in gigabytes. This element can be used to overwrite the size of the disk in a virtual machine image. <br>``<br> This value cannot be larger than 1023 GB.
managed_disk	ManagedDiskParameters The managed disk parameters.
to_be_detached	bool Specifies whether the data disk is in process of detachment from the VirtualMachine/VirtualMachineScaleset.
disk_iops_read_write	int Specifies the Read-Write IOPS for the managed disk when StorageAccountType is UltraSSD_LRS. Returned only for VirtualMachine ScaleSet VM disks. Can be updated only via updates to the VirtualMachine Scale Set.
disk_m_bps_read_write	int Specifies the bandwidth in MB per second for the managed disk when StorageAccountType is UltraSSD_LRS. Returned only for VirtualMachine ScaleSet VM disks. Can be updated only via updates to the VirtualMachine Scale Set.
detach_option	str or DiskDetachOptionTypes Specifies the detach behavior to be used while detaching a disk or which is already in the process of detachment from the virtual machine. Supported values: ForceDetach. <br>``<br> detachOption: ForceDetach is applicable only for managed data disks. If a previous detachment attempt of the data disk did not complete due to an unexpected failure from the virtual machine and the disk is still not released then use force-detach as a last resort option to detach the disk forcibly from the VM. All writes might not have been flushed when using this detach behavior. <br>``<br> This feature is still in preview mode and is not supported for VirtualMachineScaleSet. To force-detach a data disk update toBeDetached to 'true' along with setting detachOption: 'ForceDetach'. "ForceDetach"
delete_option	str or DiskDeleteOptionTypes Specifies whether data disk should be deleted or detached upon VM deletion.<br>``<br> Possible values: <br>``<br> Delete If this value is used, the data disk is deleted when VM is deleted.<br>``<br> Detach If this value is used, the data disk is retained after VM is deleted.<br>``<br> The default value is set to detach. Known values are: "Delete" and "Detach".