如何获取已注册的自有Azure镜像？解决az vm image list仅返回公共镜像问题

数据老陈

2026-5-19

获取Azure自有镜像列表的方法

嗨，我懂你现在的困惑——默认情况下az vm image list确实只会返回公共镜像库的内容，要查看自己上传、捕获或者注册的私有镜像，得用针对性的命令或参数，下面给你几种实用的方法：

查看指定资源组下的托管镜像
如果你是把镜像作为托管镜像（Managed Image）存在资源组里，直接用az image list命令就行，它专门用来枚举用户自有托管镜像：
```
az image list --resource-group your-resource-group-name --output table
```
加上--output table能让输出格式更易读，你也可以换成json或yaml来适配脚本需求。如果想查看订阅下所有资源组的自有镜像，去掉--resource-group参数即可。
查看共享镜像库（Shared Image Gallery）中的镜像
很多团队会用共享镜像库来集中管理私有镜像，这种情况下要用专门的共享镜像库命令：
1. 先列出镜像库中的镜像定义（包含镜像的基础信息）：
```
az sig image-definition list --resource-group your-resource-group --gallery-name your-gallery-name --output table
```
2. 再查看某个镜像定义下的具体版本：
```
az sig image-version list --resource-group your-resource-group --gallery-name your-gallery-name --gallery-image-definition your-image-def-name --output table
```
用az vm image list定向查询私有镜像
如果你知道自己的镜像所在的存储位置，也可以给az vm image list加上参数来精准查询，比如指定资源组和订阅：
```
az vm image list --resource-group your-resource-group --subscription your-subscription-id --output table
```
不过这个方法不如前面两种直接，更推荐用专门的镜像枚举命令。