copy-object
Copy Object
1. 描述
用于拷贝一个已经存在的object，到另外一个object，该操作需要指定目标bucket和object名。
2. 请求地址
PUT /{bucket}/{object}
3. 请求头
| Name | Type | Description | Required |
|---|---|---|---|
| x-amz-acl | String | 定义Bucket访问权限，有效值：inherit,private和public-read，默认值：inherit | 否 |
| x-oss-meta-* | String | 自定义metadata | 否 |
| x-amz-copy-source | String | /{源bucket}/{源object} | 是 |
| x-amz-metadata-directive | String | 是否拷贝源对象元数据--REPLACE表示不拷贝、COPY表示拷贝源对象的元数据 | 否 |
4. 请求参数
无
5. 请求体
上传的文件对象
6. 响应头
该响应头信息请参考【公共参数】部分。
7. 响应体
| Name | Type | Description |
|---|---|---|
| etag | String | 新对象eTag值 |
| lastModifiedDate | Date | 最后修改时间 |
| expirationTime | Date | 对象过期时间 |
| expirationTimeRuleId | String | 对象过期时间规则ID |
8. 请求示例
PUT /bucket123/y.txt HTTP/1.1
Host: cn-east-1.cloud-oss.com
Date: Thu, 15 Nov 2018 13:27:48 GMT
Nonce: 5e72e157-f4e3-4180-9062-7c7127939faa
Authorization: YCS1-HMAC-SHA1 Credential=5adb2538-9333-4024-b757-e095fc609a84, SignedHeaders=date;nonce;version, Signature=5KmNSmZ7/vlWNti0cgNpJFiQNMY=
Version: 2018-10-30
x-amz-acl: private
x-amz-copy-source: /bucket123/x.txt
x-amz-metadata-directive: COPY
9. 返回示例
{
"etag":"d41d8cd98f00b204e9800998ecf8427e",
"lastModifiedDate":1534923892884
}
10. 错误码
该接口没有特殊错误码，错误码可以参考公共错误码