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

Disk 类

磁盘资源。

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

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

继承
azure.mgmt.compute.v2023_01_02.models._models_py3.Resource
Disk

构造函数

Disk(*, location: str, tags: Dict[str, str] | None = None, sku: _models.DiskSku | None = None, zones: List[str] | None = None, extended_location: _models.ExtendedLocation | None = None, os_type: str | _models.OperatingSystemTypes | None = None, hyper_v_generation: str | _models.HyperVGeneration | None = None, purchase_plan: _models.PurchasePlan | None = None, supported_capabilities: _models.SupportedCapabilities | None = None, creation_data: _models.CreationData | None = None, disk_size_gb: int | None = None, encryption_settings_collection: _models.EncryptionSettingsCollection | None = None, disk_iops_read_write: int | None = None, disk_m_bps_read_write: int | None = None, disk_iops_read_only: int | None = None, disk_m_bps_read_only: int | None = None, encryption: _models.Encryption | None = None, max_shares: int | None = None, network_access_policy: str | _models.NetworkAccessPolicy | None = None, disk_access_id: str | None = None, tier: str | None = None, bursting_enabled: bool | None = None, supports_hibernation: bool | None = None, security_profile: _models.DiskSecurityProfile | None = None, completion_percent: float | None = None, public_network_access: str | _models.PublicNetworkAccess | None = None, data_access_auth_mode: str | _models.DataAccessAuthMode | None = None, optimized_for_frequent_attach: bool | None = None, **kwargs: Any)

Keyword-Only Parameters

location
str

资源位置。 必需。

tags
dict[str, str]

资源标记。

sku
DiskSku

磁盘 SKU 名称。 可以是Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS、Premium_ZRS、StandardSSD_ZRS或PremiumV2_LRS。

zones
list[str]

磁盘的逻辑区域列表。

extended_location
ExtendedLocation

要在其中创建磁盘的扩展位置。 无法更改扩展位置。

os_type
strOperatingSystemTypes

操作系统类型。 已知值为:“Windows”和“Linux”。

hyper_v_generation
strHyperVGeneration

虚拟机的虚拟机监控程序生成。 仅适用于 OS 磁盘。 已知值为:“V1”和“V2”。

purchase_plan
PurchasePlan

从中创建 OS 磁盘的映像的购买计划信息。 例如 - {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}。

supported_capabilities
SupportedCapabilities

从中创建 OS 磁盘的映像支持的功能列表。

creation_data
CreationData

磁盘源信息。 创建磁盘后,无法更改创建数据信息。

disk_size_gb
int

如果 creationData.createOption 为空,则此字段是必需的,它指示要创建的磁盘的大小。 如果存在此字段用于更新或创建其他选项,则表示调整大小。 仅当磁盘未附加到正在运行的 VM 时,才允许调整大小,并且只能增加磁盘的大小。

encryption_settings_collection
EncryptionSettingsCollection

用于 Azure 磁盘加密的加密设置集合可以包含每个磁盘或快照的多个加密设置。

disk_iops_read_write
int

此磁盘允许的 IOPS 数;只能为 UltraSSD 磁盘设置。 一个操作可以在 4k 到 256k 字节之间传输。

disk_m_bps_read_write
int

此磁盘允许的带宽;只能为 UltraSSD 磁盘设置。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,幂为 10。

disk_iops_read_only
int

将共享磁盘装载为 ReadOnly 的所有 VM 中允许的 IOPS 总数。 一个操作可以在 4k 到 256k 字节之间传输。

disk_m_bps_read_only
int

总吞吐量 (MBps) ,将允许跨所有 VM 装载共享磁盘为 ReadOnly。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,幂为 10。

encryption
Encryption

加密属性可用于使用客户管理的密钥或平台管理的密钥加密静态数据。

max_shares
int

可以同时附加到磁盘的最大 VM 数。 大于 1 的值表示可以同时装载到多个 VM 上的磁盘。

network_access_policy
strNetworkAccessPolicy

用于通过网络访问磁盘的策略。 已知值为:“AllowAll”、“AllowPrivate”和“DenyAll”。

disk_access_id
str

用于在磁盘上使用专用终结点的 DiskAccess 资源的 ARM ID。

tier
str

磁盘的性能层 (例如 P4、S10) ,如下所述: https://azure.microsoft.com/en-us/pricing/details/managed-disks/。 不适用于超级磁盘。

bursting_enabled
bool

设置为 true 可启用超出磁盘预配性能目标的突发。 默认情况下,突发处于禁用状态。 不适用于超级磁盘。

supports_hibernation
bool

指示磁盘上的 OS 支持休眠。

security_profile
DiskSecurityProfile

包含资源的安全相关信息。

completion_percent
float

通过 CopyStart 操作创建资源时后台副本的完成百分比。

public_network_access
strPublicNetworkAccess

用于控制磁盘导出的策略。 已知值为:“Enabled”和“Disabled”。

data_access_auth_mode
strDataAccessAuthMode

导出或上传到磁盘或快照时的其他身份验证要求。 已知值为:“AzureActiveDirectory”和“None”。

optimized_for_frequent_attach
bool

将此属性设置为 true 可提高每天 (超过 5 次的数据磁盘的可靠性和性能,) 从一个虚拟机分离并附加到另一个虚拟机。 不应为未频繁分离和附加的磁盘设置此属性,因为这会导致磁盘与虚拟机的容错域不一致。

变量

id
str

资源 ID。

name
str

资源名称。

type
str

资源类型。

location
str

资源位置。 必需。

tags
dict[str, str]

资源标记。

managed_by
str

包含附加了磁盘的 VM ID 的相对 URI。

managed_by_extended
list[str]

包含附加了磁盘的 VM ID 的相对 URI 列表。 对于磁盘,maxShares 应设置为大于 1 的值,以允许将其附加到多个 VM。

sku
DiskSku

磁盘 SKU 名称。 可以是Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS、Premium_ZRS、StandardSSD_ZRS或PremiumV2_LRS。

zones
list[str]

磁盘的逻辑区域列表。

extended_location
ExtendedLocation

要在其中创建磁盘的扩展位置。 无法更改扩展位置。

time_created
datetime

创建磁盘的时间。

os_type
strOperatingSystemTypes

操作系统类型。 已知值为:“Windows”和“Linux”。

hyper_v_generation
strHyperVGeneration

虚拟机的虚拟机监控程序生成。 仅适用于 OS 磁盘。 已知值为:“V1”和“V2”。

purchase_plan
PurchasePlan

从中创建 OS 磁盘的映像的购买计划信息。 例如 - {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}。

supported_capabilities
SupportedCapabilities

从中创建 OS 磁盘的映像支持的功能列表。

creation_data
CreationData

磁盘源信息。 创建磁盘后,无法更改创建数据信息。

disk_size_gb
int

如果 creationData.createOption 为空,则此字段是必需的,它指示要创建的磁盘的大小。 如果存在此字段用于更新或创建其他选项,则表示调整大小。 仅当磁盘未附加到正在运行的 VM 时,才允许调整大小,并且只能增加磁盘的大小。

disk_size_bytes
int

磁盘的大小(以字节为单位)。 该字段是只读字段。

unique_id
str

标识资源的唯一 Guid。

encryption_settings_collection
EncryptionSettingsCollection

用于 Azure 磁盘加密的加密设置集合可以包含每个磁盘或快照的多个加密设置。

provisioning_state
str

磁盘预配状态。

disk_iops_read_write
int

此磁盘允许的 IOPS 数;只能为 UltraSSD 磁盘设置。 一个操作可以在 4k 到 256k 字节之间传输。

disk_m_bps_read_write
int

此磁盘允许的带宽;只能为 UltraSSD 磁盘设置。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,幂为 10。

disk_iops_read_only
int

将共享磁盘装载为 ReadOnly 的所有 VM 中允许的 IOPS 总数。 一个操作可以在 4k 到 256k 字节之间传输。

disk_m_bps_read_only
int

总吞吐量 (MBps) ,将允许跨所有 VM 装载共享磁盘为 ReadOnly。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,幂为 10。

disk_state
strDiskState

磁盘的状态。 已知值为:“Unattached”、“Attached”、“Reserved”、“Frozen”、“ActiveSAS”、“ActiveSASFrozen”、“ReadyToUpload”和“ActiveUpload”。

encryption
Encryption

加密属性可用于使用客户管理的密钥或平台管理的密钥加密静态数据。

max_shares
int

可以同时附加到磁盘的最大 VM 数。 大于 1 的值表示可以同时装载到多个 VM 上的磁盘。

share_info
list[ShareInfoElement]

附加了磁盘的所有 VM 的列表的详细信息。 对于磁盘,maxShares 应设置为大于 1 的值,以允许将其附加到多个 VM。

network_access_policy
strNetworkAccessPolicy

用于通过网络访问磁盘的策略。 已知值为:“AllowAll”、“AllowPrivate”和“DenyAll”。

disk_access_id
str

用于在磁盘上使用专用终结点的 DiskAccess 资源的 ARM ID。

bursting_enabled_time
datetime

上次在磁盘上启用突发的时间。

tier
str

磁盘的性能层 (例如 P4、S10) ,如此处所述: https://azure.microsoft.com/en-us/pricing/details/managed-disks/。 不适用于超级磁盘。

bursting_enabled
bool

设置为 true 可启用超出磁盘预配的性能目标的突发。 默认情况下,突发处于禁用状态。 不适用于超级磁盘。

property_updates_in_progress
PropertyUpdatesInProgress

等待更新的磁盘的属性。

supports_hibernation
bool

指示磁盘上的 OS 支持休眠。

security_profile
DiskSecurityProfile

包含资源的安全相关信息。

completion_percent
float

通过 CopyStart 操作创建资源时后台副本的完成百分比。

public_network_access
strPublicNetworkAccess

用于控制磁盘上的导出的策略。 已知值为:“Enabled”和“Disabled”。

data_access_auth_mode
strDataAccessAuthMode

导出或上传到磁盘或快照时的其他身份验证要求。 已知值为:“AzureActiveDirectory”和“None”。

optimized_for_frequent_attach
bool

将此属性设置为 true 可提高数据磁盘的可靠性和性能,这些磁盘通过从一个虚拟机分离并附加到另一个虚拟机,) 每天经常 (5 次以上。 不应为未频繁分离和附加的磁盘设置此属性,因为这会导致磁盘与虚拟机的容错域不一致。