그룹 반복 API

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

이 페이지는 그룹 반복 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 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>" "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"
  }
]