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. 错误码

该接口没有特殊错误码,错误码可以参考公共错误码

个结果匹配 ""

    无结果匹配 ""