资源里程碑事件 API

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: JihuLab.com, 私有化部署

资源里程碑事件用于跟踪极狐GitLab 议题合并请求的变化。

使用它们来跟踪哪个里程碑被添加或移除,谁执行了操作,以及发生的时间。

议题#

列出项目议题里程碑事件#

获取单个议题的所有里程碑事件的列表。

plaintext
GET /projects/:id/issues/:issue_iid/resource_milestone_events
属性类型必需描述
idinteger/stringyes项目的 ID 或URL 编码路径
issue_iidintegeryes议题的 IID

示例请求:

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/11/resource_milestone_events"

示例响应:

json
1[ 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]

获取单个议题里程碑事件#

返回特定项目议题的单个里程碑事件。

plaintext
GET /projects/:id/issues/:issue_iid/resource_milestone_events/:resource_milestone_event_id

参数:

属性类型必需描述
idinteger/stringyes项目的 ID 或URL 编码路径
issue_iidintegeryes议题的 IID
resource_milestone_event_idintegeryes里程碑事件的 ID

示例请求:

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/11/resource_milestone_events/1"

合并请求#

列出项目合并请求里程碑事件#

获取单个合并请求的所有里程碑事件的列表。

plaintext
GET /projects/:id/merge_requests/:merge_request_iid/resource_milestone_events
属性类型必需描述
idinteger/stringyes项目的 ID 或URL 编码路径
merge_request_iidintegeryes合并请求的 IID

示例请求:

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/resource_milestone_events"

示例响应:

json
1[ 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]

获取单个合并请求里程碑事件#

返回特定项目合并请求的单个里程碑事件。

plaintext
GET /projects/:id/merge_requests/:merge_request_iid/resource_milestone_events/:resource_milestone_event_id

参数:

属性类型必需描述
idinteger/stringyes项目的 ID 或URL 编码路径
merge_request_iidintegeryes合并请求的 IID
resource_milestone_event_idintegeryes里程碑事件的 ID

示例请求:

shell
curl --request GET --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/resource_milestone_events/120"