# Resource milestone events API

> 原文：[https://docs.gitlab.com/ee/api/resource_milestone_events.html](https://docs.gitlab.com/ee/api/resource_milestone_events.html)

*   [Issues](#issues)
    *   [List project issue milestone events](#list-project-issue-milestone-events)
    *   [Get single issue milestone event](#get-single-issue-milestone-event)
*   [Merge requests](#merge-requests)
    *   [List project merge request milestone events](#list-project-merge-request-milestone-events)
    *   [Get single merge request milestone event](#get-single-merge-request-milestone-event)

# Resource milestone events API[](#resource-milestone-events-api "Permalink")

资源里程碑事件跟踪 GitLab [问题](../user/project/issues/)和[合并请求的处理情况](../user/project/merge_requests/) .

使用它们来跟踪添加或删除了哪个里程碑，谁进行了里程碑以及何时发生.

## Issues[](#issues "Permalink")

### List project issue milestone events[](#list-project-issue-milestone-events "Permalink")

获取单个问题的所有里程碑事件的列表.

```
GET /projects/:id/issues/:issue_iid/resource_milestone_events 
```

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer/string | yes | 项目的 ID 或[URL 编码的路径](README.html#namespaced-path-encoding) |
| `issue_iid` | integer | yes | 问题的 IID |

请求示例：

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

响应示例：

```
[  {  "id":  142,  "user":  {  "id":  1,  "name":  "Administrator",  "username":  "root",  "state":  "active",  "avatar_url":  "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "web_url":  "http://gitlab.example.com/root"  },  "created_at":  "2018-08-20T13:38:20.077Z",  "resource_type":  "Issue",  "resource_id":  253,  "milestone":  {  "id":  61,  "iid":  9,  "project_id":  7,  "title":  "v1.2",  "description":  "Ipsum Lorem",  "state":  "active",  "created_at":  "2020-01-27T05:07:12.573Z",  "updated_at":  "2020-01-27T05:07:12.573Z",  "due_date":  null,  "start_date":  null,  "web_url":  "http://gitlab.example.com:3000/group/project/-/milestones/9"  },  "action":  "add"  },  {  "id":  143,  "user":  {  "id":  1,  "name":  "Administrator",  "username":  "root",  "state":  "active",  "avatar_url":  "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "web_url":  "http://gitlab.example.com/root"  },  "created_at":  "2018-08-21T14:38:20.077Z",  "resource_type":  "Issue",  "resource_id":  253,  "milestone":  {  "id":  61,  "iid":  9,  "project_id":  7,  "title":  "v1.2",  "description":  "Ipsum Lorem",  "state":  "active",  "created_at":  "2020-01-27T05:07:12.573Z",  "updated_at":  "2020-01-27T05:07:12.573Z",  "due_date":  null,  "start_date":  null,  "web_url":  "http://gitlab.example.com:3000/group/project/-/milestones/9"  },  "action":  "remove"  }  ] 
```

### Get single issue milestone event[](#get-single-issue-milestone-event "Permalink")

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

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

Parameters:

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer/string | yes | 项目的 ID 或[URL 编码的路径](README.html#namespaced-path-encoding) |
| `issue_iid` | integer | yes | 问题的 IID |
| `resource_milestone_event_id` | integer | yes | 里程碑事件的 ID |

请求示例：

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

## Merge requests[](#merge-requests "Permalink")

### List project merge request milestone events[](#list-project-merge-request-milestone-events "Permalink")

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

```
GET /projects/:id/merge_requests/:merge_request_iid/resource_milestone_events 
```

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer/string | yes | 项目的 ID 或[URL 编码的路径](README.html#namespaced-path-encoding) |
| `merge_request_iid` | integer | yes | 合并请求的 IID |

请求示例：

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

响应示例：

```
[  {  "id":  142,  "user":  {  "id":  1,  "name":  "Administrator",  "username":  "root",  "state":  "active",  "avatar_url":  "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "web_url":  "http://gitlab.example.com/root"  },  "created_at":  "2018-08-20T13:38:20.077Z",  "resource_type":  "MergeRequest",  "resource_id":  142,  "milestone":  {  "id":  61,  "iid":  9,  "project_id":  7,  "title":  "v1.2",  "description":  "Ipsum Lorem",  "state":  "active",  "created_at":  "2020-01-27T05:07:12.573Z",  "updated_at":  "2020-01-27T05:07:12.573Z",  "due_date":  null,  "start_date":  null,  "web_url":  "http://gitlab.example.com:3000/group/project/-/milestones/9"  },  "action":  "add"  },  {  "id":  143,  "user":  {  "id":  1,  "name":  "Administrator",  "username":  "root",  "state":  "active",  "avatar_url":  "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "web_url":  "http://gitlab.example.com/root"  },  "created_at":  "2018-08-21T14:38:20.077Z",  "resource_type":  "MergeRequest",  "resource_id":  142,  "milestone":  {  "id":  61,  "iid":  9,  "project_id":  7,  "title":  "v1.2",  "description":  "Ipsum Lorem",  "state":  "active",  "created_at":  "2020-01-27T05:07:12.573Z",  "updated_at":  "2020-01-27T05:07:12.573Z",  "due_date":  null,  "start_date":  null,  "web_url":  "http://gitlab.example.com:3000/group/project/-/milestones/9"  },  "action":  "remove"  }  ] 
```

### Get single merge request milestone event[](#get-single-merge-request-milestone-event "Permalink")

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

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

Parameters:

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer/string | yes | 项目的 ID 或[URL 编码的路径](README.html#namespaced-path-encoding) |
| `merge_request_iid` | integer | yes | 合并请求的 IID |
| `resource_milestone_event_id` | integer | yes | 里程碑事件的 ID |

请求示例：

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