使用google.cloud.artifactregistry_v1beta2 API获取GCP镜像标签遇参数错误

DevOps 小满

2026-7-23

问题根源

调用list_tags时传入的parent参数不符合API要求：list_tags的parent必须指向Artifact Registry中的Package资源完整路径，而非Repository的路径。你当前直接传递Repository的名称作为parent，导致API返回400无效参数错误。

修复方案

需要先获取指定仓库下的所有Package（每个Docker镜像对应一个Package），再针对每个Package调用list_tags获取其关联的镜像标签。以下是修正后的完整代码：

from google.cloud import artifactregistry_v1beta2

def list_all_repositories(project):
    client = artifactregistry_v1beta2.ArtifactRegistryClient()
    locations = ['northamerica-northeast1']
    repositories = []
    for location in locations:
        parent = f"projects/{project}/locations/{location}"
        repositories_in_location = client.list_repositories(parent=parent)
        repositories.extend(repositories_in_location)
    return repositories

def list_images(repository_name):
    client = artifactregistry_v1beta2.ArtifactRegistryClient()
    # 先获取仓库下的所有Package（每个Docker镜像对应一个Package）
    packages = client.list_packages(parent=repository_name)
    
    all_tags = []
    for pkg in packages:
        # 传入Package完整路径作为list_tags的parent参数
        tags = client.list_tags(parent=pkg.name)
        all_tags.extend(tags)
    
    # 按创建时间倒序排序镜像标签
    sorted_tags = sorted(all_tags, key=lambda tag: tag.create_time, reverse=True)
    
    for tag in sorted_tags:
        print(f"镜像标签: {tag.name.split('/')[-1]}, 创建时间: {tag.create_time}")

# 替换为你的GCP项目ID
PROJECT_ID = "your-project-id"
repositories = list_all_repositories(PROJECT_ID)

for repository in repositories:
    print(f"检查仓库: {repository.name}")
    list_images(repository_name=repository.name)