接口介绍
此接口用于从一个已存在的Object中拷贝数据来上传一个分片。
接口约束
无
请求URI
PUT /v2/uploads/{bucket}/{objectName}
路径参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
bucket | 是 | String | 桶名称 | testBucket |
objectName | 是 | String | 对象名称 | test |
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
partNumber | 是 | Integer | 对象名称分片编号 | 1 | |
uploadId | 是 | String | 对象名称 | 上传对象任务ID |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
x-amz-copy-source | 是 | String | 源的桶名称和对象名称 | /bucket1/object1 |
此接口涉及的其他公共请求头,例如Host、Date等的更多信息,请参见公共HTTP头。
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
CopyPartResult | Container | 结果列表 | -- | |
LastModified | String | 最后更新时间 | 2011-04-11T20:34:56.000Z | LastModified、ETag |
ETag | String | 对象的tag标识 | 9b2cf535f27731c974343645a3985328 |
请求示例
PUT /v2/uploads/testbucket/test?partNumber=1&uploadId=9GSpv6cxEbmQCXNzLf6mMiCPNQ9nIck
请求头header
Host: gdoss.xstore.ctyun.cn
Date: Wed, 28 Oct 2023 09:32:00 GMT
Authorization: authorization string
x-amz-copy-source: /bucket1/object1
请求体body
无
响应示例
HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<CopyPartResult>
<LastModified>2011-04-11T20:34:56.000Z</LastModified>
<ETag>"9b2cf535f27731c974343645a3985328"</ETag>
</CopyPartResult>
状态码
HTTP状态 | 描述 |
---|---|
200 | 操作成功。 |
400 | 拷贝的片段太大。 |
400 | 对象的名字不合法。 |
403 | 用户没有权限执行操作。 |
404 | 请求参数中设置的桶或者对象key不存在。 |