com.amazonaws.services.s3.model

Class RestoreObjectRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.RestoreObjectRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, Serializable, Cloneable

public class RestoreObjectRequest
extends AmazonWebServiceRequest
implements Serializable, Cloneable

Request object containing all the options for restoring an object, which was transitioned to the Amazon Glacier from S3 when it was expired.

All RestoreObjectRequest must specify a bucket name and key, along with expiration time.

See Also:

RestoreObjectRequest(String, String, int), RestoreObjectRequest(String, String), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
RestoreObjectRequest(String bucketName, String key) Constructs a new RestoreObjectRequest.
RestoreObjectRequest(String bucketName, String key, int expirationInDays) Constructs a new RestoreObjectRequest.

Method Summary

Modifier and Type	Method and Description
RestoreObjectRequest	clone()
boolean	equals(Object obj)
String	getBucketName() Returns the name of the bucket containing the reference to the object to restore which is now stored in Amazon Glacier.
String	getDescription()
int	getExpirationInDays() Returns the time in days from an object's creation to its expiration.
GlacierJobParameters	getGlacierJobParameters()
String	getKey() Gets the key, the name of the reference to the object to restore, which is now stored in Amazon Glacier.
OutputLocation	getOutputLocation()
SelectParameters	getSelectParameters()
String	getTier()
String	getType()
String	getVersionId() Returns the id of the version to be restored.
int	hashCode()
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 reference to the object to restore which is now stored in Amazon Glacier.
void	setDescription(String description) Sets the description for the job.
void	setExpirationInDays(int expirationInDays) Sets the time, in days, between when an object is uploaded to the bucket and when it expires.
void	setGlacierJobParameters(GlacierJobParameters glacierJobParameters) Sets Glacier related parameters pertaining to this job.
void	setKey(String key) Sets the key, the name of the reference to the object to restore, which is now stored in Amazon Glacier.
void	setOutputLocation(OutputLocation outputLocation) Sets the location where the restore job's output is stored.
void	setRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
void	setSelectParameters(SelectParameters selectParameters) Sets the parameters for select job types.
void	setTier(String tier) Sets the glacier retrieval tier.
void	setType(String type) Sets the restore request type.
void	setVersionId(String versionId) Sets the id of the version to be restored.
String	toString()
RestoreObjectRequest	withBucketName(String bucketName) Sets the name of the bucket containing the reference to the object to restore which is now stored in Amazon Glacier, and returns a reference to this object(RestoreObjectRequest) for method chaining.
RestoreObjectRequest	withDescription(String description) Sets the description for the job.
RestoreObjectRequest	withExpirationInDays(int expirationInDays) Sets the time, in days, between when an object is uploaded to the bucket and when it expires, and returns a reference to this object(RestoreObjectRequest) for method chaining.
RestoreObjectRequest	withGlacierJobParameters(GlacierJobParameters glacierJobParameters) Sets Glacier related parameters pertaining to this job.
RestoreObjectRequest	withKey(String key) Sets the key, the name of the reference to the object to restore, which is now stored in Amazon Glacier.
RestoreObjectRequest	withOutputLocation(OutputLocation outputLocation) Sets the location where the restore job's output is stored.
RestoreObjectRequest	withRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
RestoreObjectRequest	withSelectParameters(SelectParameters selectParameters) Sets the parameters for select job types.
RestoreObjectRequest	withTier(String tier) Sets the glacier retrieval tier.
RestoreObjectRequest	withTier(Tier tier) Sets the glacier retrieval tier.
RestoreObjectRequest	withType(RestoreRequestType restoreRequestType) Sets the restore request type.
RestoreObjectRequest	withType(String restoreRequestType) Sets the restore request type.
RestoreObjectRequest	withVersionId(String versionId) Sets the id of the version to be restored and returns a reference to this object for method chaining.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

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

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RestoreObjectRequest

public RestoreObjectRequest(String bucketName,
                            String key)

Constructs a new RestoreObjectRequest.

Parameters:

bucketName - The name of the bucket containing the reference to the object to restore which is now stored in Amazon Glacier.

key - The key, the name of the reference to the object to restore, which is now stored in Amazon Glacier.

See Also:

RestoreObjectRequest(String, String, int)

RestoreObjectRequest

public RestoreObjectRequest(String bucketName,
                            String key,
                            int expirationInDays)

Constructs a new RestoreObjectRequest.

Parameters:

bucketName - The name of the bucket containing the reference to the object to restore which is now stored in Amazon Glacier.

key - The key, the name of the reference to the object to restore, which is now stored in Amazon Glacier.

expirationInDays - The time, in days, between when an object is restored to the bucket and when it expires

See Also:

RestoreObjectRequest(String, String)

Method Detail

getBucketName

public String getBucketName()

Returns the name of the bucket containing the reference to the object to restore which is now stored in Amazon Glacier.

See Also:

setBucketName(String), withBucketName(String)

withBucketName

public RestoreObjectRequest withBucketName(String bucketName)

Sets the name of the bucket containing the reference to the object to restore which is now stored in Amazon Glacier, and returns a reference to this object(RestoreObjectRequest) for method chaining.

See Also:

setBucketName(String), getBucketName()

setBucketName

public void setBucketName(String bucketName)

Sets the name of the bucket containing the reference to the object to restore which is now stored in Amazon Glacier.

See Also:

getBucketName(), withBucketName(String)

getKey

public String getKey()

Gets the key, the name of the reference to the object to restore, which is now stored in Amazon Glacier.

See Also:

setKey(String), withKey(String)

setKey

public void setKey(String key)

Sets the key, the name of the reference to the object to restore, which is now stored in Amazon Glacier.

See Also:

getKey(), withKey(String)

withKey

public RestoreObjectRequest withKey(String key)

Sets the key, the name of the reference to the object to restore, which is now stored in Amazon Glacier. returns a reference to this object(RestoreObjectRequest) for method chaining.

See Also:

getKey(), setKey(String)

getVersionId

public String getVersionId()

Returns the id of the version to be restored.

setVersionId

public void setVersionId(String versionId)

Sets the id of the version to be restored.

withVersionId

public RestoreObjectRequest withVersionId(String versionId)

Sets the id of the version to be restored and returns a reference to this object for method chaining.

setExpirationInDays

public void setExpirationInDays(int expirationInDays)

Sets the time, in days, between when an object is uploaded to the bucket and when it expires.

Do not use with restores that specify OutputLocation.

getExpirationInDays

public int getExpirationInDays()

Returns the time in days from an object's creation to its expiration.

withExpirationInDays

public RestoreObjectRequest withExpirationInDays(int expirationInDays)

Sets the time, in days, between when an object is uploaded to the bucket and when it expires, and returns a reference to this object(RestoreObjectRequest) for method chaining.

Do not use with restores that specify OutputLocation.

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

getGlacierJobParameters

public GlacierJobParameters getGlacierJobParameters()

Returns:

Glacier related parameters pertaining to this job.

setGlacierJobParameters

public void setGlacierJobParameters(GlacierJobParameters glacierJobParameters)

Sets Glacier related parameters pertaining to this job.

This should not be used for restores with a specified OutputLocation.

Parameters:

glacierJobParameters - New value for Glacier job parameters.

withGlacierJobParameters

public RestoreObjectRequest withGlacierJobParameters(GlacierJobParameters glacierJobParameters)

Sets Glacier related parameters pertaining to this job.

This should not be used for restores with a specified OutputLocation.

Parameters:

glacierJobParameters - New value for Glacier job parameters.

Returns:

This object for method chaining.

getType

public String getType()

Returns:

The type of restore request.

setType

public void setType(String type)

Sets the restore request type.

Parameters:

type - New value for type.

withType

public RestoreObjectRequest withType(String restoreRequestType)

Sets the restore request type.

Parameters:

restoreRequestType - New value for restore request type.

Returns:

This object for method chaining.

withType

public RestoreObjectRequest withType(RestoreRequestType restoreRequestType)

Sets the restore request type.

Parameters:

restoreRequestType - New value for restore request type.

Returns:

This object for method chaining.

getTier

public String getTier()

Returns:

The glacier retrieval tier.

setTier

public void setTier(String tier)

Sets the glacier retrieval tier.

Parameters:

tier - New value for tier.

withTier

public RestoreObjectRequest withTier(String tier)

Sets the glacier retrieval tier.

Parameters:

tier - New value for tier.

Returns:

This object for method chaining.

withTier

public RestoreObjectRequest withTier(Tier tier)

Sets the glacier retrieval tier.

Parameters:

tier - New value for tier.

Returns:

This object for method chaining.

getDescription

public String getDescription()

Returns:

the description for the job.

setDescription

public void setDescription(String description)

Sets the description for the job.

Parameters:

description - New value for the description

withDescription

public RestoreObjectRequest withDescription(String description)

Sets the description for the job.

Parameters:

description - New value for the description

Returns:

This object for method chaining.

getSelectParameters

public SelectParameters getSelectParameters()

Returns:

the parameters for select job types.

setSelectParameters

public void setSelectParameters(SelectParameters selectParameters)

Sets the parameters for select job types.

Parameters:

selectParameters - New value for selectParameters

withSelectParameters

public RestoreObjectRequest withSelectParameters(SelectParameters selectParameters)

Sets the parameters for select job types.

Parameters:

selectParameters - New value for selectParameters

Returns:

This object for method chaining.

getOutputLocation

public OutputLocation getOutputLocation()

Returns:

the location where the restore job's output is stored.

setOutputLocation

public void setOutputLocation(OutputLocation outputLocation)

Sets the location where the restore job's output is stored.

Parameters:

outputLocation - New value for output location

withOutputLocation

public RestoreObjectRequest withOutputLocation(OutputLocation outputLocation)

Sets the location where the restore job's output is stored.

Parameters:

outputLocation - New value for output location

Returns:

This object for method chaining.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

clone

public RestoreObjectRequest clone()

Overrides:

clone in class AmazonWebServiceRequest