프로젝트 반복 API

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

이 페이지는 프로젝트 반복 API에 대해 설명합니다.
별도의 그룹 반복 API 페이지가 있습니다.

우리는 더 이상 프로젝트 수준의 반복을 지원하지 않지만, 이 엔드포인트를 사용하여 프로젝트의 상위 그룹 반복을 가져올 수 있습니다.

프로젝트 반복 목록

프로젝트 반복 목록을 반환합니다.

Enable automatic scheduling에서 생성된 반복은
Iteration cadences에서 title과 description 필드에 대해 null을 반환합니다.

GET /projects/:id/iterations
GET /projects/:id/iterations?state=opened
GET /projects/:id/iterations?state=closed
GET /projects/:id/iterations?search=version
GET /projects/:id/iterations?include_ancestors=false
GET /projects/:id/iterations?include_descendants=true
GET /projects/:id/iterations?updated_before=2013-10-02T09%3A24%3A18Z
GET /projects/: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/projects/5/iterations"

예시 응답:

[
  {
    "id": 53,
    "iid": 13,
    "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"
  }
]