
Lists the parts that have been uploaded for a specific multipart upload.
This operation must include the upload ID, which you obtain by sending
the initiate multipart upload request (see CreateMultipartUpload). This
request returns a maximum of 1,000 uploaded parts. The default number of
parts returned is 1,000 parts. You can restrict the number of parts
returned by specifying the max-parts
request parameter. If your
multipart upload consists of more than 1,000 parts, the response returns
an IsTruncated
field with the value of true, and a
NextPartNumberMarker
element. In subsequent ListParts
requests you
can include the part-number-marker query string parameter and set its
value to the NextPartNumberMarker
field value from the previous
response.
s3_list_parts(Bucket, Key, MaxParts, PartNumberMarker, UploadId,
RequestPayer)
[required] Name of the bucket to which the parts are being uploaded.
When using this API with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this operation using an access point through the AWS SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using Access Points in the Amazon Simple Storage Service Developer Guide.
[required] Object key for which the multipart upload was initiated.
Sets the maximum number of parts to return.
Specifies the part after which listing should begin. Only parts with higher part numbers will be listed.
[required] Upload ID identifying the multipart upload whose parts are being listed.
svc$list_parts( Bucket = "string", Key = "string", MaxParts = 123, PartNumberMarker = 123, UploadId = "string", RequestPayer = "requester" )
For more information on multipart uploads, see Uploading Objects Using Multipart Upload.
For information on permissions required to use the multipart upload API, see Multipart Upload API and Permissions.
The following operations are related to ListParts
:
CreateMultipartUpload
UploadPart
CompleteMultipartUpload
AbortMultipartUpload
ListMultipartUploads
# NOT RUN {
# The following example lists parts uploaded for a specific multipart
# upload.
svc$list_parts(
Bucket = "examplebucket",
Key = "bigobject",
UploadId = "example7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP..."
)
# }
# NOT RUN {
# }
Run the code above in your browser using DataLab