그룹 반복 API

요약

이 API를 사용하여 그룹 반복에 접근합니다. 프로젝트 반복의 경우 프로젝트 반복 API를 사용합니다. 지정된 그룹의 모든 반복을 나열합니다. 반복 주기에서 자동 일정 활성화로 생성된 반복은 title 및 description 필드에 대해 null을 반환합니다.

이 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	아니오	'`opened`, `upcoming`, `current`, `closed` 또는 `all` 반복 반환.'
`search`	string	아니오	제공된 문자열과 일치하는 제목을 가진 반복만 반환합니다.
`in`	array of strings	아니오	`search` 인수에 지정된 쿼리로 퍼지 검색을 수행할 필드. 사용 가능한 옵션은 `title`과 `cadence_title`입니다. 기본값은 `[title]`입니다. GitLab 16.2에서 도입.
`include_ancestors`	boolean	아니오	그룹 및 해당 상위 항목에 대한 반복을 포함합니다. 기본값은 `true`입니다.
`include_descendants`	boolean	아니오	그룹 및 해당 하위 항목에 대한 반복을 포함합니다. 기본값은 `false`입니다. GitLab 16.7에서 도입.
`updated_before`	datetime	아니오	지정된 날짜/시간 이전에 업데이트된 반복만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)으로 입력합니다. GitLab 15.10에서 도입.
`updated_after`	datetime	아니오	지정된 날짜/시간 이후에 업데이트된 반복만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)으로 입력합니다. GitLab 15.10에서 도입.

요청 예:

  curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "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"
  }
]

그룹 반복 API

Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-05-22

요약