aws ec2 describe-snapshots查询快照未返回Tags标签的问题咨询

问题现象 #

使用AWS CLI列举账户下所有EC2快照，希望获取快照关联的标签信息时，先后执行两版查询命令，所有快照返回结果中的tags字段均为null，无法拿到完整标签内容：

# 尝试版本1：查询表达式指定映射Tags数组的全量元素
AWS_PAGER="" aws ec2 describe-snapshots --max-items=1000  --region=us-east-1 --query 'Snapshots[*].{id: SnapshotId,startTime: startTime,tags:Tags[*]}'

# 尝试版本2：查询表达式直接映射原始Tags字段
AWS_PAGER="" aws ec2 describe-snapshots --max-items=1000  --region=us-east-1 --query 'Snapshots[*].{id: SnapshotId,startTime: startTime,tags:Tags}'

问题根因 #

出现全量快照标签返回null的核心原因，并非--query的查询表达式书写错误，而是调用DescribeSnapshots接口时缺少了所有者范围的过滤参数。
根据EC2接口的安全设计：

• 当查询时不指定快照所属的所有者范围，接口会默认将返回的快照归类为公共共享、跨账户授权共享的对象
• 出于跨账户数据隐私保护逻辑，这类场景下接口会刻意抹除每个快照的Tags字段，无论你账户下的快照实际打了多少标签，返回值都会显示为null

正确实现方法 #

查询自身账户下的所有快照时，需要显式添加--owner self过滤参数，告知接口当前查询的是本账户归属的快照，接口才会完整返回每个快照的全量元数据（包含Tags标签内容）。

基础可用命令 #

保留原始Tags结构的查询命令，可直接拿到和接口返回完全一致的标签数组：

AWS_PAGER="" aws ec2 describe-snapshots \
  --max-items=1000 \
  --region=us-east-1 \
  --owner self \
  --query 'Snapshots[*].{id: SnapshotId,startTime: startTime,tags:Tags}'

优化易读性的标签映射 #

如果觉得原始Tags数组[{Key: "标签键", Value: "标签值"}]的结构不够直观，可以调整查询表达式，将标签结构简化为更易读的键值对格式：

AWS_PAGER="" aws ec2 describe-snapshots \
  --max-items=1000 \
  --region=us-east-1 \
  --owner self \
  --query 'Snapshots[*].{
    id: SnapshotId,
    startTime: startTime,
    tags: Tags[].{key: Key, value: Value}
  }'

注意事项 #

• 如果单个快照本身没有关联任何标签，查询返回的tags字段会是空数组[]，而非null，这属于正常返回结果
• --max-items仅控制单页接口返回的快照数量，当账户下快照总量超过分页阈值时，需要配合--next-token参数实现全量快照的拉取

内容的提问来源于stack exchange，提问作者Banoona