com.amazonaws.services.s3.model

Class DeleteObjectsRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.DeleteObjectsRequest

All Implemented Interfaces:

Cloneable

public class DeleteObjectsRequest
extends com.amazonaws.AmazonWebServiceRequest

Provides options for deleting multiple objects in a specified bucket. Once deleted, the object(s) can only be restored if versioning was enabled when the object(s) was deleted.You may specify up to 1000 keys.

See Also:

AmazonS3.deleteObjects(DeleteObjectsRequest)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DeleteObjectsRequest.KeyVersion A key to delete, with an optional version attribute.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
DeleteObjectsRequest(String bucketName) Constructs a new DeleteObjectsRequest, specifying the objects' bucket name.

Method Summary

Methods

Modifier and Type	Method and Description
String	getBucketName() Gets the name of the Amazon S3 bucket containing the object(s) to delete.
List<DeleteObjectsRequest.KeyVersion>	getKeys() Returns the list of keys to delete from this bucket.
MultiFactorAuthentication	getMfa() Gets the optional Multi-Factor Authentication information included with this request.
boolean	getQuiet() Returns the quiet element for this request.
void	setBucketName(String bucketName) Sets the name of the Amazon S3 bucket containing the object(s) to delete.
void	setKeys(List<DeleteObjectsRequest.KeyVersion> keys) Sets the list of keys to delete from this bucket, clearing any existing list of keys.
void	setMfa(MultiFactorAuthentication mfa) Sets the optional Multi-Factor Authentication information to include with this request.
void	setQuiet(boolean quiet) Sets the quiet element for this request.
DeleteObjectsRequest	withBucketName(String bucketName) Sets the name of the Amazon S3 bucket containing the object(s) to delete and returns this object, enabling additional method calls to be chained together.
DeleteObjectsRequest	withKeys(List<DeleteObjectsRequest.KeyVersion> keys) Sets the list of keys to delete from this bucket, clearing any existing list of keys.
DeleteObjectsRequest	withKeys(String... keys) Convenience method to specify a set of keys without versions.
DeleteObjectsRequest	withMfa(MultiFactorAuthentication mfa) Sets the optional Multi-Factor Authentication information to include with this request Returns this, enabling additional method calls to be chained together.
DeleteObjectsRequest	withQuiet(boolean quiet) Sets the quiet element for this request.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

clone, copyBaseTo, copyPrivateRequestParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

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

Constructor Detail

DeleteObjectsRequest

public DeleteObjectsRequest(String bucketName)

Constructs a new DeleteObjectsRequest, specifying the objects' bucket name.

Parameters:

bucketName - The name of the Amazon S3 bucket containing the object(s) to delete.

Method Detail

getBucketName

public String getBucketName()

Gets the name of the Amazon S3 bucket containing the object(s) to delete.

Returns:

The name of the Amazon S3 bucket containing the object(s) to delete.

See Also:

setBucketName(String)

setBucketName

public void setBucketName(String bucketName)

Sets the name of the Amazon S3 bucket containing the object(s) to delete.

Parameters:

bucketName - The name of the Amazon S3 bucket containing the object(s) to delete.

See Also:

getBucketName()

withBucketName

public DeleteObjectsRequest withBucketName(String bucketName)

Sets the name of the Amazon S3 bucket containing the object(s) to delete and returns this object, enabling additional method calls to be chained together.

Parameters:

bucketName - The name of the Amazon S3 bucket containing the object(s) to delete.

Returns:

The updated DeleteObjectsRequest object, enabling additional method calls to be chained together.

getMfa

public MultiFactorAuthentication getMfa()

Gets the optional Multi-Factor Authentication information included with this request.

Multi-Factor Authentication is required when deleting an object version from a bucket which has MFADelete enabled in its bucket versioning configuration.

See BucketVersioningConfiguration.setMfaDeleteEnabled(Boolean) for more information on MFADelete.

Returns:

The optional Multi-Factor Authentication information included with this request.

setMfa

public void setMfa(MultiFactorAuthentication mfa)

Sets the optional Multi-Factor Authentication information to include with this request.

Multi-Factor Authentication is required when deleting an object version from a bucket which has MFADelete enabled in its bucket versioning configuration.

See BucketVersioningConfiguration.setMfaDeleteEnabled(Boolean) for more information on MFADelete.

Parameters:

mfa - The optional Multi-Factor Authentication information to include with this request.

withMfa

public DeleteObjectsRequest withMfa(MultiFactorAuthentication mfa)

Sets the optional Multi-Factor Authentication information to include with this request Returns this, enabling additional method calls to be chained together.

Multi-Factor Authentication is required when deleting an object version from a bucket which has MFADelete enabled in its bucket versioning configuration

See BucketVersioningConfiguration.setMfaDeleteEnabled(Boolean) for more information on MFADelete.

Parameters:

mfa - The optional Multi-Factor Authentication information to include with this request.

Returns:

this, enabling additional method calls to be chained together.

setQuiet

public void setQuiet(boolean quiet)

Sets the quiet element for this request. When true, only errors will be returned in the service response.

getQuiet

public boolean getQuiet()

Returns the quiet element for this request. When true, only errors will be returned in the service response.

withQuiet

public DeleteObjectsRequest withQuiet(boolean quiet)

Sets the quiet element for this request. When true, only errors will be returned in the service response.

Returns:

this, to chain multiple calls together.

setKeys

public void setKeys(List<DeleteObjectsRequest.KeyVersion> keys)

Sets the list of keys to delete from this bucket, clearing any existing list of keys.

Parameters:

keys - The list of keys to delete from this bucket

withKeys

public DeleteObjectsRequest withKeys(List<DeleteObjectsRequest.KeyVersion> keys)

Sets the list of keys to delete from this bucket, clearing any existing list of keys.

Parameters:

keys - The list of keys to delete from this bucket

Returns:

this, to chain multiple calls togethers.

getKeys

public List<DeleteObjectsRequest.KeyVersion> getKeys()

Returns the list of keys to delete from this bucket.

withKeys

public DeleteObjectsRequest withKeys(String... keys)

Convenience method to specify a set of keys without versions.

See Also:

withKeys(List)