# 复制SSH密钥对(V2)
#### 功能介绍
在同一个租户下可能包含多个用户账号，将同一租户下目标用户账号下的密钥对复制到当前用户账号下。
#### URI
- URI格式 POST /v2/{project_id}/os-keypairs/copy
  
- 参数说明
  表1参数说明 
  | 参数                | 是否必选    | 参数类型    | 描述          |
  |:---|:---|:---|:---|
  | project_id | 是 | String | 项目ID。 |
     
  
 
#### 请求消息
表2请求参数 
| 参数         | 是否必选 | 参数类型    | 描述           |
|:---|:---|:---|:---|
| user_name | 是    | String  | 同一租户下的目标用户名。 |
| force     | 否     | Boolean | 是否强制覆盖已有密钥对。 |
   
#### 响应消息
表3响应参数 
| 参数                       | 是否必选 | 参数类型                              | 描述                                                                                        |
|:---|:---|:---|:---|
| changed                    | 是         | Integer                                | 复制的密钥对数量。                                                                                    |
| success | 是       | Array of objects | 复制成功的密钥对列表，详情请参见[表4]。 |
| failed                   | 是        | Array of objects                  | 复制失败的密钥对列表，详情请参见[表4]。                   |
   
 表4success/failed字段数据结构说明 
| 参数                       | 是否必选 | 参数类型                     | 描述                        |
|:---|:---|:---|:---|
| keypair | 是       | String | 密钥对名称。 |
| message                  | 是     | String                 | 任务消息                    |
   
#### 示例
- 请求样例
  ```
  {
   "user_name": "kpsuser"
  }
  ```
  
 
- 响应样例
  ```
  {
      "changed": 2,
      "success": [
          {
              "keypair": "KeyPair-test1",
              "message": "imported"
          },
          {
              "keypair": "KeyPair-test2",
              "message": "imported"
          }
      ],
      "failed": [
          {
              "keypair": "KeyPair-test3",
              "message": "exist"
          }
      ]
  }
  ```
  或
  ```
  {
      "error_code": "KPS.XXXX",
      "error_msg": "XXXX"
  }
  ```
  
#### 状态码
请参考[状态码](https://support.huaweicloud.com/api-dew/dew_02_0301.html)。