通过 COPY 创建文件 (PUT Object Copy)
客户端可以使用该模式通过拷贝 (Copy) 七牛云存储的已有对象 (Object) 创建新的对象,或对已有对象重命名。
请求定义
PUT /<BucketName>/<ObjectName> HTTP/1.1
Host: api-s3.qiniu.com
Date: <date>
X-Amz-Copy-Source: </srcBucketName/srcObjectName>
请求参数
该接口未定义请求参数
请求头
除 请求头 (HTTP Request Header) 外,该接口定义了以下请求头:
该接口定义了以下请求参数:
名称 | 描述 | 要求 |
---|---|---|
X-Amz-Copy-Source | 指定拷贝的原始对象 | Y |
X-Amz-Metadata-Directive | 指定拷贝行为,可选值为 COPY/REPLACE,默认为 COPY | N |
X-Amz-Metadata-Operation | 指定拷贝动作,可选值为 RENAME,默认为空 | N |
- Y, 必须
- N, 可选
注意:
X-Amz-Metadata-Operation
系七牛云存储独有扩展属性,非 AWS S3 标准特性!
请求数据
该接口未定义请求数据
响应定义
该接口正确处理请求时返回如下 XML 数据
<?xml version="1.0" encoding="UTF-8"?>
<CopyObjectResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<ETag>hash</ETag>
<LastModified>2018-01-08 15:51:05.371</LastModified>
</CopyObjectResult>