프로젝트 마일스톤 API
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 API로 프로젝트 마일스톤을 관리합니다. 그룹 마일스톤은 그룹 마일스톤 API를 사용합니다. 프로젝트의 모든 마일스톤을 나열합니다. 지정한 프로젝트 마일스톤을 조회합니다. 지정한 프로젝트 마일스톤을 업데이트합니다. 지정한 프로젝트 마일스톤을 삭제합니다.
이 API로 프로젝트 마일스톤을 관리합니다.
그룹 마일스톤은 그룹 마일스톤 API를 사용합니다.
모든 프로젝트 마일스톤 목록 조회#
프로젝트의 모든 마일스톤을 나열합니다.
GET /projects/:id/milestones
GET /projects/:id/milestones?iids[]=42
GET /projects/:id/milestones?iids[]=42&iids[]=43
GET /projects/:id/milestones?state=active
GET /projects/:id/milestones?state=closed
GET /projects/:id/milestones?title=1.0
GET /projects/:id/milestones?search=version
GET /projects/:id/milestones?updated_before=2013-10-02T09%3A24%3A18Z
GET /projects/:id/milestones?updated_after=2013-10-02T09%3A24%3A18Z
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
iids[] |
integer array | 아니요 | 지정한 iid를 가진 마일스톤만 반환합니다. include_ancestors가 true 이면 무시됩니다. |
state |
string | 아니요 | active 또는 closed 마일스톤만 반환합니다 |
title |
string | 아니요 | 지정한 title을 가진 마일스톤만 반환합니다 |
search |
string | 아니요 | 제목 또는 설명이 지정한 문자열과 일치하는 마일스톤만 반환합니다 |
include_parent_milestones |
boolean | 아니요 | 사용 중단되었습니다. 대신 include_ancestors를 사용합니다. |
include_ancestors |
boolean | 아니요 | 모든 상위 그룹의 마일스톤을 포함합니다. |
updated_before |
datetime | 아니요 | 지정한 일시 이전에 업데이트된 마일스톤만 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z)이어야 합니다. |
updated_after |
datetime | 아니요 | 지정한 일시 이후에 업데이트된 마일스톤만 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z)이어야 합니다. |
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/5/milestones"
응답 예시:
[
{
"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",
"expired": false
}
]
마일스톤 조회#
지정한 프로젝트 마일스톤을 조회합니다.
GET /projects/:id/milestones/:milestone_id
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
integer | 예 | 프로젝트 마일스톤의 ID |
마일스톤 생성#
프로젝트 마일스톤을 생성합니다.
POST /projects/:id/milestones
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
title |
string | 예 | 마일스톤의 제목 |
description |
string | 아니요 | 마일스톤의 설명 |
due_date |
string | 아니요 | 마일스톤의 마감일(YYYY-MM-DD) |
start_date |
string | 아니요 | 마일스톤의 시작일(YYYY-MM-DD) |
마일스톤 업데이트#
지정한 프로젝트 마일스톤을 업데이트합니다.
PUT /projects/:id/milestones/:milestone_id
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
integer | 예 | 프로젝트 마일스톤의 ID |
title |
string | 아니요 | 마일스톤의 제목 |
description |
string | 아니요 | 마일스톤의 설명 |
due_date |
string | 아니요 | 마일스톤의 마감일(YYYY-MM-DD) |
start_date |
string | 아니요 | 마일스톤의 시작일(YYYY-MM-DD) |
state_event |
string | 아니요 | 마일스톤의 상태 이벤트(close 또는 activate) |
마일스톤 삭제#
히스토리
- GitLab 17.7에서 최소 사용자 권한을 Reporter에서 Planner로 변경했습니다.
지정한 프로젝트 마일스톤을 삭제합니다.
프로젝트에 대한 Planner, Reporter, Developer, Maintainer, Owner 권한을 가진 사용자만 사용할 수 있습니다.
DELETE /projects/:id/milestones/:milestone_id
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
integer | 예 | 프로젝트 마일스톤의 ID |
마일스톤의 모든 이슈 목록 조회#
지정한 프로젝트 마일스톤에 할당된 모든 이슈를 나열합니다.
GET /projects/:id/milestones/:milestone_id/issues
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
integer | 예 | 프로젝트 마일스톤의 ID |
마일스톤의 모든 머지 리퀘스트 목록 조회#
지정한 프로젝트 마일스톤에 할당된 모든 머지 리퀘스트를 나열합니다.
GET /projects/:id/milestones/:milestone_id/merge_requests
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
integer | 예 | 프로젝트 마일스톤의 ID |
마일스톤을 그룹 마일스톤으로 승격#
히스토리
- GitLab 17.7에서 최소 사용자 권한을 Reporter에서 Planner로 변경했습니다.
프로젝트 마일스톤을 그룹 마일스톤으로 승격합니다.
그룹에 대한 Planner, Reporter, Developer, Maintainer, Owner 권한을 가진 사용자만 사용할 수 있습니다.
POST /projects/:id/milestones/:milestone_id/promote
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
integer | 예 | 프로젝트 마일스톤의 ID |
마일스톤의 모든 번다운 차트 이벤트 목록 조회#
지정한 마일스톤의 모든 번다운 차트 이벤트를 나열합니다.
GET /projects/:id/milestones/:milestone_id/burndown_events
파라미터:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer or string | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
integer | 예 | 프로젝트 마일스톤의 ID |