你当前正在访问 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 获取完整的调试日志。
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈