InfoGrab DocsInfoGrab Docs

프로젝트 마일스톤 API

요약

이 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

프로젝트 마일스톤 API

GitLab v19.5
Tier: Premium, Ultimate
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 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