com.amazonaws.services.s3.model

Class SetObjectLegalHoldRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.SetObjectLegalHoldRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, ExpectedBucketOwnerRequest, Serializable, Cloneable

public class SetObjectLegalHoldRequest
extends AmazonWebServiceRequest
implements Serializable, ExpectedBucketOwnerRequest

Applies a Legal Hold configuration to the specified object.

See Also:

Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
SetObjectLegalHoldRequest()

Method Summary

Modifier and Type	Method and Description
String	getBucketName() The bucket name containing the object that you want to place a Legal Hold on.
String	getExpectedBucketOwner() Returns he account id of the expected bucket owner.
String	getKey() The Object Key.
ObjectLockLegalHold	getLegalHold() Container element for the Legal Hold configuration you want to apply to the specified object.
String	getVersionId() The Object Version ID.
boolean	isRequesterPays() Returns true if the user has enabled Requester Pays option when downloading an object from Requester Pays Bucket; else false.
void	setBucketName(String bucket) The bucket name containing the object that you want to place a Legal Hold on.
void	setExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
void	setKey(String key) The Object Key.
void	setLegalHold(ObjectLockLegalHold legalHold) Container element for the Legal Hold configuration you want to apply to the specified object.
void	setRequesterPays(boolean isRequesterPays) Used for downloading an Amazon S3 Object from a Requester Pays Bucket.
void	setVersionId(String versionId) The Object Version ID.
SetObjectLegalHoldRequest	withBucketName(String bucket) The bucket name containing the object that you want to place a Legal Hold on.
SetObjectLegalHoldRequest	withExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
SetObjectLegalHoldRequest	withKey(String key) The Object Key.
SetObjectLegalHoldRequest	withLegalHold(ObjectLockLegalHold legalHold) Container element for the Legal Hold configuration you want to apply to the specified object.
SetObjectLegalHoldRequest	withRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
SetObjectLegalHoldRequest	withVersionId(String versionId) The Object Version ID.

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

Constructor Detail

SetObjectLegalHoldRequest

public SetObjectLegalHoldRequest()

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 SetObjectLegalHoldRequest 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 bucket name containing the object that you want to place a Legal Hold on.

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.

Returns:

The bucket name containing the object that you want to place a Legal Hold on.

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.

withBucketName

public SetObjectLegalHoldRequest withBucketName(String bucket)

The bucket name containing the object that you want to place a Legal Hold on.

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.

Parameters:

bucket - The bucket name containing the object that you want to place a Legal Hold on.

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.

Returns:

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

setBucketName

public void setBucketName(String bucket)

The bucket name containing the object that you want to place a Legal Hold on.

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.

Parameters:

bucket - The bucket name containing the object that you want to place a Legal Hold on.

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.

getKey

public String getKey()

The Object Key.

withKey

public SetObjectLegalHoldRequest withKey(String key)

The Object Key.

setKey

public void setKey(String key)

The Object Key.

getLegalHold

public ObjectLockLegalHold getLegalHold()

Container element for the Legal Hold configuration you want to apply to the specified object.

withLegalHold

public SetObjectLegalHoldRequest withLegalHold(ObjectLockLegalHold legalHold)

Container element for the Legal Hold configuration you want to apply to the specified object.

setLegalHold

public void setLegalHold(ObjectLockLegalHold legalHold)

Container element for the Legal Hold configuration you want to apply to the specified object.

isRequesterPays

public boolean isRequesterPays()

Returns true if the user has enabled Requester Pays option when downloading an object from Requester Pays Bucket; else false.

If a bucket is enabled for Requester Pays, then any attempt to read 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 downloading an object from Requester Pays Bucket.

withRequesterPays

public SetObjectLegalHoldRequest 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 GetObjectRequest 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 GetObjectRequest object.

setRequesterPays

public void setRequesterPays(boolean isRequesterPays)

Used for downloading an Amazon S3 Object from a Requester Pays Bucket. If set the requester is charged for downloading the data from the bucket.

If a bucket is enabled for Requester Pays, then any attempt to read 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.

getVersionId

public String getVersionId()

The Object Version ID.

withVersionId

public SetObjectLegalHoldRequest withVersionId(String versionId)

The Object Version ID.

setVersionId

public void setVersionId(String versionId)

The Object Version ID.