如何通过已知CI_PIPELINE_IID查询对应GitLab流水线并映射到CI_PIPELINE_ID

1. 图形界面直接查询（无需调用API） #

CI_PIPELINE_IID是项目内的自增ID，你直接在对应项目的流水线页面的URL后拼接IID即可直接访问对应记录：
比如你的项目访问地址是https://gitlab.example.com/你的群组/你的项目，直接访问https://gitlab.example.com/你的群组/你的项目/-/pipelines/[CI_PIPELINE_IID]。打开页面后浏览器地址栏跳转后的数值就是全局唯一的CI_PIPELINE_ID，同时可以直接查看对应流水线的完整运行记录和日志。

2. 通过GitLab API查询（适合批量转换场景） #

你可以调用项目级流水线查询接口，传入IID参数直接获取包含CI_PIPELINE_ID在内的完整流水线信息，操作步骤如下：

• 先申请GitLab个人访问令牌，权限至少开通read_api
• 执行以下请求命令即可获取映射结果：

curl --header "PRIVATE-TOKEN: 你的访问令牌" "https://gitlab.example.com/api/v4/projects/[项目ID]/pipelines?iid[]=[你的CI_PIPELINE_IID]"

返回结果中的id字段就是全局CI_PIPELINE_ID，iid字段对应你传入的项目内流水号，同时返回内容还包含流水线状态、触发时间、关联提交等全量相关信息。

注意事项 #

• CI_PIPELINE_IID仅在单个项目内唯一，跨项目的IID可能存在重复，查询前请先确认对应IID所属的项目是否正确。
• 私有部署的GitLab实例，将上述命令和URL中的域名替换为自己的实例域名即可。

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