你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

DataDisk 类

描述数据磁盘。

变量仅由服务器填充，在发送请求时将被忽略。

必须填充所有必需的参数才能发送到 Azure。

继承

azure.mgmt.compute._serialization.Model

DataDisk

构造函数

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

lun

int

指定数据磁盘的逻辑单元号。 此值用于标识 VM 中的数据磁盘，因此对于附加到 VM 的每个数据磁盘必须是唯一的。 必需。

name

str

磁盘名称。

vhd

VirtualHardDisk

虚拟硬盘。

image

VirtualHardDisk

源用户映像虚拟硬盘。 在附加到虚拟机之前，将复制虚拟硬盘。 如果提供了 SourceImage，则目标虚拟硬盘驱动器不得存在。

caching

str 或 CachingTypes

指定缓存要求。 可能的值为： None、ReadOnly、ReadWrite。 对于标准存储，默认行为为： 无。高级存储的 ReadOnly。 已知值为：“None”、“ReadOnly”和“ReadWrite”。

write_accelerator_enabled

bool

指定是在磁盘上启用或禁用 writeAccelerator。

create_option

str 或 DiskCreateOptionTypes

指定应如何创建虚拟机。 可能的值为： Attach。 使用专用磁盘创建虚拟机时，将使用此值。 FromImage。 使用映像创建虚拟机时，将使用此值。 如果使用平台映像，还应使用上述 imageReference 元素。 如果使用市场映像，还应使用前面所述的 plan 元素。 必需。 已知值为：“FromImage”、“Empty”和“Attach”。

disk_size_gb

int

指定空数据磁盘的大小（以 GB 为单位）。 此元素可用于覆盖虚拟机映像中的磁盘大小。 属性“diskSizeGB”是磁盘的字节数 x 1024^3，该值不能大于 1023。

managed_disk

ManagedDiskParameters

托管磁盘参数。

to_be_detached

bool

指定数据磁盘是否正在从 VirtualMachine/VirtualMachineScaleset 分离。

detach_option

str 或 DiskDetachOptionTypes

指定要在分离磁盘时使用的分离行为或已在从虚拟机分离过程中的分离行为。 支持的值： ForceDetach。 detachOption： ForceDetach 仅适用于托管数据磁盘。 如果数据磁盘的上一次分离尝试由于虚拟机意外故障而未完成，并且磁盘仍未释放，请使用强制分离作为最后手段，从 VM 中强行分离磁盘。 使用此分离行为时，可能尚未刷新所有写入。 此功能仍处于预览 模式，VirtualMachineScaleSet 不支持此功能。 强制分离数据磁盘更新到BeDetached 到“true”，同时设置 detachOption：“ForceDetach”。 “ForceDetach”

delete_option

str 或 DiskDeleteOptionTypes

指定在删除 VM 时是应删除还是分离数据磁盘。 可能的值为： Delete。 如果使用此值，则删除 VM 时会删除数据磁盘。 分离。 如果使用此值，则删除 VM 后会保留数据磁盘。 默认值设置为 Detach。 已知值为：“Delete”和“Detach”。

变量

lun

int

指定数据磁盘的逻辑单元号。 此值用于标识 VM 中的数据磁盘，因此对于附加到 VM 的每个数据磁盘必须是唯一的。 必需。

name

str

磁盘名称。

vhd

VirtualHardDisk

虚拟硬盘。

image

VirtualHardDisk

源用户映像虚拟硬盘。 在附加到虚拟机之前，将复制虚拟硬盘。 如果提供了 SourceImage，则目标虚拟硬盘驱动器不得存在。

caching

str 或 CachingTypes

指定缓存要求。 可能的值为： None、ReadOnly、ReadWrite。 对于标准存储，默认行为为： 无。高级存储的 ReadOnly。 已知值为：“None”、“ReadOnly”和“ReadWrite”。

write_accelerator_enabled

bool

指定是在磁盘上启用或禁用 writeAccelerator。

create_option

str 或 DiskCreateOptionTypes

指定应如何创建虚拟机。 可能的值为： Attach。 使用专用磁盘创建虚拟机时，将使用此值。 FromImage。 使用映像创建虚拟机时，将使用此值。 如果使用平台映像，还应使用上述 imageReference 元素。 如果使用市场映像，还应使用前面所述的 plan 元素。 必需。 已知值为：“FromImage”、“Empty”和“Attach”。

disk_size_gb

int

指定空数据磁盘的大小（以 GB 为单位）。 此元素可用于覆盖虚拟机映像中的磁盘大小。 属性“diskSizeGB”是磁盘的字节数 x 1024^3，该值不能大于 1023。

managed_disk

ManagedDiskParameters

托管磁盘参数。

to_be_detached

bool

指定数据磁盘是否正在从 VirtualMachine/VirtualMachineScaleset 分离。

disk_iops_read_write

int

指定UltraSSD_LRS StorageAccountType 时托管磁盘的 Read-Write IOPS。 仅针对 VirtualMachine ScaleSet VM 磁盘返回。 只能通过对 VirtualMachine 规模集的更新进行更新。

disk_m_bps_read_write

int

UltraSSD_LRS StorageAccountType 时，指定托管磁盘的带宽（以 MB/秒为单位）。 仅针对 VirtualMachine ScaleSet VM 磁盘返回。 只能通过对 VirtualMachine 规模集的更新进行更新。

detach_option

str 或 DiskDetachOptionTypes

指定要在分离磁盘时使用的分离行为或已在从虚拟机分离过程中的分离行为。 支持的值： ForceDetach。 detachOption： ForceDetach 仅适用于托管数据磁盘。 如果数据磁盘的上一次分离尝试由于虚拟机意外故障而未完成，并且磁盘仍未释放，请使用强制分离作为最后手段，从 VM 中强行分离磁盘。 使用此分离行为时，可能尚未刷新所有写入。 此功能仍处于预览 模式，VirtualMachineScaleSet 不支持此功能。 强制分离数据磁盘更新到BeDetached 到“true”，同时设置 detachOption：“ForceDetach”。 “ForceDetach”

delete_option

str 或 DiskDeleteOptionTypes

指定在删除 VM 时是应删除还是分离数据磁盘。 可能的值为： Delete。 如果使用此值，则删除 VM 时会删除数据磁盘。 分离。 如果使用此值，则删除 VM 后会保留数据磁盘。 默认值设置为 Detach。 已知值为：“Delete”和“Detach”。