资源里程碑事件 API
- Tier: 基础版, 专业版, 旗舰版
- Offering: JihuLab.com, 私有化部署
资源里程碑事件用于跟踪极狐GitLab 议题和合并请求的变化。
使用它们来跟踪哪个里程碑被添加或移除,谁执行了操作,以及发生的时间。
议题
列出项目议题里程碑事件
获取单个议题的所有里程碑事件的列表。
plaintextGET /projects/:id/issues/:issue_iid/resource_milestone_events
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
| id | integer/string | yes | 项目的 ID 或URL 编码路径 |
| issue_iid | integer | yes | 议题的 IID |
示例请求:
shellcurl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/11/resource_milestone_events"
示例响应:
json1[ 2 { 3 "id": 142, 4 "user": { 5 "id": 1, 6 "name": "Administrator", 7 "username": "root", 8 "state": "active", 9 "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon", 10 "web_url": "http://gitlab.example.com/root" 11 }, 12 "created_at": "2018-08-20T13:38:20.077Z", 13 "resource_type": "Issue", 14 "resource_id": 253, 15 "milestone": { 16 "id": 61, 17 "iid": 9, 18 "project_id": 7, 19 "title": "v1.2", 20 "description": "Ipsum Lorem", 21 "state": "active", 22 "created_at": "2020-01-27T05:07:12.573Z", 23 "updated_at": "2020-01-27T05:07:12.573Z", 24 "due_date": null, 25 "start_date": null, 26 "web_url": "http://gitlab.example.com:3000/group/project/-/milestones/9" 27 }, 28 "action": "add" 29 }, 30 { 31 "id": 143, 32 "user": { 33 "id": 1, 34 "name": "Administrator", 35 "username": "root", 36 "state": "active", 37 "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon", 38 "web_url": "http://gitlab.example.com/root" 39 }, 40 "created_at": "2018-08-21T14:38:20.077Z", 41 "resource_type": "Issue", 42 "resource_id": 253, 43 "milestone": { 44 "id": 61, 45 "iid": 9, 46 "project_id": 7, 47 "title": "v1.2", 48 "description": "Ipsum Lorem", 49 "state": "active", 50 "created_at": "2020-01-27T05:07:12.573Z", 51 "updated_at": "2020-01-27T05:07:12.573Z", 52 "due_date": null, 53 "start_date": null, 54 "web_url": "http://gitlab.example.com:3000/group/project/-/milestones/9" 55 }, 56 "action": "remove" 57 } 58]
获取单个议题里程碑事件
返回特定项目议题的单个里程碑事件。
plaintextGET /projects/:id/issues/:issue_iid/resource_milestone_events/:resource_milestone_event_id
参数:
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
| id | integer/string | yes | 项目的 ID 或URL 编码路径 |
| issue_iid | integer | yes | 议题的 IID |
| resource_milestone_event_id | integer | yes | 里程碑事件的 ID |
示例请求:
shellcurl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/11/resource_milestone_events/1"
合并请求
列出项目合并请求里程碑事件
获取单个合并请求的所有里程碑事件的列表。
plaintextGET /projects/:id/merge_requests/:merge_request_iid/resource_milestone_events
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
| id | integer/string | yes | 项目的 ID 或URL 编码路径 |
| merge_request_iid | integer | yes | 合并请求的 IID |
示例请求:
shellcurl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/resource_milestone_events"
示例响应:
json1[ 2 { 3 "id": 142, 4 "user": { 5 "id": 1, 6 "name": "Administrator", 7 "username": "root", 8 "state": "active", 9 "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon", 10 "web_url": "http://gitlab.example.com/root" 11 }, 12 "created_at": "2018-08-20T13:38:20.077Z", 13 "resource_type": "MergeRequest", 14 "resource_id": 142, 15 "milestone": { 16 "id": 61, 17 "iid": 9, 18 "project_id": 7, 19 "title": "v1.2", 20 "description": "Ipsum Lorem", 21 "state": "active", 22 "created_at": "2020-01-27T05:07:12.573Z", 23 "updated_at": "2020-01-27T05:07:12.573Z", 24 "due_date": null, 25 "start_date": null, 26 "web_url": "http://gitlab.example.com:3000/group/project/-/milestones/9" 27 }, 28 "action": "add" 29 }, 30 { 31 "id": 143, 32 "user": { 33 "id": 1, 34 "name": "Administrator", 35 "username": "root", 36 "state": "active", 37 "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon", 38 "web_url": "http://gitlab.example.com/root" 39 }, 40 "created_at": "2018-08-21T14:38:20.077Z", 41 "resource_type": "MergeRequest", 42 "resource_id": 142, 43 "milestone": { 44 "id": 61, 45 "iid": 9, 46 "project_id": 7, 47 "title": "v1.2", 48 "description": "Ipsum Lorem", 49 "state": "active", 50 "created_at": "2020-01-27T05:07:12.573Z", 51 "updated_at": "2020-01-27T05:07:12.573Z", 52 "due_date": null, 53 "start_date": null, 54 "web_url": "http://gitlab.example.com:3000/group/project/-/milestones/9" 55 }, 56 "action": "remove" 57 } 58]
获取单个合并请求里程碑事件
返回特定项目合并请求的单个里程碑事件。
plaintextGET /projects/:id/merge_requests/:merge_request_iid/resource_milestone_events/:resource_milestone_event_id
参数:
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
| id | integer/string | yes | 项目的 ID 或URL 编码路径 |
| merge_request_iid | integer | yes | 合并请求的 IID |
| resource_milestone_event_id | integer | yes | 里程碑事件的 ID |
示例请求:
shellcurl --request GET --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/resource_milestone_events/120"