1. Copy Object
1.1. 描述
用于拷贝一个已经存在的object,到另外一个object,该操作需要指定目标bucket和object名。
1.2. 请求地址
PUT /{bucket}/{object}
1.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表示拷贝源对象的元数据 | 否 |
1.4. 请求参数
无
1.5. 请求体
上传的文件对象
1.6. 响应头
该响应头信息请参考【公共参数】部分。
1.7. 响应体
Name | Type | Description |
---|---|---|
etag | String | 新对象eTag值 |
lastModifiedDate | Date | 最后修改时间 |
expirationTime | Date | 对象过期时间 |
expirationTimeRuleId | String | 对象过期时间规则ID |
1.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 |
1.9. 返回结果
1.9.1. 返回正确结果示例
{
"etag":"d41d8cd98f00b204e9800998ecf8427e",
"lastModifiedDate":1534923892884
}
1.10. 错误码
该接口没有特殊错误码,错误码可以参考公共错误码