TFS 2017 Git API：能否通过标签名获取附注标签信息？

能否通过标签名直接获取附注标签信息？ #

TFS 2017的Git API不支持直接通过标签名查询附注标签（Annotated Tag），官方文档里的Annotated Tags接口确实要求传入标签的对象ID才能获取详情。

替代方案：获取指定提交的所有标签，或实现标签名到对象ID的转换 #

1. 获取指定提交的所有标签 #

可以调用Git仓库的标签列表接口，返回结果包含标签名称、关联提交ID及标签类型（附注/轻量）。你可筛选结果中objectId等于目标提交ID的条目，得到该提交关联的所有标签。

接口示例（REST API）：

GET http://{tfs-server}:8080/tfs/{collection}/{project}/_apis/git/repositories/{repo-id}/refs?filter=tags/&api-version=3.0

响应中每个标签条目包含：

• name：标签名（格式为refs/tags/xxx）
• objectId：标签关联的提交ID
• tagObjectId：仅附注标签存在该字段，对应标签的对象ID

2. 实现标签名到对象ID的转换 #

同样使用上述标签列表接口，在返回结果中根据标签名（匹配name字段）找到对应条目，若为附注标签，直接提取tagObjectId作为标签对象ID，之后即可调用Annotated Tags接口获取详细信息。

注意事项 #

• 轻量标签无tagObjectId字段，可通过该字段区分标签类型。
• 若仓库标签数量较多，建议添加filter参数缩小范围，比如filter=tags/{partial-tag-name}匹配特定前缀标签，提升查询效率。

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