{{< details >}}

  • Tier: 专业版, 旗舰版
  • Offering: JihuLab.com, 私有化部署

{{< /details >}}

本文描述了群组迭代 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或all迭代。
search string no 仅返回标题与提供的字符串匹配的迭代。
in array of strings no 应在参数search中给出的查询中进行模糊搜索的字段。可用选项是title和cadence_title。默认值是[title]。在极狐GitLab 16.2 中引入。
include_ancestors boolean no 包括群组及其祖先的迭代。默认值为true。
include_descendants boolean no 包括群组及其后代的迭代。默认值为false。在极狐GitLab 16.7 中引入。
updated_before datetime no 仅返回在给定日期时间之前更新的迭代。需要以 ISO 8601 格式提供（2019-03-15T08:00:00Z）。在极狐GitLab 15.10 中引入。
updated_after datetime 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"
  }
]