# **获取已上传成功的分片列表-ListParts**

## **简介**

获取未完成分片上传的对象的已上传成功的分片列表。

## **定义**

### **句法（Syntax）:**

```
GET /?muploadpart&uploadId=<uploadid>
Host: <bucket_name>.ufile.ucloud.cn
Authorization: <token>
```

### **请求参数（Request Parameters）**

| Parameter name | Type | Description | Required |
| --- | --- | --- | --- |
| uploadId | string | 上传ID。 | Yes |
| max-parts | Integer | 规定在US3响应中的最大Part数目。 | No |
| part-number-marker | Integer | 指定List的起始位置，只有Part Number数目大于该参数的Part会被列出。 | No |

### **响应（Responses）**

| Parameter name | Type | Description |
| --- | --- | --- |
| UploadId | string | 上传ID |
| Bucket | string | 空间名称 |
| Key | string | 文件名称 |
| Parts | array | 分片列表 |
| MaxParts | Integer | 返回请求中最大的Part数目。 |
| IsTruncated | Bool | 标明本次返回的ListParts结果列表是否被截断。 |
| Parts | Array | 分片信息。 |
| NextPartNumberMarker | Integer | 如果本次没有返回全部结果，响应请求中将包含NextPartNumberMarker元素，用于标明接下来请求的PartNumberMarker值。 |

### **分片信息（PartsItem）**

| Parameter name | Type | Description |
| --- | --- | --- |
| PartNum | Integer | 分片编号。 |
| Etag | string | 分片etag值。 |
| LastModified | Integer | Part上传的时间。 |
| Size | Integer | 已上传Part大小。 |

## **示例**

### **请求示例（Example Request）:**

```
GET /?muploadpart&uploadId=e5af977e-329c-4a25-b907-d8bc39ff95e3 HTTP/1.1
Host: example.cn-bj.ufileos.ucloud.cn
Authorization:xxx pRAtiCbYdYI9wqHMqcQe0D9m16YpTsKBVL3GeBZ6wn6N+00uMrI7NQ==:VdDRXKoBjX6FnxjOz+HbLtswW50=
```

### **响应示例（Example Response）:**
```
{
    "UploadId": "e5af977e-329c-4a25-b907-d8bc39ff95e3",
    "Key": "large_file_version_4",
    "Bucket": "example",
    "Parts": [
        {
            "Etag": "K8y9LzjxXBPrfVqJ_Z2F9ZXiO8M=",
            "PartNum": 0,
            "LastModified": 1699432473,
            "Size": 33554432

        },
        {
            "Etag": "K8y9LzjxXBPrfVqJ_Z2F9ZXiO8M=",
            "PartNum": 1,
            "LastModified": 1699432473,
            "Size": 33554432
        },
        {
            "Etag": "8AELsK7_teqWNDghPCj9IdowvBA=",
            "PartNum": 2,
            "LastModified": 1699432473,
            "Size": 33554432
        }
    ]
}
```