Project milestones API

Project milestones API

This page describes the project milestones API. There’s a separate group milestones API page.

返回项目里程碑的列表.

Parameters:

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

示例响应：

  1. [  {  "id":  12,  "iid":  3,  "project_id":  16,  "title":  "10.0",  "description":  "Version",  "due_date":  "2013-11-29",  "start_date":  "2013-11-10",  "state":  "active",  "updated_at":  "2013-10-02T09:24:18Z",  "created_at":  "2013-10-02T09:24:18Z"  }  ]

Get single milestone

获得单个项目里程碑.

Parameters:

  • id （必填）-经过身份验证的用户拥有的项目的 ID 或
  • milestone_id （必填）-项目里程碑的 ID

Create new milestone

Parameters:

  • id （必填）-经过身份验证的用户拥有的 ID 或URL 编码路径
  • title （必填）-里程碑的标题
  • description （可选）-里程碑的说明
  • due_date （可选）-里程碑的截止日期
  • start_date （可选）-里程碑的开始日期

更新现有项目的里程碑.

  1. PUT /projects/:id/milestones/:milestone_id

Parameters:

  • id （必填）-经过身份验证的用户拥有的 ID 或URL 编码路径
  • milestone_id （必填）-项目里程碑的 ID
  • title （可选）-里程碑的标题
  • due_date （可选）-里程碑的截止日期
  • start_date （可选）-里程碑的开始日期
  • （可选）-里程碑的状态事件（关闭或激活）

Delete project milestone

仅适用于具有开发人员访问项目权限的用户.

Parameters:

  • id （必填）-经过身份验证的用户拥有的项目的 ID 或
  • milestone_id （必填）-项目里程碑的 ID

Get all issues assigned to a single milestone

获取分配给单个项目里程碑的所有问题.

  1. GET /projects/:id/milestones/:milestone_id/issues
  • id （必填）-经过身份验证的用户拥有的 ID 或URL 编码路径
  • milestone_id （必填）-项目里程碑的 ID

获取分配给单个项目里程碑的所有合并请求.

  1. GET /projects/:id/milestones/:milestone_id/merge_requests

Parameters:

  • id （必填）-经过身份验证的用户拥有的 ID 或URL 编码路径
  • milestone_id （必填）-项目里程碑的 ID

Promote project milestone to a group milestone

在 GitLab 11.9 中引入

仅针对具有开发者访问权限的用户.

Parameters:

  • id （必填）-经过身份验证的用户拥有的 ID 或URL 编码路径
  • milestone_id （必填）-项目里程碑的 ID

Get all burndown chart events for a single milestone

在 GitLab 12.1 中引入

  1. GET /projects/:id/milestones/:milestone_id/burndown_events

Parameters:

  • id （必填）-经过身份验证的用户拥有的 ID 或URL 编码路径
  • （必填）-项目里程碑的 ID