如何通过DevOps API快速查找Git仓库中所有METADATA.yml文件？

1. 用Azure DevOps搜索API实现文件名精准匹配 #

你之前提到搜索API只支持内容搜索，其实它支持文件名搜索，通过指定搜索语法就能精准定位目标文件。

请求示例：

POST /_apis/search/codesearchresults?api-version=6.0
Content-Type: application/json

{
  "searchText": "filename:METADATA.yml",
  "filters": {
    "ProjectFilters": ["你的项目ID/名称"],
    "RepositoryFilters": ["仓库ID1", "仓库ID2"] // 可指定多个仓库，不填则搜索整个项目下所有仓库
  },
  "$top": 100 // 按需调整返回数量
}

这个请求会返回所有匹配文件名的文件，包含完整路径和仓库信息，效率远高于递归遍历。

2. 用Azure CLI批量处理多个仓库 #

如果习惯用命令行，可以借助Azure DevOps CLI批量遍历仓库，结合文件搜索：

1. 先登录并设置默认组织/项目：

az login
az devops configure --defaults organization=https://dev.azure.com/你的组织 project=你的项目

2. 获取所有仓库列表，逐个搜索目标文件：

az repos list --query "[].id" -o tsv | while read repoId; do
  echo "正在搜索仓库 $repoId..."
  az repos item list --repository-id $repoId --query "[?name=='METADATA.yml'].path" -o tsv
done

脚本会输出每个仓库中METADATA.yml的完整路径，CLI内部处理比手动递归更高效，适合批量处理数十个仓库。

3. 定期缓存仓库文件结构（适合频繁查询场景） #

如果需要频繁执行这类查询，可以定期拉取所有仓库的文件元数据（不下载内容）并缓存到本地：

调用items API时带上recursionLevel=Full和$select参数，只请求文件路径和名称：

GET /_apis/git/repositories/{repoId}/items?recursionLevel=Full&$select=path,name&api-version=6.0

把返回的数据存入本地数据库（比如SQLite），之后直接查询数据库即可，避免每次调用API，大幅提升查询速度。

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