com.amazonaws.services.s3.model

Class InitiateMultipartUploadRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.InitiateMultipartUploadRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, ExpectedBucketOwnerRequest, SSEAwsKeyManagementParamsProvider, SSECustomerKeyProvider, Serializable, Cloneable

Direct Known Subclasses:

EncryptedInitiateMultipartUploadRequest

public class InitiateMultipartUploadRequest
extends AmazonWebServiceRequest
implements SSECustomerKeyProvider, SSEAwsKeyManagementParamsProvider, Serializable, ExpectedBucketOwnerRequest

The InitiateMultipartUploadRequest contains the parameters used for the InitiateMultipartUpload method.

If you are initiating 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

See Also:

AmazonS3.initiateMultipartUpload(InitiateMultipartUploadRequest), Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
ObjectMetadata	objectMetadata Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
InitiateMultipartUploadRequest(String bucketName, String key) Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key.
InitiateMultipartUploadRequest(String bucketName, String key, ObjectMetadata objectMetadata) Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key, and with the additional specified object metadata.

Method Summary

Modifier and Type	Method and Description
AccessControlList	getAccessControlList() Returns the optional access control list for the new upload.
Boolean	getBucketKeyEnabled() Returns whether or not bucket key encryption is used
String	getBucketName() The name of the bucket to which to initiate the upload
CannedAccessControlList	getCannedACL() Returns the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.
String	getExpectedBucketOwner() Returns he account id of the expected bucket owner.
String	getKey() Returns the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.
String	getObjectLockLegalHoldStatus() The Legal Hold status that you want to apply to the specified object.
String	getObjectLockMode() The Object Lock mode that you want to apply to this object.
Date	getObjectLockRetainUntilDate() The date and time when you want this object's Object Lock to expire.
ObjectMetadata	getObjectMetadata() Returns the additional information about the new object being created, such as content type, content encoding, user metadata, etc.
String	getRedirectLocation() Gets the optional redirect location for the new object.
SSEAwsKeyManagementParams	getSSEAwsKeyManagementParams() Returns the Amazon Web Services Key Management System parameters used to encrypt the object on server side.
SSECustomerKey	getSSECustomerKey() Returns the optional customer-provided server-side encryption key to use to encrypt the uploaded object.
StorageClass	getStorageClass() Returns the optional storage class to use when storing this upload's data in S3.
ObjectTagging	getTagging()
boolean	isRequesterPays() Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.
void	setAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new upload.
void	setBucketKeyEnabled(Boolean bucketKeyEnabled) Specifies whether the client should use an S3 Bucket Key for object encryption with server-side encryption using Amazon Web Services KMS (SSE-KMS).
void	setBucketName(String bucketName) Sets the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.
void	setCannedACL(CannedAccessControlList cannedACL) Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.
void	setExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
void	setKey(String key) Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.
void	setObjectLockLegalHoldStatus(ObjectLockLegalHoldStatus objectLockLegalHoldStatus) The Legal Hold status that you want to apply to the specified object.
void	setObjectLockLegalHoldStatus(String objectLockLegalHoldStatus) The Legal Hold status that you want to apply to the specified object.
void	setObjectLockMode(ObjectLockMode objectLockMode) The Object Lock mode that you want to apply to this object.
void	setObjectLockMode(String objectLockMode) The Object Lock mode that you want to apply to this object.
void	setObjectLockRetainUntilDate(Date objectLockRetainUntilDate) The date and time when you want this object's Object Lock to expire.
void	setObjectMetadata(ObjectMetadata objectMetadata) Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.
void	setRedirectLocation(String redirectLocation) Sets the optional redirect location for the new object.
void	setRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
void	setSSEAwsKeyManagementParams(SSEAwsKeyManagementParams params) Sets the Amazon Web Services Key Management System parameters used to encrypt the object on server side.
void	setSSECustomerKey(SSECustomerKey sseKey) Sets the optional customer-provided server-side encryption key to use to encrypt the upload being started.
void	setStorageClass(StorageClass storageClass) Sets the optional storage class to use when storing this upload's data in S3.
void	setTagging(ObjectTagging tagging) Set the tags for this object.
InitiateMultipartUploadRequest	withAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new upload.
InitiateMultipartUploadRequest	withBucketKeyEnabled(Boolean bucketKeyEnabled) Specifies whether the client should use an S3 Bucket Key for object encryption with server-side encryption using Amazon Web Services KMS (SSE-KMS).
InitiateMultipartUploadRequest	withBucketName(String bucketName) The name of the bucket to which to initiate the upload
InitiateMultipartUploadRequest	withCannedACL(CannedAccessControlList acl) Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.
InitiateMultipartUploadRequest	withExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
InitiateMultipartUploadRequest	withKey(String key) Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.
InitiateMultipartUploadRequest	withObjectLockLegalHoldStatus(ObjectLockLegalHoldStatus objectLockLegalHoldStatus) The Legal Hold status that you want to apply to the specified object.
InitiateMultipartUploadRequest	withObjectLockLegalHoldStatus(String objectLockLegalHoldStatus) The Legal Hold status that you want to apply to the specified object.
InitiateMultipartUploadRequest	withObjectLockMode(ObjectLockMode objectLockMode) The Object Lock mode that you want to apply to this object.
InitiateMultipartUploadRequest	withObjectLockMode(String objectLockMode) The Object Lock mode that you want to apply to this object.
InitiateMultipartUploadRequest	withObjectLockRetainUntilDate(Date objectLockRetainUntilDate) The date and time when you want this object's Object Lock to expire.
InitiateMultipartUploadRequest	withObjectMetadata(ObjectMetadata objectMetadata) Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.
InitiateMultipartUploadRequest	withRedirectLocation(String redirectLocation) Sets the optional redirect location for the new object.
InitiateMultipartUploadRequest	withRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
InitiateMultipartUploadRequest	withSSEAwsKeyManagementParams(SSEAwsKeyManagementParams sseAwsKeyManagementParams) Sets the Amazon Web Services Key Management System parameters used to encrypt the object on server side.
InitiateMultipartUploadRequest	withSSECustomerKey(SSECustomerKey sseKey) Sets the optional customer-provided server-side encryption key to use to encrypt the upload being started, and returns the updated InitiateMultipartUploadRequest so that additional method calls may be chained together.
InitiateMultipartUploadRequest	withStorageClass(StorageClass storageClass) Sets the optional storage class to use when storing this upload's data in S3.
InitiateMultipartUploadRequest	withStorageClass(String storageClass)
InitiateMultipartUploadRequest	withTagging(ObjectTagging tagging) Set the tags for this object.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

addHandlerContext, clone, copyBaseTo, 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, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

objectMetadata

public ObjectMetadata objectMetadata

Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Constructor Detail

InitiateMultipartUploadRequest

public InitiateMultipartUploadRequest(String bucketName,
                                      String key)

Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key.

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 using 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, or access point ARN, in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

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 using 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.

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

InitiateMultipartUploadRequest

public InitiateMultipartUploadRequest(String bucketName,
                                      String key,
                                      ObjectMetadata objectMetadata)

Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key, and with the additional specified object metadata.

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 using 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, or access point ARN, in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

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 using 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.

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

objectMetadata - Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

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 InitiateMultipartUploadRequest 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()

The name of the bucket to which to initiate the upload

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 using 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 to which to initiate the upload

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 using 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.

setBucketName

public void setBucketName(String bucketName)

Sets the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

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 using 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, or access point ARN, in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

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 using 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.

withBucketName

public InitiateMultipartUploadRequest withBucketName(String bucketName)

The name of the bucket to which to initiate the upload

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 using 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 to which to initiate the upload

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 using 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:

Returns a reference to this object so that method calls can be chained together.

getKey

public String getKey()

Returns the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns:

The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

setKey

public void setKey(String key)

Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Parameters:

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

withKey

public InitiateMultipartUploadRequest withKey(String key)

Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns:

This updated InitiateMultipartUploadRequest object.

getCannedACL

public CannedAccessControlList getCannedACL()

Returns the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Returns:

The optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

See Also:

CannedAccessControlList

setCannedACL

public void setCannedACL(CannedAccessControlList cannedACL)

Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Parameters:

cannedACL - The canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

See Also:

CannedAccessControlList

withCannedACL

public InitiateMultipartUploadRequest withCannedACL(CannedAccessControlList acl)

Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

acl - The optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Returns:

This updated InitiateMultipartUploadRequest object.

getAccessControlList

public AccessControlList getAccessControlList()

Returns the optional access control list for the new upload. If specified, cannedAcl will be ignored.

setAccessControlList

public void setAccessControlList(AccessControlList accessControlList)

Sets the optional access control list for the new upload. If specified, cannedAcl will be ignored.

Parameters:

accessControlList - The access control list for the new upload.

withAccessControlList

public InitiateMultipartUploadRequest withAccessControlList(AccessControlList accessControlList)

Sets the optional access control list for the new upload. If specified, cannedAcl will be ignored. Returns this InitiateMultipartUploadRequest, enabling additional method calls to be chained together.

Parameters:

accessControlList - The access control list for the new upload.

getStorageClass

public StorageClass getStorageClass()

Returns the optional storage class to use when storing this upload's data in S3. If not specified, the default storage class is used.

If not specified, the default is StorageClass.Standard.

Returns:

The optional storage class to use when storing this upload's data in S3. If not specified, the default storage class is used.

See Also:

StorageClass

setStorageClass

public void setStorageClass(StorageClass storageClass)

Sets the optional storage class to use when storing this upload's data in S3. If not specified, the default storage class is used.

If not specified, the default is StorageClass.Standard.

Parameters:

storageClass - The optional storage class to use when storing this upload's data in S3. If not specified, the default storage class is used.

See Also:

StorageClass

withStorageClass

public InitiateMultipartUploadRequest withStorageClass(StorageClass storageClass)

Sets the optional storage class to use when storing this upload's data in S3. If not specified, the default storage class is used.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

storageClass - The optional storage class to use when storing this upload's data in S3. If not specified, the default storage class is used.

Returns:

This updated InitiateMultipartUploadRequest object.

withStorageClass

public InitiateMultipartUploadRequest withStorageClass(String storageClass)

getObjectMetadata

public ObjectMetadata getObjectMetadata()

Returns the additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Returns:

The additional information about the new object being created, such as content type, content encoding, user metadata, etc.

setObjectMetadata

public void setObjectMetadata(ObjectMetadata objectMetadata)

Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Parameters:

objectMetadata - Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

withObjectMetadata

public InitiateMultipartUploadRequest withObjectMetadata(ObjectMetadata objectMetadata)

Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

objectMetadata - Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Returns:

This updated InitiateMultipartUploadRequest object.

setRedirectLocation

public void setRedirectLocation(String redirectLocation)

Sets the optional redirect location for the new object.

Parameters:

redirectLocation - The redirect location for the new object.

getRedirectLocation

public String getRedirectLocation()

Gets the optional redirect location for the new object.

withRedirectLocation

public InitiateMultipartUploadRequest withRedirectLocation(String redirectLocation)

Sets the optional redirect location for the new object. Returns this InitiateMultipartUploadRequest, enabling additional method calls to be chained together.

Parameters:

redirectLocation - The redirect location for the new 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 upload being started.

Parameters:

sseKey - The optional customer-provided server-side encryption key to use to encrypt the upload being started.

withSSECustomerKey

public InitiateMultipartUploadRequest withSSECustomerKey(SSECustomerKey sseKey)

Sets the optional customer-provided server-side encryption key to use to encrypt the upload being started, and returns the updated InitiateMultipartUploadRequest so that additional method calls may be chained together.

Parameters:

sseKey - The optional customer-provided server-side encryption key to use to encrypt the upload being started.

Returns:

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

getSSEAwsKeyManagementParams

public SSEAwsKeyManagementParams getSSEAwsKeyManagementParams()

Returns the Amazon Web Services Key Management System parameters used to encrypt the object on server side.

Specified by:

getSSEAwsKeyManagementParams in interface SSEAwsKeyManagementParamsProvider

Returns:

The optional SSEAwsKeyManagementParams to use to encrypt the uploaded object.

setSSEAwsKeyManagementParams

public void setSSEAwsKeyManagementParams(SSEAwsKeyManagementParams params)

Sets the Amazon Web Services Key Management System parameters used to encrypt the object on server side.

withSSEAwsKeyManagementParams

public InitiateMultipartUploadRequest withSSEAwsKeyManagementParams(SSEAwsKeyManagementParams sseAwsKeyManagementParams)

Sets the Amazon Web Services Key Management System parameters used to encrypt the object on server side.

Returns:

returns the update InitiateMultipartUploadRequest

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 InitiateMultipartUploadRequest 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 InitiateMultipartUploadRequest 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 InitiateMultipartUploadRequest object.

getTagging

public ObjectTagging getTagging()

Returns:

The tags for this object.

setTagging

public void setTagging(ObjectTagging tagging)

Set the tags for this object.

Parameters:

tagging - The tags for this object.

withTagging

public InitiateMultipartUploadRequest withTagging(ObjectTagging tagging)

Set the tags for this object.

Parameters:

tagging - The tags for this object.

Returns:

The updated InitiateMultipartUploadRequest object.

getObjectLockMode

public String getObjectLockMode()

The Object Lock mode that you want to apply to this object.

withObjectLockMode

public InitiateMultipartUploadRequest withObjectLockMode(String objectLockMode)

The Object Lock mode that you want to apply to this object.

withObjectLockMode

public InitiateMultipartUploadRequest withObjectLockMode(ObjectLockMode objectLockMode)

The Object Lock mode that you want to apply to this object.

setObjectLockMode

public void setObjectLockMode(String objectLockMode)

The Object Lock mode that you want to apply to this object.

setObjectLockMode

public void setObjectLockMode(ObjectLockMode objectLockMode)

The Object Lock mode that you want to apply to this object.

getObjectLockRetainUntilDate

public Date getObjectLockRetainUntilDate()

The date and time when you want this object's Object Lock to expire.

withObjectLockRetainUntilDate

public InitiateMultipartUploadRequest withObjectLockRetainUntilDate(Date objectLockRetainUntilDate)

The date and time when you want this object's Object Lock to expire.

setObjectLockRetainUntilDate

public void setObjectLockRetainUntilDate(Date objectLockRetainUntilDate)

The date and time when you want this object's Object Lock to expire.

getObjectLockLegalHoldStatus

public String getObjectLockLegalHoldStatus()

The Legal Hold status that you want to apply to the specified object.

withObjectLockLegalHoldStatus

public InitiateMultipartUploadRequest withObjectLockLegalHoldStatus(String objectLockLegalHoldStatus)

The Legal Hold status that you want to apply to the specified object.

withObjectLockLegalHoldStatus

public InitiateMultipartUploadRequest withObjectLockLegalHoldStatus(ObjectLockLegalHoldStatus objectLockLegalHoldStatus)

The Legal Hold status that you want to apply to the specified object.

setObjectLockLegalHoldStatus

public void setObjectLockLegalHoldStatus(String objectLockLegalHoldStatus)

The Legal Hold status that you want to apply to the specified object.

setObjectLockLegalHoldStatus

public void setObjectLockLegalHoldStatus(ObjectLockLegalHoldStatus objectLockLegalHoldStatus)

The Legal Hold status that you want to apply to the specified object.

getBucketKeyEnabled

public Boolean getBucketKeyEnabled()

Returns whether or not bucket key encryption is used

setBucketKeyEnabled

public void setBucketKeyEnabled(Boolean bucketKeyEnabled)

Specifies whether the client should use an S3 Bucket Key for object encryption with server-side encryption using Amazon Web Services KMS (SSE-KMS). Setting this header to true causes the client to use an S3 Bucket Key for object encryption with SSE-KMS.

Specifying this header with an object operation doesn’t affect bucket-level settings for S3 Bucket Key.

withBucketKeyEnabled

public InitiateMultipartUploadRequest withBucketKeyEnabled(Boolean bucketKeyEnabled)

Specifies whether the client should use an S3 Bucket Key for object encryption with server-side encryption using Amazon Web Services KMS (SSE-KMS). Setting this header to true causes the client to use an S3 Bucket Key for object encryption with SSE-KMS.

Specifying this header with an object operation doesn’t affect bucket-level settings for S3 Bucket Key.

Returns:

returns the update PutObjectRequest