List all uploaded parts associated with a specified upload ID.
Usage notes
Results are sorted in ascending order by part number.
Do not use part numbers and ETag values from ListParts results to reconstruct the uploaded parts list. Network errors during transmission can cause inconsistencies. Track uploaded parts in your own application instead.
Permissions
By default, an Alibaba Cloud account has full permissions. RAM users and RAM roles have no permissions by default. Grant the required permissions through RAM Policy or Bucket Policy.
| API | Action | Description |
|---|---|---|
| ListParts | oss:ListParts | Lists all parts uploaded under a given upload ID |
Command syntax
ossutil api list-parts --bucket <value> --key <value> --upload-id <value> [flags]| Parameter | Type | Description |
|---|---|---|
--bucket | string | Name of the bucket |
--key | string | Full path of the object |
--upload-id | string | ID of the multipart upload task |
--encoding-type | string | Encoding type of the object name in the response |
--max-parts | int | Maximum number of parts returned per request |
--part-number-marker | int | Position from which the list starts. All parts with part numbers greater than this value are listed. |
list-parts maps to the ListParts API operation. For supported global flags, see Command-line options.Examples
List all uploaded parts for an object
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123Return output in JSON format
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format jsonReturn output in YAML format
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format yamlLimit the number of returned parts
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --max-parts 100URL-encode the object name in the response
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --encoding-type url