全部产品
Search
文档中心

网盘与相册服务:ListUploadedParts - 列举已上传分片

更新时间:May 12, 2026

列举已上传成功的多段。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/file/list_uploaded_parts HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

domain_id

string

body

object

请求体参数。

part_number_marker

integer

设定结果从 marker 之后按字母排序的第一个开始返回。如果不设定,则从头开始返回数据。 默认值:无

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

limit

integer

限定此次返回资源的数量。如果不设定,默认返回 100,最大不能超过 100。

100

upload_id

string

上传 id

00166D06127B413BA1EC8ABB1144D101

file_id

string

文件 id

322fb07b975f4b0ae1b543fe8475eee4c19eb2b2

drive_id

string

空间 id,除根据分享链接上传之外的其他场景,必填

1

share_id

string

分享 id,当根据分享链接上传时必填

7JQX1FswpQ8

返回参数

名称

类型

描述

示例值

object

Schema of Response

file_id

string

文件 id

322fb07b975f4b0ae1b543fe8475eee4c19eb2b2

upload_id

string

上传 id

00166D06127B413BA1EC8ABB1144D101

uploaded_parts

array

分段信息列表

UploadPartInfo

分段信息

next_part_number_marker

string

下一页起始资源标识符, 最后一页该值为空。

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

parallel_upload

boolean

是否并行上传

false

示例

正常返回示例

JSON格式

{
  "file_id": "322fb07b975f4b0ae1b543fe8475eee4c19eb2b2",
  "upload_id": "00166D06127B413BA1EC8ABB1144D101",
  "uploaded_parts": [
    {
      "part_number": 1,
      "part_size": 1024,
      "upload_url": "https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661",
      "internal_upload_url": "https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\n",
      "etag": "\"0CC175B9C0F1B6A831C399E269772661\"",
      "parallel_sha1_ctx": {
        "h": [
          0
        ],
        "part_offset": 10240
      },
      "upload_form_info": {
        "endpoint": "",
        "form_data": {
          "key": ""
        }
      },
      "parallel_sha256_ctx": {
        "h": [
          0
        ],
        "part_offset": 0
      }
    }
  ],
  "next_part_number_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
  "parallel_upload": false
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情