# 复制大屏
#### 功能介绍
基于已有的大屏复制出一个新的大屏，大屏名称加后缀_copy。
#### URI
- URI格式
  ```
  POST /v1/{project_id}/screens/{screen_id}/copy
  ```
  
- 参数说明
  表1URI参数说明 
  | 参数         | 是否必选 | 参数类型   | 描述                                                                                  |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-dlv/dlv_02_0501.html)。     |
  | screen_id  | 是    | String | 被复制的大屏ID，获取方法请参见[查询大屏列表](https://support.huaweicloud.com/api-dlv/dlv_02_0525.html)。 |
     
  
 
#### 请求消息
参数说明：如[表2]所示。
 表2请求参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                |
|:---|:---|:---|:---|
| workspaceId | 是    | String | 工作空间ID，长度为32个字符，获取方法请参见[获取workspaceId](https://support.huaweicloud.com/api-dlv/dlv_02_0605.html)。 |
   
#### 响应消息
参数说明：如[表3]所示。
 表3参数说明 
| 参数          | 参数类型    | 描述                                 |
|:---|:---|:---|
| id          | String  | 大屏ID                               |
| name        | String  | 大屏名称                               |
| alias       | String  | 大屏别名                               |
| description | String  | 大屏的描述信息                            |
| status      | Integer | 大屏状态：0-created，1- deleted，2-shared |
| projectId   | String  | 项目编号，即project_id                   |
| createUser  | String  | 大屏的创建者                             |
| createDate  | Integer | 大屏的创建时间戳                           |
| updateUser  | String  | 大屏的更新者                             |
| updateDate  | Integer | 大屏的更新时间戳                           |
| templateId  | String  | 创建大屏时使用的模板ID                       |
| snapshotId  | String  | 大屏快照的ID                            |
| share       | String  | 大屏分享的UUID标识                        |
| thumbnail   | String  | 大屏缩略图的访问地址                         |
| config      | JSON    | 大屏的配置内容                            |
   
#### 示例
- 请求示例
  ```
  POST https://{dlv_endpoint}/v1/{project_id}/screens/ff80808167813a360167819d5b640045/copy
  {请求消息头}
  {
      "workspaceId": "86ce107974ce4f93b618acb232863027"
  }
  ```
  
  
- 成功响应示例
  ```
  {
      "id": "ff80808167813a360167825a27b00073",
      "name": "screen_01_copy",
      "alias": "test_screen_01",
      "description": "for test",
      "status": 0,
      "projectId": "abcdefghijk0123456",
      "createUser": "a1b2c2d3e4f5g6h5j6k6",
      "createDate": 1544080205744,
      "updateUser": null,
      "updateDate": null,
      "templateId": "32546212564",
      "snapshotId": null,
      "share": null,
      "thumbnail": null,
      "config": null
  }
  ```
  
  
- 失败响应示例
  ```
  {
      "errors": [
          {
              "error_code": "1004",
              "error_msg": "The operation with the resource entity occur some error."
          }
      ]
  }
  ```
  
 
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-dlv/dlv_02_0603.html)。