You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

ListParts

最近更新时间：2024.01.15 15:20:42

首次发布时间：2021.10.13 16:14:08

我的收藏

功能描述

此接口用于列举指定 UploadId 的已上传的分片，这个请求最多返回 1000 个上传的分片。默认返回的分片信息数量是 1000 个，您可以通过指定max-parts请求参数来限制返回的分片数量。如果您的分片上传包含超过 1000 个分片，响应将返回一个值为true的IsTruncated字段和一个NextPartNumberMarker元素。在后续的ListParts请求中，您可以包含part-number-marker查询字符串参数，并将其值设置为来自前一个响应的NextPartNumberMarker字段值。

请求消息样式

GET /objectName?uploadId=UploadId HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称

位置

参数类型

是否必选

示例值

说明

uploadId

Query

String

是

f93f6fc9da94371f321e1008

初始化分片任务返回的分片任务 ID，用于唯一标识上传的分片属于哪个对象。

max-parts

Query

Integer

否

100

返回分片的最大数量，最大值为 1000，即一次请求最多返回 1000 个分片。

part-number-marker

Query

Integer

否

1

指定分片号的起始位置，只列举分片号大于此值的段。

请求元素

该请求无请求消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称

参数类型

说明

Bucket

String

桶名。

Key

String

对象名。

UploadId

String

分片任务 ID。

MaxParts

Integer

请求参数中的 max-parts。

PartNumberMarker

Integer

请求参数中的 part-number-marker。

IsTruncated

Bool

返回的结果是否被截断，取值说明如下：

  • false：已返回全部结果。
  • true：还有结果未返回。

NextPartNumberMarker

Integer

如果结果未完全返回，标识下次请求的 part-number-marker 值。

StorageClass

String

分片上传任务的存储类型，取值说明如下：

  • STANDARD：标准存储。
  • IA：低频访问存储。
  • INTELLIGENT_TIERING：智能分层存储。
  • ARCHIVE_FR：归档闪回存储。
  • ARCHIVE：归档存储。
  • COLD_ARCHIVE：冷归档存储。
  • DEEP_COLD_ARCHIVE：深度冷归档存储。

    说明

    深度冷归档目前处于邀测状态，如您需要使用该存储类型，请联系客户经理。

Parts

Array

分片信息的根节点。

PartNumber

Integer

分片号。父节点为 Parts。

LastModified

String

分片上传的时间。父节点为 Parts。

ETag

String

分片内容的 ETag。父节点为 Parts。

Size

Integer

分片大小。父节点为 Parts。

Owner

Object

分片上传任务的创建者。

ID

String

账号 ID。父节点为 Owner。

DisplayName

String

账号名。父节点为 Owner。

请求示例

GET /objectName?uploadId=UploadId HTTP/1.1 
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 00:15:25 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
x-tos-id-2: 4fac130c7ea5003e-a444ed0        
x-tos-request-id: 4fac130c7ea5003e-a444ed0            
Date: Fri, 30 Jul 2021 00:15:25 GMT   
server: TosServer
Content-Length: 693

{
    "Bucket": "bucketName",
    "Key": "multiobj1",
    "UploadId": "f93f6fc90d5f371f4f18c0b1",
    "PartNumberMarker": 0,
    "NextPartNumberMarker": 0,
    "MaxParts": 1000,
    "IsTruncated": false,
    "StorageClass": "STANDARD",
    "Owner": {
        "ID": "AccountID"
    },
    "Parts": [
        {
            "PartNumber": 1,
            "LastModified": "2021-08-20T06:43:49Z",
            "ETag": "\"7de47c292287f7965357c1ddd724b2b7\"",
            "Size": 10
        }
    ]
}