MultipartUpload / Collection / parts

parts#

S3.MultipartUpload.parts#

A collection of MultipartUploadPart resources.A MultipartUploadPart Collection will include all resources by default, and extreme caution should be taken when performing actions on all resources.

all()#

Creates an iterable of all MultipartUploadPart resources in the collection.

See also: AWS API Documentation

Request Syntax

multipart_upload_part_iterator = multipart_upload.parts.all()
Return type:

list(s3.MultipartUploadPart)

Returns:

A list of MultipartUploadPart resources

filter(**kwargs)#

Creates an iterable of all MultipartUploadPart resources in the collection filtered by kwargs passed to method. A MultipartUploadPart collection will include all resources by default if no filters are provided, and extreme caution should be taken when performing actions on all resources.

See also: AWS API Documentation

Request Syntax

multipart_upload_part_iterator = multipart_upload.parts.filter(
    MaxParts=123,
    PartNumberMarker=123,
    RequestPayer='requester',
    ExpectedBucketOwner='string',
    SSECustomerAlgorithm='string',
    SSECustomerKey='string',

)
Parameters:

  • MaxParts (integer) – Sets the maximum number of parts to return.

  • PartNumberMarker (integer) – Specifies the part after which listing should begin. Only parts with higher part numbers will be listed.

  • RequestPayer (string) –

    Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for corresponding charges to copy the object. For information about downloading objects from Requester Pays buckets, see Downloading Objects in Requester Pays Buckets in the Amazon S3 User Guide.

    Note

    This functionality is not supported for directory buckets.

  • ExpectedBucketOwner (string) – The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code 403 Forbidden (access denied).

  • SSECustomerAlgorithm (string) –

    The server-side encryption (SSE) algorithm used to encrypt the object. This parameter is needed only when the object was created using a checksum algorithm. For more information, see Protecting data using SSE-C keys in the Amazon S3 User Guide.

    Note

    This functionality is not supported for directory buckets.

  • SSECustomerKey (string) –

    The server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see Protecting data using SSE-C keys in the Amazon S3 User Guide.

    Note

    This functionality is not supported for directory buckets.

  • SSECustomerKeyMD5 (string) –

    The MD5 server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see Protecting data using SSE-C keys in the Amazon S3 User Guide.

    Note

    This functionality is not supported for directory buckets.

    Please note that this parameter is automatically populated if it is not provided. Including this parameter is not required

Return type:

list(s3.MultipartUploadPart)

Returns:

A list of MultipartUploadPart resources

limit(**kwargs)#

Creates an iterable up to a specified amount of MultipartUploadPart resources in the collection.

See also: AWS API Documentation

Request Syntax

multipart_upload_part_iterator = multipart_upload.parts.limit(
    count=123
)
Parameters:

count (integer) – The limit to the number of resources in the iterable.

Return type:

list(s3.MultipartUploadPart)

Returns:

A list of MultipartUploadPart resources

page_size(**kwargs)#

Creates an iterable of all MultipartUploadPart resources in the collection, but limits the number of items returned by each service call by the specified amount.

See also: AWS API Documentation

Request Syntax

multipart_upload_part_iterator = multipart_upload.parts.page_size(
    count=123
)
Parameters:

count (integer) – The number of items returned by each service call

Return type:

list(s3.MultipartUploadPart)

Returns:

A list of MultipartUploadPart resources