文档中心 > ListPart
ListPart

最近更新时间:2022-01-18

使用ListPart接口浏览分片上传中的片内容。

请求

请求语法

GET /ObjectName?uploadId=UploadId HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date: Date

Authorization: authorization string

请求参数

参数

描述

encoding-type

指定的编码方法。

uploadId

upload ID标识被浏览的分片上传。

max-parts

设置返回的响应主体中包括的最大片数量。

part-number-marker

标识浏览的开始片。大于该片的编号才会被浏览。

响应

响应元素

参数

描述

x-amz-abort-date

标识什么时候初始化的分片上传将成为资格终止操作。

x-amz-abort-rule-id

这个头是随着x-amz-abort-date头返回,标识终止未完成的分片上传的生命周期配置策略。

ListPartsResult

响应容器。

Bucket

分片上传在哪个bucket中初始化。

Encoding-Type

在响应XML中的object的编码类型。

Key

分片上传为哪个object进行了初始化。

UploadId

upload ID标识被浏览的分片上传。

Initiator

启动一个分片上传的元素容器。

ID

如果当事人是一个账户,它提供了典型的用户ID。

DisplayName

典型的用户名。

Owner

object被创建后的object拥有者成员容器。

StorageClass

被用来存储上传object的存储类。

PartNumberMarker

浏览片的开始编号。

NextPartNumberMarker

当一个列表被截断时,这个元素指定了列表中的最后一片,以及在随后的请求中使用part-number-marker请求参数的值。

MaxParts

响应中允许的最大片个数。

IsTruncated

标识返回列表是否被截断。

Part

关联特定片的元素容器。

PartNumber

标记片的编号。

LastModified

该片被上传的日期和时间。

ETag

分片片被上传完成返回的实体标签。

Size

分片上传的数据大小。

示例

请求示例

GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date: Mon, 1 Nov 2010 20:34:56 GMT

Authorization: authorization string

  

HTTP/1.1 200 OK

x-amz-id-2: Uuag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==

x-amz-request-id: 656c76696e6727732072657175657374

Date: Mon, 1 Nov 2010 20:34:56 GMT

Content-Length: 985

Connection: keep-alive

Server: nginx

返回示例

<?xml version="1.0" encoding="UTF-8"?>

<ListPartsResult xmlns="http://region.unicloudsrv.com/doc/2006-03-01/">

  <Bucket>example-bucket</Bucket>

  <Key>example-object</Key>

  <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId>

  <Initiator>

      <ID>arn:aws:iam::111122223333:user/some-user-11116a31-17b5-4fb7-9df5-b288870f11xx</ID>

      <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>

  </Initiator>

  <Owner>

    <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>

    <DisplayName>someName</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

  <PartNumberMarker>1</PartNumberMarker>

  <NextPartNumberMarker>3</NextPartNumberMarker>

  <MaxParts>2</MaxParts>

  <IsTruncated>true</IsTruncated>

  <Part>

    <PartNumber>2</PartNumber>

    <LastModified>2010-11-10T20:48:34.000Z</LastModified>

    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>

    <Size>10485760</Size>

  </Part>

  <Part>

    <PartNumber>3</PartNumber>

    <LastModified>2010-11-10T20:48:33.000Z</LastModified>

    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>

    <Size>10485760</Size>

  </Part>

</ListPartsResult>