# 复制对象
#### 功能说明
为指定桶中的对象创建一个副本。
#### 方法定义
```
1. ObsClient->copyObject(array $parameter)
2. ObsClient->copyObjectAsync(array $parameter, callable $callback)
```
#### 请求参数
| **字段名**                     | **类型**                                                                    | **约束** | **说明**                                                                                                                                                                  |
|:---|:---|:---|:---|
| Bucket                      | string                                                                    | 必选     | 目标桶名。                                                                                                                                                                   |
| Key                         | string                                                                    | 必选     | 目标对象名。                                                                                                                                                                  |
| ACL                         | string                                                                    | 可选     | 复制对象时可指定的[预定义访问策略](https://support.huaweicloud.com/api-obs_php_sdk_api_zh/obs_38_0204.html)。                                                                            |
| StorageClass                | string                                                                    | 可选     | 复制时设置对象的[存储类型](https://support.huaweicloud.com/api-obs_php_sdk_api_zh/obs_38_0205.html)。                                                                                |
| CopySource                  | string                                                                    | 必选     | 指定源桶、源对象和源对象版本号（可为空）的参数，格式：源桶名/源对象名?versionId=源对象版本号。                                                                                                                   |
| CopySourceIfMatch           | string                                                                    | 可选     | 如果源对象的ETag值与该参数值相同，则进行复制，否则抛出异常。                                                                                                                                        |
| CopySourceIfModifiedSince   | string 或 \\DateTime | 可选     | 如果源对象的修改时间晚于该参数值指定的时间，则进行复制，否则抛出异常。该参数值为字符串时必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。                                                                         |
| CopySourceIfNoneMatch       | string                                                                    | 可选     | 如果源对象的ETag值与该参数值不相同，则进行复制，否则抛出异常。                                                                                                                                       |
| CopySourceIfUnmodifiedSince | string 或 \\DateTime  | 可选     | 如果源对象的修改时间早于该参数值指定的时间，则进行复制，否则抛出异常。该参数值为字符串时必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。                                                                         |
| CacheControl                | string                                                                    | 可选     | 复制时重写响应中的Cache-Control头。                                                                                                                                                |
| ContentDisposition          | string                                                                    | 可选     | 复制时重写响应中的Content-Disposition头。                                                                                                                                          |
| ContentEncoding             | string                                                                    | 可选     | 复制时重写响应中的Content-Encoding头。                                                                                                                                             |
| ContentLanguage             | string                                                                    | 可选     | 复制时重写响应中的Content-Language头。                                                                                                                                             |
| ContentType                 | string                                                                    | 可选     | 复制时重写响应中的Content-Type头。常见的contentType（MIME）列表参见[配置、编辑、查看对象元数据](https://support.huaweicloud.com/usermanual-obs/obs_03_0324.html)。                                        |
| Expires                     | string                                                                    | 可选     | 复制时重写响应中的Expires头。                                                                                                                                                      |
| MetadataDirective           | string                                                                    | 可选     | [复制策略](https://support.huaweicloud.com/api-obs_php_sdk_api_zh/obs_38_0208.html)。                                                                                        |
| Metadata                    | associative array                                                         | 可选     | 目标对象的自定义元数据。                                                                                                                                                            |
| WebsiteRedirectLocation     | string                                                                    | 可选     | 当桶设置了Website配置，该参数指明对象的重定向地址。                                                                                                                                           |
| SseKms                      | string                                                                    | 可选     | 以SSE-KMS方式加密目标对象，支持的值： - kms：使用SSE-KMS方式加密目标对象   |
| SseKmsKey                   | string                                                                    | 可选     | SSE-KMS加密方式下使用的KMS主密钥的ID值，为空则默认配置为默认密钥。密钥ID获取方法请参见[查看密钥](https://support.huaweicloud.com/usermanual-dew/dew_01_0179.html)。                                              |
| SseC                        | string                                                                    | 可选     | 以SSE-C方式加密目标对象，支持的值： - AES256             |
| SseCKey                     | string                                                                    | 可选     | SSE-C方式下加密的密钥，该密钥需要您自定义，并由256bit的密钥经过base64编码得到。                                                                                                                        |
| CopySourceSseC              | string                                                                    | 可选     | 以SSE-C方式解密源对象，支持的值： - AES256                   |
| CopySourceSseCKey           | string                                                                    | 可选     | SSE-C方式下解密源对象的密钥，由AES256算法算出。                                                                                                                                           |
   
![](https://support.huaweicloud.com/api-obs_php_sdk_api_zh/public_sys-resources/note_3.0-zh-cn.png)
- 如果包含CopySourceIfUnmodifiedSince并且不符合，或者包含CopySourceIfMatch并且不符合，或者包含CopySourceIfModifiedSince并且不符合，或者包含CopySourceIfNoneMatch并且不符合，抛出异常中HTTP状态码为：412 precondition failed。
- CopySourceIfModifiedSince和CopySourceIfNoneMatch可以一起使用；CopySourceIfUnmodifiedSince和CopySourceIfMatch可以一起使用。
 
#### 返回结果
| **字段名**             | **类型**  | **说明**                                                                                                                     |
|:---|:---|:---|
| HttpStatusCode      | integer | HTTP状态码。                                                                                                                   |
| Reason              | string  | HTTP文本描述。                                                                                                                  |
| RequestId           | string  | OBS服务端返回的请求ID。                                                                                                             |
| ETag                | string  | 目标对象的ETag值。                                                                                                                |
| LastModified        | string  | 目标对象的最近一次修改时间。                                                                                                             |
| VersionId           | string  | 目标对象的版本号，如果目标桶未开启多版本状态则该值为空。                                                                                               |
| CopySourceVersionId | string  | 源对象的版本号，如果源桶未开启多版本状态则该值为空。                                                                                                 |
| SseKms              | string  | SSE-KMS方式的算法。                                                                                                              |
| SseKmsKey           | string  | SSE-KMS加密方式下使用的KMS主密钥的ID值，为空则默认配置为默认密钥。密钥ID获取方法请参见[查看密钥](https://support.huaweicloud.com/usermanual-dew/dew_01_0179.html)。 |
| SseC                | string  | SSE-C方式的算法。                                                                                                                |
| SseCKeyMd5          | string  | SSE-C方式的密钥的MD5值。                                                                                                           |
   
#### 代码样例
```
try{
       $resp = $obsClient -> copyObject([
              'Bucket' => 'bucketname',
              'Key' => 'objectkey',
              'CopySource' => 'srcbucketname/srcobjectkey',
              'Metadata' => ['meta1' => 'value1']
       ]);
       printf("RequestId:%s\n", $resp['RequestId']);
       printf("ETag:%s\n", $resp['ETag']);
       printf("VersionId:%s\n", $resp['VersionId']);
       printf("CopySourceVersionId:%s\n", $resp['CopySourceVersionId']);
       printf("LastModified:%s\n", $resp['LastModified']);
}catch (Obs\Common\ObsException $obsException){
       printf("ExceptionCode:%s\n", $obsException->getExceptionCode());
       printf("ExceptionMessage:%s\n", $obsException->getExceptionMessage());
}
```