# 向迭代中添加资源 - AddResourceForIterator #### 功能介绍 此接口用于向指定测试计划中添加用例 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/iterators/{iterator_uri}/testcases/batch-add 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | iterator_uri | 是 | String | 迭代uri | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_uuid | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | iterator_uri | 否 | String | 迭代uri | | type | 否 | Integer | **参数解释**: 资源类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 **默认取值**: 不涉及 | | is_all_issues | 否 | String | 是否选择issues | | all_import | 否 | Boolean | 是否选择所有用例 | | feature_uri | 否 | String | 按照目录引入用例 | | simple_resourceinfo_list | 是 | Array of [SimpleResourceInfo] objects | 选择的资源列表, 对应sourceCaseUris | | invert_simple_resourceinfo_list | 否 | Array of [SimpleResourceInfo] objects | 反选的资源列表 | | add_to_iterator | 否 | Boolean | 是否将需求添加到测试计划（不传或者true添加需求到测试计划，false就不添加） | 表3SimpleResourceInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | type | 否 | String | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。 - Task，任务。 - TestVersion，分支。 - IteratorTestCase，迭代用例。 **默认取值**: 不涉及 | | owner | 否 | String | 资源责任人 | | resource_id | 否 | String | 资源id | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。 - error，表示接口调用失败。 | | result | [ResultValueString] object | 请求返回的数据 | | error | [ApiError] object | 错误信息 | | request_id | String | 由接口调用方传入，建议使用UUID保证请求的唯一性。 | | server_address | String | 本次请求的受理的服务地址 | 表5ResultValueString | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | String | 实际的数据类型：单个对象，集合 或 NULL | | reason | String | 业务失败的提示内容 | | page_size | Integer | 分页大小 | | page_no | Integer | 分页编码 | | has_more | Boolean | 是否有更多 | 表6ApiError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 业务失败的错误编码 | | reason | String | 业务失败的提示内容 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：401** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：404** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：500** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | #### 请求示例 ``` post https://{endpoint}/v4/iterators/v90100010b5nubs0/testcases/batch-add { "project_uuid" : "407ac57de7ea44d28e47293a2b9cf15c", "is_all_issues" : 0, "invert_simple_resourceinfo_list" : [ ], "simple_resourceinfo_list" : [ { "resource_id" : "v90310i5nmam455h" }, { "resource_id" : "v90300010i5nma73" }, { "resource_id" : "v90310i5nmak255g" }, { "resource_id" : "v90310i5nmab755f" }, { "resource_id" : "v90300010i5nmaai" }, { "resource_id" : "v90300010i5nmair" } ], "type" : -1, "add_to_iterator" : false } ``` #### 响应示例 **状态码：200** OK ``` { "result" : { "value" : "success" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。