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.
If the upload was created using a checksum algorithm, you will need to have permission
to the kms:Decrypt action for the request to succeed.
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 anIsTruncated
field with the value of true, and aNextPartNumberMarker
element. In subsequentListParts
requests you can include the part-number-marker query string parameter and set its value to theNextPartNumberMarker
field value from the previous response.If the upload was created using a checksum algorithm, you will need to have permission to the
kms:Decrypt
action for the request to succeed.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 and Permissions.
The following operations are related to
ListParts
:CreateMultipartUpload
UploadPart
CompleteMultipartUpload
AbortMultipartUpload
GetObjectAttributes
ListMultipartUploads
Use a bare-bones client and the command you need to make an API call.
import { S3Client, ListPartsCommand } from "@aws-sdk/client-s3"; // ES Modules import // const { S3Client, ListPartsCommand } = require("@aws-sdk/client-s3"); // CommonJS import const client = new S3Client(config); const command = new ListPartsCommand(input); const response = await client.send(command);
ListPartsCommandInput for command's
input
shape.ListPartsCommandOutput for command's
response
shape.config for S3Client's
config
shape.