그룹 반복 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 부울 아니요 그룹과 해당 조상에 대한 반복을 포함합니다. 기본값은 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"
  }
]