如何通过boto3/CLI筛选近一周创建的AWS ECR镜像

• 你拿到90条结果不是接口的固定返回上限，describe_images是分页接口，默认仅返回第一页数据，单页最大支持返回100条，未做分页处理时无法拉取到仓库下的全量镜像。
• 该接口的filter参数仅支持tagStatus一个过滤维度，可选值只有TAGGED/UNTAGGED/ANY，不支持服务端按imagePushedAt（镜像推送时间）做过滤，你传入自定义的Name、Values字段必然触发参数校验错误。

ECR目前没有提供服务端按推送时间筛选镜像的能力，正确逻辑是：通过分页拉取全量镜像列表，在本地完成时间维度的筛选。boto3自带的分页器（Paginator）可以自动处理分页逻辑，无需手动维护nextToken。

boto3 实现代码 #

import boto3
import datetime

# 初始化客户端，保持和你原有配置一致
ecr_client = boto3.session.Session(profile_name="prod").client("ecr", region_name="us-east-1")
REPOSITORY_NAME = "替换为你的实际仓库名"

# 计算7天前的UTC时间点（必须带时区，否则和返回的带时区时间比较会报错）
cutoff_time = datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(days=7)

# 初始化分页器
paginator = ecr_client.get_paginator("describe_images")
page_iter = paginator.paginate(
    repositoryName=REPOSITORY_NAME,
    # 可选：如果不需要统计未打标签的镜像，加这个过滤可以减少拉取的数据量
    # filter={"tagStatus": "TAGGED"},
    PaginationConfig={"PageSize": 100}
)

# 遍历所有分页，筛选近7天推送的镜像
recent_images = []
for page in page_iter:
    for image in page["imageDetails"]:
        if image["imagePushedAt"] >= cutoff_time:
            recent_images.append(image)

# 按推送时间倒序排序（最新的在前）
recent_images_sorted = sorted(recent_images, key=lambda x: x["imagePushedAt"], reverse=True)

# 后续按需处理结果即可，示例打印逻辑
for img in recent_images_sorted:
    tags = img.get("imageTags", ["<无标签>"])
    print(f"镜像Digest: {img['imageDigest'][:12]}... 标签: {tags} 推送时间: {img['imagePushedAt']}")

AWS CLI 实现方案（可选） #

如果偏好CLI方案，可以结合jq在本地完成筛选，无需写Python代码：

# 将<你的仓库名>替换为实际值，profile、region按需调整
aws ecr describe-images \
  --repository-name <你的仓库名> \
  --profile prod \
  --region us-east-1 \
| jq --argjson cutoff "$(date -d '7 days ago' -u +%s)" \
'.imageDetails | map(select((.imagePushedAt | fromdateiso8601) >= $cutoff)) | sort_by(.imagePushedAt) | reverse'

• 时区匹配：接口返回的imagePushedAt是UTC时区的时间对象，本地计算时间阈值时必须使用UTC时区，否则会出现时间比较报错、筛选结果偏差的问题。
• 性能优化：如果仓库镜像量级很大（万级以上），建议加上tagStatus: TAGGED过滤，跳过无标签的废弃镜像，减少无效数据拉取。
• 分页逻辑：优先使用SDK自带的Paginator处理分页，手动维护nextToken容易出现终止条件判断错误，导致镜像拉取不全。

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