프로젝트 마일스톤 API
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Offering: 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 |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
iids[] |
정수 배열 | 아니요 | 지정된 iid를 가진 마일스톤만 반환. include_ancestors가 true이면 무시됨. |
state |
문자열 | 아니요 | active 또는 closed 마일스톤만 반환 |
title |
문자열 | 아니요 | 지정된 title을 가진 마일스톤만 반환 |
search |
문자열 | 아니요 | 제목 또는 설명이 제공된 문자열과 일치하는 마일스톤만 반환 |
include_parent_milestones |
불리언 | 아니요 | GitLab 16.7에서 더 이상 사용되지 않음. 대신 include_ancestors를 사용. |
include_ancestors |
불리언 | 아니요 | 모든 상위 그룹의 마일스톤 포함. |
updated_before |
날짜시간 | 아니요 | 지정된 날짜시간 이전에 업데이트된 마일스톤만 반환. ISO 8601 형식(2019-03-15T08:00:00Z)으로 지정. GitLab 15.10에서 도입 |
updated_after |
날짜시간 | 아니요 | 지정된 날짜시간 이후에 업데이트된 마일스톤만 반환. ISO 8601 형식(2019-03-15T08:00:00Z)으로 지정. GitLab 15.10에서 도입 |
curl --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 |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
정수 | 예 | 프로젝트 마일스톤의 ID |
마일스톤 생성#
프로젝트 마일스톤을 생성합니다.
POST /projects/:id/milestones
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
title |
문자열 | 예 | 마일스톤의 제목 |
description |
문자열 | 아니요 | 마일스톤의 설명 |
due_date |
문자열 | 아니요 | 마일스톤의 마감일 (YYYY-MM-DD) |
start_date |
문자열 | 아니요 | 마일스톤의 시작일 (YYYY-MM-DD) |
마일스톤 업데이트#
지정된 프로젝트 마일스톤을 업데이트합니다.
PUT /projects/:id/milestones/:milestone_id
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
정수 | 예 | 프로젝트 마일스톤의 ID |
title |
문자열 | 아니요 | 마일스톤의 제목 |
description |
문자열 | 아니요 | 마일스톤의 설명 |
due_date |
문자열 | 아니요 | 마일스톤의 마감일 (YYYY-MM-DD) |
start_date |
문자열 | 아니요 | 마일스톤의 시작일 (YYYY-MM-DD) |
state_event |
문자열 | 아니요 | 마일스톤의 상태 이벤트 (close 또는 activate) |
마일스톤 삭제#
히스토리
지정된 프로젝트 마일스톤을 삭제합니다.
프로젝트의 Planner, Reporter, Developer, Maintainer 또는 Owner 역할을 가진 사용자만 가능합니다.
DELETE /projects/:id/milestones/:milestone_id
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
정수 | 예 | 프로젝트 마일스톤의 ID |
마일스톤에 대한 모든 이슈 목록 조회#
지정된 프로젝트 마일스톤에 할당된 모든 이슈를 나열합니다.
GET /projects/:id/milestones/:milestone_id/issues
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
정수 | 예 | 프로젝트 마일스톤의 ID |
마일스톤에 대한 모든 머지 리퀘스트 목록 조회#
지정된 프로젝트 마일스톤에 할당된 모든 머지 리퀘스트를 나열합니다.
GET /projects/:id/milestones/:milestone_id/merge_requests
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
정수 | 예 | 프로젝트 마일스톤의 ID |
마일스톤을 그룹 마일스톤으로 승격#
히스토리
프로젝트 마일스톤을 그룹 마일스톤으로 승격합니다.
그룹의 Planner, Reporter, Developer, Maintainer 또는 Owner 역할을 가진 사용자만 가능합니다.
POST /projects/:id/milestones/:milestone_id/promote
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
정수 | 예 | 프로젝트 마일스톤의 ID |
마일스톤에 대한 모든 번다운 차트 이벤트 목록 조회#
지정된 마일스톤에 대한 모든 번다운 차트 이벤트를 나열합니다.
GET /projects/:id/milestones/:milestone_id/burndown_events
매개변수:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
milestone_id |
정수 | 예 | 프로젝트 마일스톤의 ID |