com.amazonaws.services.s3.model

Class CompleteMultipartUploadRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.CompleteMultipartUploadRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, ExpectedBucketOwnerRequest, SSECustomerKeyProvider, Serializable, Cloneable

public class CompleteMultipartUploadRequest
extends AmazonWebServiceRequest
implements Serializable, ExpectedBucketOwnerRequest, SSECustomerKeyProvider

Container for the parameters of the CompleteMultipartUpload operation.

If you are performing a complete multipart upload for KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure Amazon Web Services Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify -signature-version

Required Parameters: BucketName, Key, UploadId, PartETags

See Also:

AmazonS3.completeMultipartUpload(CompleteMultipartUploadRequest), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
CompleteMultipartUploadRequest()
CompleteMultipartUploadRequest(String bucketName, String key, String uploadId, List<PartETag> partETags) Constructs a new request to complete a multipart upload.

Method Summary

Modifier and Type	Method and Description
String	getBucketName() Returns the name of the bucket containing the multipart upload to complete.
String	getExpectedBucketOwner() Returns he account id of the expected bucket owner.
String	getIfNoneMatch() Returns the value for the header If-None-Match.
String	getKey() Returns the key under which the multipart upload to complete is stored.
List<PartETag>	getPartETags() Returns the list of part numbers and ETags that identify the individual parts of the multipart upload to complete.
SSECustomerKey	getSSECustomerKey() Returns the optional customer-provided server-side encryption key to use to encrypt the uploaded object.
String	getUploadId() Returns the ID of the multipart upload to complete.
CompleteMultipartUploadRequest	ifNoneMatch(String eTag) Uploads the object only if the object key name does not already exist in the bucket specified.
boolean	isRequesterPays() Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.
void	setBucketName(String bucketName) Sets the name of the bucket containing the multipart upload to complete.
void	setExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
void	setIfNoneMatch(String eTag) Uploads the object only if the object key name does not already exist in the bucket specified.
void	setKey(String key) Sets the key under which the multipart upload to complete is stored.
void	setPartETags(List<PartETag> partETags) Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete.
void	setRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
void	setSSECustomerKey(SSECustomerKey sseKey) Sets the optional customer-provided server-side encryption key to use to encrypt the uploaded object.
void	setUploadId(String uploadId) Sets the ID of the multipart upload to complete.
CompleteMultipartUploadRequest	withBucketName(String bucketName) Sets the name of the bucket containing the multipart upload to complete, and returns this updated CompleteMultipartUploadRequest so that additional method calls can be chained together.
CompleteMultipartUploadRequest	withExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
CompleteMultipartUploadRequest	withKey(String key) Sets the key under which the multipart upload to complete is stored, and returns this updated CompleteMultipartUploadRequest object so that additional method calls can be chained together.
CompleteMultipartUploadRequest	withPartETags(Collection<UploadPartResult> uploadPartResultsCollection) Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete based on the specified results from part uploads.
CompleteMultipartUploadRequest	withPartETags(List<PartETag> partETags) Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete, and returns this updated CompleteMultipartUploadRequest object so that additional method calls can be chained.
CompleteMultipartUploadRequest	withPartETags(UploadPartResult... uploadPartResults) Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete based on the specified results from part uploads.
CompleteMultipartUploadRequest	withRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
CompleteMultipartUploadRequest	withSSECustomerKey(SSECustomerKey sseKey) Sets the optional customer-provided server-side encryption key to use to encrypt the uploaded object, and returns the updated request object so that additional method calls can be chained together.
CompleteMultipartUploadRequest	withUploadId(String uploadId) Sets the ID of the multipart upload to complete, and returns this updated CompleteMultipartUploadRequest object so that additional method calls can be chained together.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

addHandlerContext, clone, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getHandlerContext, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestCredentialsProvider, getRequestMetricCollector, getSdkClientExecutionTimeout, getSdkRequestTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestCredentialsProvider, setRequestMetricCollector, setSdkClientExecutionTimeout, setSdkRequestTimeout, withGeneralProgressListener, withRequestCredentialsProvider, withRequestMetricCollector, withSdkClientExecutionTimeout, withSdkRequestTimeout

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CompleteMultipartUploadRequest

public CompleteMultipartUploadRequest()

CompleteMultipartUploadRequest

public CompleteMultipartUploadRequest(String bucketName,
                                      String key,
                                      String uploadId,
                                      List<PartETag> partETags)

Constructs a new request to complete a multipart upload.

Parameters:

bucketName - The name of the bucket containing the multipart upload to complete.

key - The key of the multipart upload to complete.

uploadId - The ID of the multipart upload to complete.

partETags - The list of part numbers and ETags to use when completing the multipart upload.

Method Detail

getExpectedBucketOwner

public String getExpectedBucketOwner()

Description copied from interface: ExpectedBucketOwnerRequest

Returns he account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Specified by:

getExpectedBucketOwner in interface ExpectedBucketOwnerRequest

withExpectedBucketOwner

public CompleteMultipartUploadRequest withExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

Set the account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Specified by:

withExpectedBucketOwner in interface ExpectedBucketOwnerRequest

setExpectedBucketOwner

public void setExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

Set the account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Specified by:

setExpectedBucketOwner in interface ExpectedBucketOwnerRequest

getBucketName

public String getBucketName()

Returns the name of the bucket containing the multipart upload to complete.

When using this action 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 action with an access point through the Amazon Web Services 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 S3 User Guide.

When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Returns:

The name of the bucket containing the multipart upload to complete.

setBucketName

public void setBucketName(String bucketName)

Sets the name of the bucket containing the multipart upload to complete.

When using this action 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 action with an access point through the Amazon Web Services 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 S3 User Guide.

When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Parameters:

bucketName - The name of the bucket containing the multipart upload to complete.

withBucketName

public CompleteMultipartUploadRequest withBucketName(String bucketName)

Sets the name of the bucket containing the multipart upload to complete, and returns this updated CompleteMultipartUploadRequest so that additional method calls can be chained together.

When using this action 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 action with an access point through the Amazon Web Services 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 S3 User Guide.

When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Parameters:

bucketName - The name of the bucket containing the multipart upload to complete.

Returns:

The updated CompleteMultipartUploadRequest.

getKey

public String getKey()

Returns the key under which the multipart upload to complete is stored.

Returns:

The key under which the multipart upload to complete is stored.

setKey

public void setKey(String key)

Sets the key under which the multipart upload to complete is stored.

Parameters:

key - The key under which the multipart upload to complete is stored.

withKey

public CompleteMultipartUploadRequest withKey(String key)

Sets the key under which the multipart upload to complete is stored, and returns this updated CompleteMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

key - The key under which the multipart upload to complete is stored.

Returns:

This updated CompleteMultipartUploadRequest object.

getUploadId

public String getUploadId()

Returns the ID of the multipart upload to complete.

Returns:

The ID of the multipart upload to complete.

setUploadId

public void setUploadId(String uploadId)

Sets the ID of the multipart upload to complete.

Parameters:

uploadId - The ID of the multipart upload to complete.

withUploadId

public CompleteMultipartUploadRequest withUploadId(String uploadId)

Sets the ID of the multipart upload to complete, and returns this updated CompleteMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

uploadId - The ID of the multipart upload to complete.

Returns:

This updated CompleteMultipartUploadRequest object.

getPartETags

public List<PartETag> getPartETags()

Returns the list of part numbers and ETags that identify the individual parts of the multipart upload to complete.

Returns:

The list of part numbers and ETags that identify the individual parts of the multipart upload to complete.

setPartETags

public void setPartETags(List<PartETag> partETags)

Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete.

Parameters:

partETags - The list of part numbers and ETags that identify the individual parts of the multipart upload to complete.

withPartETags

public CompleteMultipartUploadRequest withPartETags(List<PartETag> partETags)

Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete, and returns this updated CompleteMultipartUploadRequest object so that additional method calls can be chained.

Parameters:

partETags - The list of part numbers and ETags that identify the individual parts of the multipart upload to complete.

Returns:

This updated CompleteMultipartUploadRequest object.

withPartETags

public CompleteMultipartUploadRequest withPartETags(UploadPartResult... uploadPartResults)

Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete based on the specified results from part uploads.

Parameters:

uploadPartResults - The list of results from the individual part uploads in the multipart upload to complete.

Returns:

This updated CompleteMultipartUploadRequest object.

withPartETags

public CompleteMultipartUploadRequest withPartETags(Collection<UploadPartResult> uploadPartResultsCollection)

Sets the list of part numbers and ETags that identify the individual parts of the multipart upload to complete based on the specified results from part uploads.

Parameters:

uploadPartResultsCollection - The list of results from the individual part uploads in the multipart upload to complete.

Returns:

This updated CompleteMultipartUploadRequest object.

isRequesterPays

public boolean isRequesterPays()

Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.

If a bucket is enabled for Requester Pays, then any attempt to upload or download an object from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.

Enabling Requester Pays disables the ability to have anonymous access to this bucket

Returns:

true if the user has enabled Requester Pays option for conducting this operation from Requester Pays Bucket.

setRequesterPays

public void setRequesterPays(boolean isRequesterPays)

Used for conducting this operation from a Requester Pays Bucket. If set the requester is charged for requests from the bucket.

If a bucket is enabled for Requester Pays, then any attempt to upload or download an object from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.

Enabling Requester Pays disables the ability to have anonymous access to this bucket.

Parameters:

isRequesterPays - Enable Requester Pays option for the operation.

withRequesterPays

public CompleteMultipartUploadRequest withRequesterPays(boolean isRequesterPays)

Used for conducting this operation from a Requester Pays Bucket. If set the requester is charged for requests from the bucket. It returns this updated CompleteMultipartUploadRequest object so that additional method calls can be chained together.

If a bucket is enabled for Requester Pays, then any attempt to upload or download an object from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.

Enabling Requester Pays disables the ability to have anonymous access to this bucket.

Parameters:

isRequesterPays - Enable Requester Pays option for the operation.

Returns:

The updated CompleteMultipartUploadRequest object.

getSSECustomerKey

public SSECustomerKey getSSECustomerKey()

Description copied from interface: SSECustomerKeyProvider

Returns the optional customer-provided server-side encryption key to use to encrypt the uploaded object.

Specified by:

getSSECustomerKey in interface SSECustomerKeyProvider

Returns:

The optional customer-provided server-side encryption key to use to encrypt the uploaded object.

setSSECustomerKey

public void setSSECustomerKey(SSECustomerKey sseKey)

Sets the optional customer-provided server-side encryption key to use to encrypt the uploaded object.

Parameters:

sseKey - The optional customer-provided server-side encryption key to use to encrypt the uploaded object.

withSSECustomerKey

public CompleteMultipartUploadRequest withSSECustomerKey(SSECustomerKey sseKey)

Sets the optional customer-provided server-side encryption key to use to encrypt the uploaded object, and returns the updated request object so that additional method calls can be chained together.

Parameters:

sseKey - The optional customer-provided server-side encryption key to use to encrypt the uploaded object.

Returns:

This updated request object so that additional method calls can be chained together.

getIfNoneMatch

public String getIfNoneMatch()

Returns the value for the header If-None-Match.

setIfNoneMatch

public void setIfNoneMatch(String eTag)

Uploads the object only if the object key name does not already exist in the bucket specified. Otherwise, S3 returns a 412 Precondition Failed error.

If a conflicting operation occurs during the upload S3 returns a 409 ConditionalRequestConflict response. On a 409 failure you should re-initiate the multipart upload with CreateMultipartUpload and re-upload each part.

Expects the '*' (asterisk) character.

For more information about conditional requests, see RFC 7232, or Conditional requests in the Amazon S3 User Guide.

Parameters:

eTag -

ifNoneMatch

public CompleteMultipartUploadRequest ifNoneMatch(String eTag)

Uploads the object only if the object key name does not already exist in the bucket specified. Otherwise, S3 returns a 412 Precondition Failed error.

If a conflicting operation occurs during the upload S3 returns a 409 ConditionalRequestConflict response. On a 409 failure you should re-initiate the multipart upload with CreateMultipartUpload and re-upload each part.

Expects the '*' (asterisk) character.

For more information about conditional requests, see RFC 7232, or Conditional requests in the Amazon S3 User Guide.

Parameters:

eTag -