
# 查询项目下所有迭代计划（2.0） - ListAllIteratorsV4
#### 功能介绍
此接口用于查询项目下所有迭代计划,同页面 测试 -\> 测试用例 -\> 点击上方迭代右侧小齿轮 -\> 查看迭代列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v4/projects/{project_id}/iterator-infos
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制**: 字符串类型，长度32位字符 **取值范围**: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 **默认取值**: 不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数        | 参数类型                                                                          | 描述                                                                                                                                                                         |
|:---|:---|:---|
| total     | Integer                                                                       | **参数解释**: 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 **取值范围**: 大于等于0 |
| value     | Array of [TestVersionVo] objects | **参数解释**: 实际的数据类型：单个对象，集合 或 NULL **取值范围**: 不涉及           |
| reason    | String                                                                        | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及                        |
| page_size | Integer                                                                       | **参数解释**: 每页展示条数 **取值范围**: 大于等于0                         |
| page_no   | Integer                                                                       | **参数解释**: 页码 **取值范围**: 大于等于0                             |
| has_more  | Boolean                                                                       | **参数解释**: 是否有更多 **取值范围**: true\|false                    |
   
 表4TestVersionVo 
| 参数                      | 参数类型              | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| uri                     | String            | **参数解释**: 资源URI **取值范围**: 11-34位长度的字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| type                    | String            | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。   - Task，任务。   - TestVersion，分支。   - IteratorTestCase，迭代用例。    |
| author                  | String            | **参数解释**: 创建人 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| name                    | String            | **参数解释**: 名称 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| rank                    | Integer           | **参数解释**: 级别 **取值范围**: 1\|2\|3\|4                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| version                 | String            | **参数解释**: 待测版本 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| owner                   | String            | **参数解释**: 处理者ID **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| creator                 | String            | **参数解释**: 创建人ID **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| iterations              | String            | **参数解释**: 关联迭代 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| description             | String            | **参数解释**: 描述 **取值范围**: 长度小于1024个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| region                  | String            | **参数解释**: 区域 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| last_modifier           | String            | **参数解释**: 最后修改人 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| last_modified           | String            | **参数解释**: 最后修改时间 **取值范围**: 不涉及，格式：yyyy-MM-dd HH:mm:ss                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| last_modified_timestamp | Long              | **参数解释**: 修改时间时间戳 **取值范围**: 不涉及，单位：毫秒级                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| last_change_time        | String            | **参数解释**: 最后变更时间 **取值范围**: 不涉及，格式：yyyy-MM-dd HH:mm:ss                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| version_uri             | String            | **参数解释**: 版本URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| origin_uri              | String            | **参数解释**: 源资源URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| parent_uri              | String            | **参数解释**: 父资源URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| parent_path             | String            | **参数解释**: 父资源路径 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| creation_version_uri    | String            | **参数解释**: 创建版本URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| creation_date           | String            | **参数解释**: 创建时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| creation_date_timestamp | Long              | **参数解释**: 创建时间时间戳 **取值范围**: 不涉及，单位：毫秒级                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| author_name             | String            | **参数解释**: 创建人名称 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| comment                 | String            | **参数解释**: 备注 **取值范围**: 长度小于1024个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| number                  | String            | **参数解释**: 编号 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| is_master               | Integer           | **参数解释**: 是否为Master分支 **取值范围**: 0\|1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| is_iterator             | Integer           | **参数解释**: 是否为迭代 **取值范围**: 0\|1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| plan_start_date         | String            | **参数解释**: 开始时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| plan_end_date           | String            | **参数解释**: 结束时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| service_id              | String            | **参数解释**: 微服务ID **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| service_name            | String            | **参数解释**: 微服务名 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| pbi_id                  | String            | **参数解释**: PBI ID **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| pbi_name                | String            | **参数解释**: PBI信息 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| plan_id                 | String            | **参数解释**: 计划ID **取值范围**: 11-34位字母和数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| metric_pbi_ids          | String            | **参数解释**: 度量PBI ID **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| metric_pbi_id_names     | String            | **参数解释**: 度量PBI名称 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| last_syn_date           | String            | **参数解释**: 最后同步时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| is_closed               | String            | **参数解释**: 版本是否关闭 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| asyn_git                | String            | **参数解释**: 是否同步git库 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| schema_no               | Integer           | **参数解释**: schema编号 **取值范围**: 1-10                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| finish_date             | String            | **参数解释**: 迭代实际完成时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| owner_name              | String            | **参数解释**: 处理者名称 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| creator_name            | String            | **参数解释**: 创建人名称 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| current_stage           | String            | **参数解释**: 当前所处阶段 **取值范围**: create\|strategy\|design\|execute\|report                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| service_types           | Array of integers | **参数解释**: 服务类型 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| risk_rating             | Integer           | **参数解释**: 风险等级 **取值范围**: 0\|1\|2\|3\|4\|5                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| risk_des                | String            | **参数解释**: 风险描述 **取值范围**: 最大长度500位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| project_uuid            | String            | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围**: 32位字母和数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| domain_id               | String            | **参数解释**: 租户ID **取值范围**: 11-34位字母和数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| pi_id                   | String            | **参数解释**: pi的id **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
**状态码：400**
表5响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表6响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表7响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表8响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
GET https://{endpoint}/GT3KServer/v4/projects/90f8dc52eb7b4c47b853c661152ca62d/iterator-infos
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : [ {
    "uri" : "v902000108vdtjml",
    "type" : "TestVersion",
    "author" : "dfc5347b9b16491e942ce55ce7f79dbc",
    "name" : "样例测试计划",
    "owner" : "dfc5347b9b16491e942ce55ce7f79dbc",
    "region" : {
      "region" : null
    },
    "last_modifier" : "dfc5347b9b16491e942ce55ce7f79dbc",
    "last_modified" : "2025-02-22 10:59:14",
    "last_modified_timestamp" : 1740193154000,
    "last_change_time" : "2025-02-22 10:59:14",
    "version_uri" : "v902000108vdtjkp",
    "parent_uri" : "v902000108vdtjkp",
    "parent_path" : "/90f8dc52eb7b4c47b853c661152ca62d/v902000108vdtjkp/",
    "creation_version_uri" : "v902000108vdtjkp",
    "creation_date" : "2025-02-22 10:59:11",
    "creation_date_timestamp" : 1740193151000,
    "author_name" : "TMSS01",
    "is_master" : 0,
    "is_iterator" : 1,
    "plan_start_date" : "2025-02-22 00:00:00",
    "plan_end_date" : "2025-03-01 23:59:59",
    "service_id" : "90f8dc52eb7b4c47b853c661152ca62d",
    "service_name" : "租户自定义字段",
    "schema_no" : 2,
    "owner_name" : "TMSS01",
    "current_stage" : "execute",
    "service_types" : "[\"0\",\"1\"]",
    "risk_rating" : 0,
    "project_uuid" : "90f8dc52eb7b4c47b853c661152ca62d",
    "pi_id" : "notSelected"
  } ]
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
