com.amazonaws.services.s3.model

Class RestoreObjectRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.RestoreObjectRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, ExpectedBucketOwnerRequest, Serializable, Cloneable

public class RestoreObjectRequest
extends AmazonWebServiceRequest
implements Serializable, Cloneable, ExpectedBucketOwnerRequest

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() Creates a shallow clone of this object for all fields except the handler context.
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()
String	getExpectedBucketOwner() Returns he account id of the expected bucket owner.
int	getExpirationInDays() Returns the lifetime of the active copy in days.
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	setExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
void	setExpirationInDays(int expirationInDays) Set the lifetime of the active copy in days.
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	withExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
RestoreObjectRequest	withExpirationInDays(int expirationInDays) Set the lifetime of the active copy in days.
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, 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

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RestoreObjectRequest

public RestoreObjectRequest(String bucketName,
                            String key)

Constructs a new RestoreObjectRequest.

When using this API 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 operation using 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 Simple Storage Service Developer Guide.

Parameters:

bucketName - The name of the bucket, or access point ARN, 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.

When using this API 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 operation using 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 Simple Storage Service Developer Guide.

Parameters:

bucketName - The name of the bucket, or access point ARN, 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

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 RestoreObjectRequest withExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

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

Specified by:

withExpectedBucketOwner in interface ExpectedBucketOwnerRequest

setExpectedBucketOwner

public void setExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

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

Specified by:

setExpectedBucketOwner in interface ExpectedBucketOwnerRequest

getBucketName

public String getBucketName()

Returns the name of the bucket containing the 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.

When using this API 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 operation using 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 Simple Storage Service Developer Guide.

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.

When using this API 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 operation using 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 Simple Storage Service Developer Guide.

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)

Set the lifetime of the active copy in days. Do not use with restores that specify OutputLocation.

The Days element is required for regular restores, and must not be provided for select requests.

getExpirationInDays

public int getExpirationInDays()

Returns the lifetime of the active copy in days. Do not use with restores that specify OutputLocation.

The Days element is required for regular restores, and must not be provided for select requests.

withExpirationInDays

public RestoreObjectRequest withExpirationInDays(int expirationInDays)

Set the lifetime of the active copy in days. Do not use with restores that specify OutputLocation.

The Days element is required for regular restores, and must not be provided for select requests.

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

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