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

POST

/v4/oss/copy-multipart-upload

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

开发未对齐原因：公有云没有该接口，按照py接口开发的

请求参数

Authorization

在 header 添加参数

userID

示例：

userID: ********************

Header 参数

Body 参数application/json

示例

{
    "regionID": "nm8",
    "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 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/oss/copy-multipart-upload' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'userID: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "nm8",
    "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": "",
    "error": "Success",
    "errorCode": "Success",
    "message": "",
    "returnObj": {
        "copyPartResult": {
            "eTag": "13d118b72095d2454090b9c2d7c734e3",
            "lastModified": "2024-06-06T10:38:32Z"
        }
    },
    "statusCode": 800
}

修改于 2025-08-07 08:26:51

完成整个文件的分片上传

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