# 拷贝测试计划 - CopyIterator
#### 功能介绍
此接口用于拷贝迭代，根据入参的iterator_uri将指定迭代拷贝到对应项目下。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/{project_id}/iterator/{iterator_uri}/copy
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                 |
|:---|:---|:---|:---|
| project_id   | 是    | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| iterator_uri | 是    | String | 计划uri                                                                                                              |
   
#### 请求参数
表2请求Body参数 
| 参数                   | 是否必选 | 参数类型    | 描述    |
|:---|:---|:---|:---|
| name                 | 是    | String  | 名称    |
| owner                | 是    | String  | 处理者ID |
| plan_start_date      | 是    | String  | 开始时间  |
| plan_start_timestamp | 否    | Long    | 开始时间戳 |
| plan_end_date        | 是    | String  | 结束时间  |
| plan_end_timestamp   | 否    | Long    | 结束时间戳 |
| is_async             | 是    | Boolean | 是否异步  |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| value  | String | **参数解释** 请求返回的数据 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                   |
| status | String | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。   - failed，表示接口调用失败。    |
   
**状态码：400**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                 |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：401**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                 |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：404**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                 |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：500**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                 |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
#### 请求示例
```
post https://{endpoint}/v4/f3087a82b44744c29a1bd69ab6ada154/iterator/2dopbu6aaf/copy
{
  "name" : "迭代1",
  "owner" : "efdb403066474ab08836b9eeaaa23bcb",
  "plan_start_date" : "2021-01-01 00:00:01",
  "plan_end_date" : "2021-01-01 00:00:02",
  "is_async" : true
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : "success"
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。