使用ContainerRegistryClient为Azure容器注册表清单添加标签失败怎么办？

你的问题出在两个核心点：

1. 直接修改ManifestProperties的私有成员_tags，SDK不会将私有属性的变更同步到API请求中，因此服务器端完全接收不到标签更新的指令。
2. update_manifest_properties方法的作用是修改清单的元数据（如注释、架构信息等），而非添加标签。添加标签本质是为同一个清单摘要（digest）创建新的引用关系，需要使用专门的标签创建方法。

正确实现步骤 #

1. 通过现有标签获取目标清单的摘要（digest）
2. 使用create_manifest_tag方法，为该摘要创建新标签

修正后的代码 #

tag_to_update = "V1"
new_tag = "V2"
client = ContainerRegistryClient(endpoint, DefaultAzureCredential(), audience=audience)

# 获取现有标签对应的清单属性，提取digest
properties = client.get_manifest_properties(repository="cr_name", tag_or_digest=tag_to_update)
manifest_digest = properties.digest

# 为该digest创建新标签
client.create_manifest_tag(
    repository="cr_name",
    tag=new_tag,
    digest=manifest_digest
)

# 验证：读取新标签的属性
new_tag_properties = client.get_manifest_properties(repository="cr_name", tag_or_digest=new_tag)
print(f"新标签{new_tag}已关联到digest: {new_tag_properties.digest}")

补充说明 #

• create_manifest_tag是ACR SDK中专门用于创建标签的方法，它会在服务器端建立新标签与指定清单摘要的关联，这是添加标签的标准方式。
• 永远不要直接修改SDK返回对象的私有成员（以下划线开头的属性），这类属性属于内部实现，不保证兼容性，应使用公开的属性和方法进行操作。

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