com.amazonaws.services.s3.model

Class AbstractPutObjectRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.AbstractPutObjectRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, S3DataSource, SSEAwsKeyManagementParamsProvider, SSECustomerKeyProvider, Serializable, Cloneable

Direct Known Subclasses:

PutObjectRequest, UploadObjectRequest

public abstract class AbstractPutObjectRequest
extends AmazonWebServiceRequest
implements Cloneable, SSECustomerKeyProvider, SSEAwsKeyManagementParamsProvider, S3DataSource, Serializable

Abstract base class for a put object or put object like request.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.amazonaws.services.s3.model.S3DataSource

S3DataSource.Utils

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
AbstractPutObjectRequest(String bucketName, String key, File file) Constructs a new AbstractPutObjectRequest object to upload a file to the specified bucket and key.
AbstractPutObjectRequest(String bucketName, String key, String redirectLocation) Constructs a new AbstractPutObjectRequest object with redirect location.

Method Summary

Modifier and Type	Method and Description
AbstractPutObjectRequest	clone() Creates a shallow clone of this object for all fields except the handler context.
AccessControlList	getAccessControlList() Returns the optional access control list for the new object.
Boolean	getBucketKeyEnabled() Returns whether or not bucket key encryption is used
String	getBucketName() The bucket name to which the PUT action was initiated.
CannedAccessControlList	getCannedAcl() Gets the optional pre-configured access control policy to use for the new object.
File	getFile() Gets the path and name of the file containing the data to be uploaded to Amazon S3.
String	getIfNoneMatch() Returns the value for the header If-None-Match.
InputStream	getInputStream() Gets the input stream containing the data to be uploaded to Amazon S3.
String	getKey() Gets the key under which to store the new object.
ObjectMetadata	getMetadata() Gets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g.
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.
ProgressListener	getProgressListener() Deprecated. use AmazonWebServiceRequest.getGeneralProgressListener() instead.
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.
String	getStorageClass() Gets the optional Amazon S3 storage class to use when storing the new object.
ObjectTagging	getTagging()
<T extends AbstractPutObjectRequest> T	ifNoneMatch(String eTag) Uploads the object only if the object key name does not already exist in the bucket specified.
void	setAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new object.
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) The bucket name to which the PUT action was initiated.
void	setCannedAcl(CannedAccessControlList cannedAcl) Sets the optional pre-configured access control policy to use for the new object.
void	setFile(File file) Sets the path and name of the file containing the data to be uploaded to Amazon S3.
void	setIfNoneMatch(String eTag) Uploads the object only if the object key name does not already exist in the bucket specified.
void	setInputStream(InputStream inputStream) Sets the input stream containing the data to be uploaded to Amazon S3.
void	setKey(String key) Sets the key under which to store the new object.
void	setMetadata(ObjectMetadata metadata) Sets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g.
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	setProgressListener(ProgressListener progressListener) Deprecated. use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.
void	setRedirectLocation(String redirectLocation) Sets the optional redirect location for the new object.
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 uploaded object.
void	setStorageClass(StorageClass storageClass) Sets the optional Amazon S3 storage class to use when storing the new object.
void	setStorageClass(String storageClass) Sets the optional Amazon S3 storage class to use when storing the new object.
void	setTagging(ObjectTagging tagging)
<T extends AbstractPutObjectRequest> T	withAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new object.
<T extends AbstractPutObjectRequest> T	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).
<T extends AbstractPutObjectRequest> T	withBucketName(String bucketName) The bucket name to which the PUT action was initiated.
<T extends AbstractPutObjectRequest> T	withCannedAcl(CannedAccessControlList cannedAcl) Sets the optional pre-configured access control policy to use for the new object.
<T extends AbstractPutObjectRequest> T	withFile(File file) Sets the file containing the data to be uploaded to Amazon S3.
<T extends AbstractPutObjectRequest> T	withInputStream(InputStream inputStream) Sets the input stream containing the data to be uploaded to Amazon S3.
<T extends AbstractPutObjectRequest> T	withKey(String key) Sets the key under which to store the new object.
<T extends AbstractPutObjectRequest> T	withMetadata(ObjectMetadata metadata) Sets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g.
<T extends PutObjectRequest> T	withObjectLockLegalHoldStatus(ObjectLockLegalHoldStatus objectLockLegalHoldStatus) The Legal Hold status that you want to apply to the specified object.
<T extends PutObjectRequest> T	withObjectLockLegalHoldStatus(String objectLockLegalHoldStatus) The Legal Hold status that you want to apply to the specified object.
<T extends PutObjectRequest> T	withObjectLockMode(ObjectLockMode objectLockMode) The Object Lock mode that you want to apply to this object.
<T extends PutObjectRequest> T	withObjectLockMode(String objectLockMode) The Object Lock mode that you want to apply to this object.
<T extends PutObjectRequest> T	withObjectLockRetainUntilDate(Date objectLockRetainUntilDate) The date and time when you want this object's Object Lock to expire.
<T extends AbstractPutObjectRequest> T	withProgressListener(ProgressListener progressListener) Deprecated. use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.
<T extends AbstractPutObjectRequest> T	withRedirectLocation(String redirectLocation) Sets the optional redirect location for the new object.Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.
<T extends AbstractPutObjectRequest> T	withSSEAwsKeyManagementParams(SSEAwsKeyManagementParams sseAwsKeyManagementParams) Sets the Amazon Web Services Key Management System parameters used to encrypt the object on server side.
<T extends AbstractPutObjectRequest> T	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.
<T extends AbstractPutObjectRequest> T	withStorageClass(StorageClass storageClass) Sets the optional Amazon S3 storage class to use when storing the new object.
<T extends AbstractPutObjectRequest> T	withStorageClass(String storageClass) Sets the optional Amazon S3 storage class to use when storing the new object.
<T extends PutObjectRequest> T	withTagging(ObjectTagging tagSet)

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

addHandlerContext, 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

AbstractPutObjectRequest

public AbstractPutObjectRequest(String bucketName,
                                String key,
                                File file)

Constructs a new AbstractPutObjectRequest object to upload a file to the specified bucket and key. After constructing the request, users may optionally specify object metadata or a canned ACL as well.

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 an existing bucket to which the new object will be uploaded.

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 under which to store the new object.

file - The path of the file to upload to Amazon S3.

AbstractPutObjectRequest

public AbstractPutObjectRequest(String bucketName,
                                String key,
                                String redirectLocation)

Constructs a new AbstractPutObjectRequest object with redirect location. After constructing the request, users may optionally specify object metadata or a canned ACL as well.

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 an existing bucket to which the new object will be uploaded.

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 under which to store the new object.

redirectLocation - The redirect location of this new object.

Method Detail

getBucketName

public String getBucketName()

The bucket name to which the PUT action was initiated.

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 bucket name to which the PUT action was initiated.

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.

See Also:

setBucketName(String), withBucketName(String)

setBucketName

public void setBucketName(String bucketName)

The bucket name to which the PUT action was initiated.

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 bucket name to which the PUT action was initiated.

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.

See Also:

getBucketName(), withBucketName(String)

withBucketName

public <T extends AbstractPutObjectRequest> T withBucketName(String bucketName)

The bucket name to which the PUT action was initiated.

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 bucket name to which the PUT action was initiated.

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:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

See Also:

getBucketName(), setBucketName(String)

getKey

public String getKey()

Gets the key under which to store the new object.

Returns:

The key under which to store the new object.

See Also:

setKey(String), withKey(String)

setKey

public void setKey(String key)

Sets the key under which to store the new object.

Parameters:

key - The key under which to store the new object.

See Also:

getKey(), withKey(String)

withKey

public <T extends AbstractPutObjectRequest> T withKey(String key)

Sets the key under which to store the new object. Returns this object, enabling additional method calls to be chained together.

Parameters:

key - The key under which to store the new object.

Returns:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

See Also:

getKey(), setKey(String)

getStorageClass

public String getStorageClass()

Gets the optional Amazon S3 storage class to use when storing the new object. If not specified, the default standard storage class is used when storing the object.

For more information on available Amazon S3 storage classes, see the StorageClass enumeration.

Returns:

The Amazon S3 storage class to use when storing the newly copied object.

See Also:

setStorageClass(String), setStorageClass(StorageClass), withStorageClass(StorageClass), withStorageClass(String)

setStorageClass

public void setStorageClass(String storageClass)

Sets the optional Amazon S3 storage class to use when storing the new object. If not specified, the default standard storage class will be used when storing the new object.

For more information on Amazon S3 storage classes and available values, see the StorageClass enumeration.

Parameters:

storageClass - The storage class to use when storing the new object.

See Also:

getStorageClass(), setStorageClass(String), withStorageClass(StorageClass), withStorageClass(String)

withStorageClass

public <T extends AbstractPutObjectRequest> T withStorageClass(String storageClass)

Sets the optional Amazon S3 storage class to use when storing the new object. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together. If not specified, the default standard storage class will be used when storing the object.

For more information on Amazon S3 storage classes and available values, see the StorageClass enumeration.

Parameters:

storageClass - The storage class to use when storing the new object.

Returns:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

See Also:

getStorageClass(), setStorageClass(StorageClass), setStorageClass(String), withStorageClass(StorageClass)

setStorageClass

public void setStorageClass(StorageClass storageClass)

Sets the optional Amazon S3 storage class to use when storing the new object. If not specified, the default standard storage class will be used when storing the object.

For more information on Amazon S3 storage classes and available values, see the StorageClass enumeration.

Parameters:

storageClass - The storage class to use when storing the new object.

See Also:

getStorageClass(), setStorageClass(String)

withStorageClass

public <T extends AbstractPutObjectRequest> T withStorageClass(StorageClass storageClass)

Sets the optional Amazon S3 storage class to use when storing the new object. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together. If not specified, the default standard storage class will be used when storing the object.

For more information on Amazon S3 storage classes and available values, see the StorageClass enumeration.

Parameters:

storageClass - The storage class to use when storing the new object.

Returns:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

See Also:

getStorageClass(), setStorageClass(StorageClass), setStorageClass(String), withStorageClass(String)

getFile

public File getFile()

Gets the path and name of the file containing the data to be uploaded to Amazon S3. Either specify a file or an input stream containing the data to be uploaded to Amazon S3; both cannot be specified.

Specified by:

getFile in interface S3DataSource

Returns:

The path and name of the file containing the data to be uploaded to Amazon S3.

See Also:

setFile(File), withFile(File), setInputStream(InputStream), withInputStream(InputStream)

setFile

public void setFile(File file)

Sets the path and name of the file containing the data to be uploaded to Amazon S3. Either specify a file or an input stream containing the data to be uploaded to Amazon S3; both cannot be specified.

Specified by:

setFile in interface S3DataSource

Parameters:

file - The path and name of the file containing the data to be uploaded to Amazon S3.

See Also:

getFile(), withFile(File), getInputStream(), withInputStream(InputStream)

withFile

public <T extends AbstractPutObjectRequest> T withFile(File file)

Sets the file containing the data to be uploaded to Amazon S3. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

Either specify a file or an input stream containing the data to be uploaded to Amazon S3; both cannot be specified.

Parameters:

file - The file containing the data to be uploaded to Amazon S3.

Returns:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

See Also:

getFile(), setFile(File), getInputStream(), setInputStream(InputStream)

getMetadata

public ObjectMetadata getMetadata()

Gets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

If uploading from an input stream, always specify metadata with the content size set. Otherwise the contents of the input stream have to be buffered in memory before being sent to Amazon S3. This can cause very negative performance impacts.

Returns:

The optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

See Also:

setMetadata(ObjectMetadata), withMetadata(ObjectMetadata)

setMetadata

public void setMetadata(ObjectMetadata metadata)

Sets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

If uploading from an input stream, always specify metadata with the content size set. Otherwise the contents of the input stream have to be buffered in memory before being sent to Amazon S3. This can cause very negative performance impacts.

Parameters:

metadata - The optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

See Also:

getMetadata(), withMetadata(ObjectMetadata)

withMetadata

public <T extends AbstractPutObjectRequest> T withMetadata(ObjectMetadata metadata)

Sets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.). Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

If uploading from an input stream, always specify metadata with the content size set. Otherwise the contents of the input stream have to be buffered in memory before being sent to Amazon S3. This can cause very negative performance impacts.

Parameters:

metadata - The optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

Returns:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

See Also:

getMetadata(), setMetadata(ObjectMetadata)

getCannedAcl

public CannedAccessControlList getCannedAcl()

Gets the optional pre-configured access control policy to use for the new object.

Returns:

The optional pre-configured access control policy to use for the new object.

See Also:

setCannedAcl(CannedAccessControlList), withCannedAcl(CannedAccessControlList)

setCannedAcl

public void setCannedAcl(CannedAccessControlList cannedAcl)

Sets the optional pre-configured access control policy to use for the new object.

Parameters:

cannedAcl - The optional pre-configured access control policy to use for the new object.

See Also:

getCannedAcl(), withCannedAcl(CannedAccessControlList)

withCannedAcl

public <T extends AbstractPutObjectRequest> T withCannedAcl(CannedAccessControlList cannedAcl)

Sets the optional pre-configured access control policy to use for the new object. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

Parameters:

cannedAcl - The optional pre-configured access control policy to use for the new object.

Returns:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

See Also:

getCannedAcl(), setCannedAcl(CannedAccessControlList)

getAccessControlList

public AccessControlList getAccessControlList()

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

setAccessControlList

public void setAccessControlList(AccessControlList accessControlList)

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

Parameters:

accessControlList - The access control list for the new object.

withAccessControlList

public <T extends AbstractPutObjectRequest> T withAccessControlList(AccessControlList accessControlList)

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

Parameters:

accessControlList - The access control list for the new object.

getInputStream

public InputStream getInputStream()

Gets the input stream containing the data to be uploaded to Amazon S3. The user of this request must either specify a file or an input stream containing the data to be uploaded to Amazon S3; both cannot be specified.

Specified by:

getInputStream in interface S3DataSource

Returns:

The input stream containing the data to be uploaded to Amazon S3. Either specify a file or an input stream containing the data to be uploaded to Amazon S3, not both.

See Also:

setInputStream(InputStream), withInputStream(InputStream), setFile(File), withFile(File)

setInputStream

public void setInputStream(InputStream inputStream)

Sets the input stream containing the data to be uploaded to Amazon S3. Either specify a file or an input stream containing the data to be uploaded to Amazon S3; both cannot be specified.

Specified by:

setInputStream in interface S3DataSource

Parameters:

inputStream - The input stream containing the data to be uploaded to Amazon S3. Either specify a file or an input stream containing the data to be uploaded to Amazon S3, not both.

See Also:

getInputStream(), withInputStream(InputStream), getFile(), withFile(File)

withInputStream

public <T extends AbstractPutObjectRequest> T withInputStream(InputStream inputStream)

Sets the input stream containing the data to be uploaded to Amazon S3. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

Either specify a file or an input stream containing the data to be uploaded to Amazon S3; both cannot be specified.

Parameters:

inputStream - The InputStream containing the data to be uploaded to Amazon S3.

Returns:

This PutObjectRequest, so that additional method calls can be chained together.

See Also:

getInputStream(), setInputStream(InputStream), getFile(), setFile(File)

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 <T extends AbstractPutObjectRequest> T withRedirectLocation(String redirectLocation)

Sets the optional redirect location for the new object.Returns this AbstractPutObjectRequest, 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 uploaded object.

Parameters:

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

withSSECustomerKey

public <T extends AbstractPutObjectRequest> T 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.

getTagging

public ObjectTagging getTagging()

setTagging

public void setTagging(ObjectTagging tagging)

withTagging

public <T extends PutObjectRequest> T withTagging(ObjectTagging tagSet)

getObjectLockMode

public String getObjectLockMode()

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

withObjectLockMode

public <T extends PutObjectRequest> T withObjectLockMode(String objectLockMode)

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

withObjectLockMode

public <T extends PutObjectRequest> T 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 <T extends PutObjectRequest> T 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 <T extends PutObjectRequest> T withObjectLockLegalHoldStatus(String objectLockLegalHoldStatus)

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

withObjectLockLegalHoldStatus

public <T extends PutObjectRequest> T 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.

setProgressListener

@Deprecated
public void setProgressListener(ProgressListener progressListener)

Deprecated. use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.

Sets the optional progress listener for receiving updates for object upload status.

Parameters:

progressListener - The legacy progress listener that is used exclusively for Amazon S3 client.

getProgressListener

@Deprecated
public ProgressListener getProgressListener()

Deprecated. use AmazonWebServiceRequest.getGeneralProgressListener() instead.

Returns the optional progress listener for receiving updates about object upload status.

Returns:

the optional progress listener for receiving updates about object upload status.

withProgressListener

@Deprecated
public <T extends AbstractPutObjectRequest> T withProgressListener(ProgressListener progressListener)

Deprecated. use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.

Sets the optional progress listener for receiving updates about object upload status, and returns this updated object so that additional method calls can be chained together.

Parameters:

progressListener - The legacy progress listener that is used exclusively for Amazon S3 client.

Returns:

This updated PutObjectRequest object.

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 <T extends AbstractPutObjectRequest> T withSSEAwsKeyManagementParams(SSEAwsKeyManagementParams sseAwsKeyManagementParams)

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

Returns:

returns the updated PutObjectRequest

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 a PUT operation doesn't affect bucket-level settings for S3 Bucket Key.

withBucketKeyEnabled

public <T extends AbstractPutObjectRequest> T 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 a PUT operation doesn't affect bucket-level settings for S3 Bucket Key.

Returns:

returns the updated PutObjectRequest

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 <T extends AbstractPutObjectRequest> T 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 -

clone

public AbstractPutObjectRequest clone()

Description copied from class: AmazonWebServiceRequest

Creates a shallow clone of this object for all fields except the handler context. Explicitly does not clone the deep structure of the other fields in the message.

Overrides:

clone in class AmazonWebServiceRequest

See Also:

Object.clone()