ListMultipartUploads
Updated at：2025-11-03
API description
This command lists all incomplete Multipart Uploads in a specified bucket. "Incomplete" refers to uploads where InitMultipartUpload is completed, but neither CompleteMultipartUpload nor AbortMultipartUpload has been called. BOS returns up to 1,000 Multipart Uploads per request and supports filtering using prefix and delimiter.
Request
-
Request syntax
Plain Text1GET /?uploads HTTP/1.1 2Host: <BucketName>.bj.bcebos.com 3Date: <Date> 4Authorization: <Authorization_String> -
Request headers
No special request headers
-
Request parameters
| Name | Types | Parameter location | Description | Whether required |
|---|---|---|---|---|
| delimiter | String | Query | Delimiter; primarily used to implement the logic of the list folder | No |
| keyMarker | String | Query |
Used in conjunction with the uploadIdMarker parameter to specify the starting position of response results.
|
No |
| uploadIdMarker | String | Query | Used in conjunction with the keyMarker parameter to specify the starting position of response results.
|
No |
| maxUploads | Int | Query | Maximum number of Multipart Uploads upon this request, defaulting to 1,000, maximum 1,000 | No |
| prefix | String | Query | Key prefix, which must be included in the returned object keys with limits | No |
| uploads | String | Query | The request is labeled as ListMultipartUploads | Yes |
Response
| Name | Types | Description |
|---|---|---|
| bucket | String | Corresponding bucket name |
| commonPrefixes | - | If delimiter is specified in the request, this item will be returned. BOS truncates matched object names according to certain rules (from prefix to the first delimiter), and the truncated strings are deduplicated and returned as CommonPrefixes data |
| delimiter | String | Delimiter value returned upon the request |
| prefix | String | Object prefix |
| isTruncated | Bool | Indicate whether all data has been returned this time.True indicates that not all results are returned this time; False indicates that all results are returned this time |
| keyMarker | String | Starting position of the object specified in this request |
| uploadIdMarker | String | The starting position of the uploadId specified in this request. |
| maxUploads | Int | Maximum number of Multipart Uploads specified by the request to be returned this time |
| nextKeyMarker | String | If not all results are returned in this response, the nextKeyMarker element is included, providing the keyMarker value for the next request. |
| nextUploadIdMarker | String | If not all results are returned this time, the response to request will include nextUploadIdMarker element, indicating the uploadIdMarker value for the next request. |
| uploads | Container | Container storing a MultipartUpload |
| +key | String | Object name |
| +uploadId | String | ID of the MultipartUpload |
| +owner | Container | Information of user to whom this object belongs |
| ++displayName | String | Username |
| ++id | String | User ID |
| +initiated | Date | Start time of this MultipartUpload |
| +storageClass | String | Object storage class. Return STANDARD_IA for infrequent access storage, COLD for cold storage, STANDARD for standard storage, and ARCHIVE for archive storage; if it is multi-AZ bucket, return MAZ_STANDARD_IA for multi-AZ infrequent access storage, and return MAZ_STANDARD for multi-AZ standard storage. |
Note: The Delimiter here is similar to that of Listobjects. Refer to the Listobjects API description.
Example
-
Request example
Plain Text1GET /?uploads HTTP/1.1 2Host: BucketName.bj.bcebos.com 3Date: Wed, 06 Apr 2016 06:34:40 GMT 4Authorization: AuthorizationString -
Response example (JSON)
Plain Text1HTTP/1.1 200 OK 2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409 3Date: Wed, 06 Apr 2016 06:34:40 GMT 4Content-Length: 1330 5Connection: keep-alive 6Server: BceBos 7{ 8 "bucket": "bucket", 9 "keyMarker": "", 10 "nextKeyMarker": "my-movie.m2ts", 11 "nextUploadMarker": "c41cc9aad11cbd637851767bab156984", 12 "maxUploads": 3, 13 "isTruncated": true, 14 "uploads": [ 15 { 16 "key": "my-divisor", 17 "uploadId": "a44cc9bab11bdc157676984aad851637", 18 "owner": { 19 "id": "75aa57f09aa0c8caeab4aeebf76c078efc7c6caea54ba06a", 20 "displayName": "OwnerDisplayName" 21 }, 22 "initiated": "2010-11-10T20:48:33Z", 23 "storageClass": "STANDARD_IA" 24 }, 25 { 26 "key": "my-movie", 27 "uploadId": "b44cc9bab11cbd156984767aad637851", 28 "owner": { 29 "id": "b1d16700c70b0b05597d7acd6a3f92be", 30 "displayName": "OwnerDisplayName" 31 }, 32 "initiated": "2010-11-10T20:48:33Z", 33 "storageClass": "STANDARD" 34 }, 35 { 36 "key": "my-movie.m2ts", 37 "uploadId": "b41cc9aad11cbd637851767bab156984", 38 "owner": { 39 "id": "b1d16700c70b0b05597d7acd6a3f92be", 40 "displayName": "OwnerDisplayName" 41 }, 42 "initiated": "2010-11-10T10:49:33Z", 43 "storageClass": "STANDARD_IA" 44 }, 45 { 46 "key": "my-movie.m2ts", 47 "uploadId": "c41cc9aad11cbd637851767bab156984", 48 "owner": { 49 "id": "b1d16700c70b0b05597d7acd6a3f92be", 50 "displayName": "OwnerDisplayName" 51 }, 52 "initiated": "2010-11-10T20:49:33Z", 53 "storageClass": "STANDARD_IA" 54 } 55 ] 56}