• 그룹 반복 목록

그룹 반복 API

이 페이지에서는 그룹 반복 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, 또는 모든 반복을 반환합니다.' | | search | string | no | 제공된 문자열과 일치하는 제목을 가진 반복만 반환합니다. | | in | 문자열 배열 | no | 인수 search에서 제공된 쿼리로 모호한 검색을 수행해야 하는 필드입니다. 사용 가능한 옵션은 제목과 목표 제목입니다. 기본값은 [title]입니다. [소개](https://gitlab.com/gitlab-org/gitlab/-/issues/350991)됨. GitLab 16.2에서. | | include_ancestors | 불리언 | no | 그룹 및 해당 상위 항목의 반복을 포함할지 여부. 기본값은 true입니다. | | include_descendants | 불리언 | no | 그룹 및 해당 하위 항목의 반복을 포함할지 여부. 기본값은 false입니다. GitLab 16.7에서 [소개](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/135764)되었습니다. | | updated_before | 일시 | no | 주어진 일시 이전에 업데이트된 반복만 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z)으로 예상됩니다. GitLab 15.10에서 [소개](https://gitlab.com/gitlab-org/gitlab/-/issues/378662)되었습니다. | | updated_after | 일시 | 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"
  }
]