그룹 이터레이션 API

Tier: Premium, Ultimate
Offering: GitLab.com, 자체 관리, GitLab 전용
  • 소개됨 - GitLab 13.5에서.
  • GitLab 13.9에서 GitLab Premium으로 이동.

이 페이지에서는 그룹 이터레이션 API에 대해 설명합니다. 별도로 프로젝트 이터레이션 API 페이지가 있습니다.

그룹 이터레이션 목록

그룹 이터레이션 목록을 반환합니다.

이터레이션 주기에서 자동 일정 설정 사용으로 생성된 이터레이션은 title 및 description 필드에 대해 null을 반환합니다. 

GET /groups/:id/iterations
GET /groups/:id/iterations?state=opened
GET /groups/:id/iterations?state=closed
GET /groups/:id/iterations?search=version
GET /groups/:id/iterations?include_ancestors=false
GET /groups/:id/iterations?include_descendants=true
GET /groups/:id/iterations?updated_before=2013-10-02T09%3A24%3A18Z
GET /groups/:id/iterations?updated_after=2013-10-02T09%3A24%3A18Z
속성 유형 필수 설명
state 문자열 아니요 ‘opened, upcoming, current, closed, 또는 all 이터레이션을 반환합니다.’
search 문자열 아니요 제공된 문자열과 일치하는 제목을 가진 이터레이션만 반환합니다.
in 문자열 배열 아니요 인수 search에서 제공된 쿼리로 모호한 검색을 수행해야 하는 필드입니다. 가능한 옵션은 title 및 cadence_title입니다. 기본값은 [title]입니다. GitLab 16.2에서 소개됨.
include_ancestors 부울 아니요 그룹 및 해당 조상의 이터레이션을 포함합니다. 기본값은 true입니다.
include_descendants 부울 아니요 그룹 및 해당 하위 이터레이션을 포함합니다. 기본값은 false입니다. GitLab 16.7에서 소개됨.
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>" "https://gitlab.example.com/api/v4/groups/5/iterations"

예시 응답: 

[
  {
    "id": 53,
    "iid": 13,
    "sequence": 1,
    "group_id": 5,
    "title": "Iteration II",
    "description": "Ipsum Lorem ipsum",
    "state": 2,
    "created_at": "2020-01-27T05:07:12.573Z",
    "updated_at": "2020-01-27T05:07:12.573Z",
    "due_date": "2020-02-01",
    "start_date": "2020-02-14",
    "web_url": "http://gitlab.example.com/groups/my-group/-/iterations/13"
  }
]