그룹 이터레이션 API

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • GitLab 13.5에서 소개되었습니다.
  • 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 string no ’ opened, upcoming, current, closed, 또는 all 이터레이션을 반환.’
search string no 제공된 문자열과 일치하는 제목을 가진 이터레이션만 반환합니다.
in string 배열 no 흐릿한 검색을 수행해야 하는 필드 및 search로 지정된 쿼리를 사용합니다. 사용 가능한 옵션은 title 및 cadence_title입니다. 기본값은 [title]입니다. GitLab 16.2에서 추가되었습니다.
include_ancestors boolean no 그룹 및 그 조상의 이터레이션을 포함합니다. 기본값은 true입니다.
include_descendants boolean no 그룹 및 하위 항목의 이터레이션을 포함합니다. 기본값은 false입니다. GitLab 16.7에서 추가되었습니다.
updated_before datetime no 주어진 날짜시간 이전에 업데이트된 이터레이션만 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z)으로 예상됩니다. GitLab 15.10에서 추가되었습니다.
updated_after datetime no 주어진 날짜시간 이후에 업데이트된 이터레이션만 반환합니다. 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"
  }
]