从一个已存在的Object中拷贝数据来上传一个Part

POST

/v4/oss/copy-multipart-upload

可以将已经存在的Object作为分段上传的片段，拷贝生成一个新的片段。UploadId为新对象的分片上传ID。在上传任何一个分片之前，必须执行Initial Multipart Upload操作来初始化分片上传操作，初始化成功后，OOS会返回一个上传ID，这是一个唯一的标识，用户必须在调用Copy Part接口时加入该ID。

混合云特有接口

请求参数

Body 参数application/json

regionID

string

资源池id

必需

bucket

string

桶名称

必需

key

string

文件key

必需

uploadID

string

分段上传的ID

必需

copySource

object

复制的桶的源

必需

bucket

string

复制的桶

必需

key

string

复制的文件

必需

versionId

string

版本id

可选

partNumber

integer <int32>

复制的序号

必需

示例

{
    "regionID": "TestRegionID",
    "bucket": "ztces-230404-create",
    "key": "ces5.txt",
    "uploadId": "2~KnfwmQuTWCDLXkAw7FbX8g42oQDc-75",
    "copySource": {
        "bucket": "bucket-fileupload-143",
        "key": "zhr-964.txt"
    },
    "partNumber": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/oss/copy-multipart-upload' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "bucket": "ztces-230404-create",
    "key": "ces5.txt",
    "uploadId": "2~KnfwmQuTWCDLXkAw7FbX8g42oQDc-75",
    "copySource": {
        "bucket": "bucket-fileupload-143",
        "key": "zhr-964.txt"
    },
    "partNumber": 1
}'

返回响应

🟢200successful operation

application/json

Body

description

string

描述

可选

errorCode

string

错误码

可选

message

string

错误说明

可选

returnObj

array [object {1}]

响应对象

可选

copyPartResult

object

文件

可选

statusCode

integer <int32>

请求状态码

可选

示例

{
    "description": "string",
    "errorCode": "string",
    "message": "string",
    "returnObj": [
        {
            "copyPartResult": {
                "eTag": "string",
                "lastModified": "string"
            }
        }
    ],
    "statusCode": 0
}

修改于 2024-05-13 10:08:43

完成整个文件的分片上传

用于取消MultipartUpload事件并删除对应的Part数据