你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az disk
管理 Azure 托管磁盘。
Azure 虚拟机使用磁盘作为存储操作系统、应用程序和数据的位置。 所有 Azure 虚拟机至少有两个磁盘:操作系统磁盘和临时磁盘。 操作系统磁盘基于映像创建,操作系统磁盘和该映像实际上都存储在 Azure 存储帐户中的虚拟硬盘 (VHD) 内。 虚拟机还可以有一个或多个数据磁盘,而这些磁盘也存储为 VHD。 Azure 非托管数据磁盘的最大大小为 4095 GB。 若要使用大于 4095 GB 的磁盘,请使用 Azure 托管磁盘。
命令
名称 | 说明 | 类型 | 状态 |
---|---|---|---|
az disk create |
创建托管磁盘。 |
核心 | GA |
az disk delete |
删除托管磁盘。 |
核心 | GA |
az disk grant-access |
授予对托管磁盘的资源访问权限。 |
核心 | GA |
az disk list |
列出托管磁盘。 |
核心 | GA |
az disk revoke-access |
撤销对托管磁盘的读取访问权限。 |
核心 | GA |
az disk show |
获取有关磁盘的信息。 |
核心 | GA |
az disk update |
更新托管磁盘。 |
核心 | GA |
az disk wait |
将 CLI 置于等待状态,直到满足条件。 |
核心 | GA |
az disk create
创建托管磁盘。
az disk create --name
--resource-group
[--accelerated-network {false, true}]
[--architecture {Arm64, x64}]
[--data-access-auth-mode {AzureActiveDirectory, None}]
[--disk-access]
[--disk-encryption-set]
[--disk-iops-read-only]
[--disk-iops-read-write]
[--disk-mbps-read-only]
[--disk-mbps-read-write]
[--edge-zone]
[--enable-bursting {false, true}]
[--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
[--gallery-image-reference]
[--gallery-image-reference-lun]
[--hyper-v-generation {V1, V2}]
[--image-reference]
[--image-reference-lun]
[--location]
[--logical-sector-size]
[--max-shares]
[--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
[--no-wait]
[--optimized-for-frequent-attach {false, true}]
[--os-type {Linux, Windows}]
[--performance-plus {false, true}]
[--public-network-access {Disabled, Enabled}]
[--secure-vm-disk-encryption-set]
[--security-data-uri]
[--security-type {ConfidentialVM_DiskEncryptedWithCustomerKey, ConfidentialVM_DiskEncryptedWithPlatformKey, ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey, Standard, TrustedLaunch}]
[--size-gb]
[--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
[--source]
[--source-storage-account-id]
[--support-hibernation {false, true}]
[--tags]
[--tier]
[--upload-size-bytes]
[--upload-type {Upload, UploadWithSecurityData}]
[--zone]
示例
通过从 Blob URI 导入来创建托管磁盘。
az disk create -g MyResourceGroup -n MyDisk --source https://vhd1234.blob.core.windows.net/vhds/osdisk1234.vhd
创建空托管磁盘。
az disk create -g MyResourceGroup -n MyDisk --size-gb 10
创建启用了突发的空托管磁盘。
az disk create -g MyResourceGroup -n MyDisk --size-gb 1024 --location centraluseuap --enable-bursting
通过复制现有磁盘或快照创建托管磁盘。
az disk create -g MyResourceGroup -n MyDisk2 --source MyDisk
在“美国东部 2”区域中的可用性区域中创建磁盘
az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --location eastus2 --zone 1
从映像创建磁盘。
az disk create -g MyResourceGroup -n MyDisk --image-reference Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest
从计算库映像版本的 OS 磁盘创建磁盘
az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0
从计算库映像中最新版本的 OS 磁盘创建磁盘
az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage
从共享库映像版本的 OS 磁盘创建磁盘
az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /SharedGalleries/sharedGalleryUniqueName/Images/imageName/Versions/1.0.0
从社区库映像版本的 OS 磁盘创建磁盘
az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /CommunityGalleries/communityGalleryPublicGalleryName/Images/imageName/Versions/1.0.0
从库映像的数据磁盘创建磁盘
az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0 --gallery-image-reference-lun 0
创建总 IOPS 和总吞吐量限制为 MBps 的磁盘。
az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --sku UltraSSD_LRS --disk-iops-read-only 200 --disk-mbps-read-only 30
创建磁盘并指定可以同时附加到磁盘的最大 VM 数。
az disk create -g MyResourceGroup -n MyDisk --size-gb 256 --max-shares 2 -l centraluseuap
创建磁盘并将其与磁盘访问资源相关联。
az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --network-access-policy AllowPrivate --disk-access MyDiskAccessID
从 VM 来宾状态 VHD 的 Blob URI 创建磁盘。
az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --security-data-uri GuestStateDiskVhdUri --security-type TrustedLaunch --hyper-v-generation V2
创建用于上传 Blob 的标准磁盘。
az disk create -g MyResourceGroup -n MyDisk --upload-size-bytes 20972032 --upload-type Upload
创建 OS 磁盘用于上传以及 VM 来宾状态。
az disk create -g MyResourceGroup -n MyDisk --upload-size-bytes 20972032 --upload-type UploadWithSecurityData --security-type TrustedLaunch --hyper-v-generation V2
必需参数
托管磁盘的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
客户可以在托管磁盘或快照上设置,以便在 OS 磁盘映像支持的情况下启用加速网络。
CPU 体系结构。
导出或上传到磁盘或快照时指定身份验证模式。
磁盘访问资源的名称或 ID,用于在磁盘上使用专用终结点。
用于加密磁盘的磁盘加密集的名称或 ID。
将允许在所有 VM 中以 ReadOnly 身份装载共享磁盘的 IOPS 总数。 一个操作可以在 4k 到 256k 字节之间传输。
此磁盘允许的 IOPS 数。 仅适用于 UltraSSD 磁盘。 一个操作可以在 4k 到 256k 字节之间传输。
所有装载共享磁盘的 VM(MBps)的总吞吐量(MBps)将作为 ReadOnly 装载。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,其幂为 10。
此磁盘允许的带宽。 仅适用于 UltraSSD 磁盘。 MBps 表示每秒数百万字节,其幂的 ISO 表示法为 10。
边缘区域的名称。
启用按需突发超出磁盘的预配性能目标。 默认情况下禁用按需突发,不适用于超级磁盘。
加密类型。 EncryptionAtRestWithPlatformKey:磁盘使用 XStore 托管密钥进行静态加密。 它是默认加密类型。 EncryptionAtRestWithCustomerKey:磁盘使用客户管理的密钥进行静态加密。
要从中创建磁盘的计算、共享或社区库映像版本的 ID。 有关有效格式的详细信息,请参阅帮助示例。
如果磁盘是从映像的数据磁盘创建的,则这是一个索引,指示要使用的映像中的数据磁盘。 对于 OS 磁盘,此字段为 null。
虚拟机的虚拟机监控程序生成。 仅适用于 OS 磁盘。
要从中创建磁盘的映像的 ID 或 URN (publisher:offer:sku:version)。
如果磁盘是从映像的数据磁盘创建的,则这是一个索引,指示要使用的映像中的数据磁盘。 对于 OS 磁盘,此字段为 null。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。 如果未指定位置且未指定默认位置,则位置将自动设置为与资源组相同。
超级磁盘的逻辑扇区大小(以字节为单位)。 支持的值为 512 和 4096。 4096 是默认值。
可以同时附加到磁盘的最大 VM 数。 大于一个值表示可以同时装载到多个 VM 上的磁盘。
通过网络访问磁盘的策略。
不等待长时间运行的操作完成。
将此属性设置为 true 可提高数据磁盘的可靠性和性能,这些磁盘通常(每天超过 5 次),方法是从一个虚拟机分离并附加到另一个虚拟机。 不应为未频繁分离和附加的磁盘设置此属性,因为它会导致磁盘与虚拟机的容错域不一致。
磁盘的操作系统类型。
将此标志设置为 true,以提升部署的磁盘的性能目标。 此标志只能在磁盘创建时设置,在启用后不能禁用。
客户可以在托管磁盘或快照上设置,以控制磁盘上的导出策略。
使用 ConfidentialVmEncryptedWithCustomerKey 加密类型创建的磁盘加密集的名称或 ID。
请指定要导入 VM 来宾状态的 VHD 的 Blob URI。
VM 的安全类型。 仅适用于 OS 磁盘。
大小(以 GB 为单位)。 最大大小:4095 GB(某些预览磁盘可能更大)。
基础存储 SKU。
要从中创建磁盘/快照的源,包括非托管 Blob URI、托管磁盘 ID 或名称,或快照 ID 或名称。
当源 Blob 位于其他订阅中时使用。
指示磁盘上的 OS 支持休眠。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
磁盘的性能层(例如 P4、S10)如下所述: https://azure.microsoft.com/pricing/details/managed-disks/ 不适用于超级磁盘。
上传内容的大小(以字节为单位),包括 VHD 页脚。 最小值:20972032。 最大值:35183298347520。 如果指定了 --upload-type,则此参数是必需的。
创建用于上传方案的磁盘。 “上传”仅适用于标准磁盘上传。 “UploadWithSecurityData”适用于 OS 磁盘上传以及 VM 来宾状态。 请注意,“UploadWithSecurityData”对于数据磁盘上传无效,它目前仅用于 OS 磁盘上传。
要在其中预配资源的可用性区域。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az disk delete
删除托管磁盘。
az disk delete [--disk-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
示例
删除托管磁盘。
az disk delete --name MyManagedDisk --resource-group MyResourceGroup
可选参数
正在创建的托管磁盘的名称。 创建磁盘后,无法更改该名称。 名称支持的字符为 a-z、A-Z、0-9、_ 和 -。 名称最大长度为 80 个字符。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
不提示确认。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az disk grant-access
授予对托管磁盘的资源访问权限。
az disk grant-access --duration-in-seconds
[--access-level {Read, Write}]
[--ids]
[--name]
[--resource-group]
[--secure-vm-guest-state-sas]
[--subscription]
示例
授予对托管磁盘的资源读取访问权限。 (自动生成)
az disk grant-access --access-level Read --duration-in-seconds 3600 --name MyManagedDisk --resource-group MyResourceGroup
授予对磁盘的资源读取访问权限,以生成访问 SAS 和安全数据访问 SAS
az disk grant-access --access-level Read --duration-in-seconds 3600 --name MyDisk --resource-group MyResourceGroup --secure-vm-guest-state-sas
必需参数
SAS 访问过期前的持续时间(以秒为单位)。
可选参数
访问级别。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
托管磁盘的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
在具有 VM 来宾状态的托管磁盘上获取 SAS。 默认情况下,当磁盘的 create 选项为“secureOSUpload”时,将使用它。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az disk list
列出托管磁盘。
az disk list [--max-items]
[--next-token]
[--resource-group]
可选参数
命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token
提供令牌值。
用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az disk revoke-access
撤销对托管磁盘的读取访问权限。
az disk revoke-access [--disk-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
示例
撤销对托管磁盘的读取访问权限。
az disk revoke-access --ids $id
撤销对托管磁盘的读取访问权限。
az disk revoke-access --name MyManagedDisk --resource-group MyResourceGroup
可选参数
正在创建的托管磁盘的名称。 创建磁盘后,无法更改该名称。 名称支持的字符为 a-z、A-Z、0-9、_ 和 -。 名称最大长度为 80 个字符。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az disk show
获取有关磁盘的信息。
az disk show [--disk-name]
[--ids]
[--resource-group]
[--subscription]
可选参数
正在创建的托管磁盘的名称。 创建磁盘后,无法更改该名称。 名称支持的字符为 a-z、A-Z、0-9、_ 和 -。 名称最大长度为 80 个字符。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az disk update
更新托管磁盘。
az disk update [--accelerated-network {false, true}]
[--add]
[--architecture {Arm64, x64}]
[--data-access-auth-mode {AzureActiveDirectory, None}]
[--disk-access]
[--disk-encryption-set]
[--disk-iops-read-only]
[--disk-iops-read-write]
[--disk-mbps-read-only]
[--disk-mbps-read-write]
[--enable-bursting {false, true}]
[--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
[--force-string]
[--ids]
[--max-shares]
[--name]
[--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
[--no-wait]
[--public-network-access {Disabled, Enabled}]
[--remove]
[--resource-group]
[--set]
[--size-gb]
[--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
[--subscription]
示例
更新托管磁盘并将其与磁盘访问资源相关联。
az disk update --name MyManagedDisk --resource-group MyResourceGroup --network-access-policy AllowPrivate --disk-access MyDiskAccessID
更新托管磁盘。 (自动生成)
az disk update --name MyManagedDisk --resource-group MyResourceGroup --size-gb 20
可选参数
客户可以在托管磁盘或快照上设置,以便在 OS 磁盘映像支持的情况下启用加速网络。
通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value, string or JSON string>
。
CPU 体系结构。
导出或上传到磁盘或快照时指定身份验证模式。
磁盘访问资源的名称或 ID,用于在磁盘上使用专用终结点。
用于加密磁盘的磁盘加密集的名称或 ID。
将允许在所有 VM 中以 ReadOnly 身份装载共享磁盘的 IOPS 总数。 一个操作可以在 4k 到 256k 字节之间传输。
此磁盘允许的 IOPS 数。 仅适用于 UltraSSD 磁盘。 一个操作可以在 4k 到 256k 字节之间传输。
所有装载共享磁盘的 VM(MBps)的总吞吐量(MBps)将作为 ReadOnly 装载。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,其幂为 10。
此磁盘允许的带宽。 仅适用于 UltraSSD 磁盘。 MBps 表示每秒数百万字节,其幂的 ISO 表示法为 10。
启用按需突发超出磁盘的预配性能目标。 默认情况下禁用按需突发,不适用于超级磁盘。
加密类型。 EncryptionAtRestWithPlatformKey:磁盘使用 XStore 托管密钥进行静态加密。 它是默认加密类型。 EncryptionAtRestWithCustomerKey:磁盘使用客户管理的密钥进行静态加密。
使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
可以同时附加到磁盘的最大 VM 数。 大于一个值表示可以同时装载到多个 VM 上的磁盘。
托管磁盘的名称。
通过网络访问磁盘的策略。
不等待长时间运行的操作完成。
客户可以在托管磁盘或快照上设置,以控制磁盘上的导出策略。
从列表中删除属性或元素。 示例: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>
。
大小(以 GB 为单位)。 最大大小:4095 GB(某些预览磁盘可能更大)。
基础存储 SKU。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az disk wait
将 CLI 置于等待状态,直到满足条件。
az disk wait [--created]
[--custom]
[--deleted]
[--disk-name]
[--exists]
[--ids]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到删除为止。
正在创建的托管磁盘的名称。 创建磁盘后,无法更改该名称。 名称支持的字符为 a-z、A-Z、0-9、_ 和 -。 名称最大长度为 80 个字符。
等待资源存在。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
轮询间隔(以秒为单位)。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
最大等待(以秒为单位)。
等到 provisioningState 更新为“Succeeded”。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。