Jenkins中如何通过显示名称查找指定流水线任务？（外部UI/API）

当然可以！不管是通过Jenkins的Web界面手动查找，还是用REST API自动化查询，都能满足你的需求——毕竟你说这个标识符是全局唯一的，找起来只会更简单。下面给你详细拆解两种方法：

一、通过Jenkins用户界面手动查找 #

• 第一步：打开Jenkins，进入你那个流水线项目的主页（就是设置了唯一标识符作为任务显示名称的项目）
• 第二步：在项目页面里找到构建历史（Build History）区域，这里会列出所有已运行过的任务
• 第三步：直接在构建历史里搜索你的唯一标识符就行——因为它全局唯一，要么搜不到（没这个任务），要么只会跳出一个匹配的任务条目
• 第四步：点击这个匹配的条目，进入任务详情页。此时浏览器地址栏里的URL就是任务的访问地址，URL里的数字就是任务编号（比如http://your-jenkins/job/your-pipeline/456/里的456就是编号）

二、通过Jenkins REST API自动化查询 #

如果需要从外部程序或者脚本里查询，用REST API是更高效的方式，这里有两种实用的调用方式：

方法1：针对目标项目的构建列表API #

这种方法直接查询目标项目的所有构建，再过滤出匹配显示名称的任务：

• 发送GET请求到：

  GET http://your-jenkins-url/job/your-project-name/api/json?tree=builds[number,url,displayName]
  

  这个接口会返回该项目所有构建的精简信息，只包含你需要的number（任务编号）、url（任务地址）和displayName（显示名称）
• 解析返回的JSON结果，找到displayName等于你的唯一标识符的条目，对应的number和url就是你要的内容
• 注意：如果你的Jenkins开启了权限验证，请求时要带上认证信息（比如Basic Auth，或者用Jenkins API Token）

方法2：Jenkins全局搜索API（版本需支持） #

如果你的Jenkins版本支持全局搜索功能，可以直接用全局搜索接口定位任务：

• 发送GET请求到：

  GET http://your-jenkins-url/search/?q=your-unique-identifier
  

  因为标识符全局唯一，返回结果里只会有一个匹配的任务，里面会包含任务所属项目、编号和访问URL等信息
• 同样，需要认证的话记得在请求里带上相应的凭证

小提示 #

• 确保你的Jenkins账号有足够的权限访问目标项目的构建历史和API接口，不然会返回权限错误
• 如果你的唯一标识符里包含空格、特殊字符，在API请求中要做URL编码（比如空格换成%20，特殊符号按规则转义）

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