com.amazonaws.services.s3.model

Class SetObjectAclRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.SetObjectAclRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, ExpectedBucketOwnerRequest, Serializable, Cloneable

public class SetObjectAclRequest
extends AmazonWebServiceRequest
implements Serializable, ExpectedBucketOwnerRequest

Request object containing all the options for setting a object's Access Control List (ACL).

See Also:

Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
SetObjectAclRequest(String bucketName, String key, AccessControlList acl) Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.
SetObjectAclRequest(String bucketName, String key, CannedAccessControlList acl) Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.
SetObjectAclRequest(String bucketName, String key, String versionId, AccessControlList acl) Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.
SetObjectAclRequest(String bucketName, String key, String versionId, CannedAccessControlList acl) Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.

Method Summary

Modifier and Type	Method and Description
AccessControlList	getAcl() Returns the custom ACL to be applied to the specified object when this request is executed.
String	getBucketName() Returns the name of the bucket containing the object whose ACL is being set.
CannedAccessControlList	getCannedAcl() Returns the canned ACL to be applied to the specified object when this request is executed.
String	getExpectedBucketOwner() The account id of the expected bucket owner.
String	getKey() Returns the name of the object whose ACL is being set.
String	getVersionId() Returns the version ID of the object version whose ACL is being set.
boolean	isRequesterPays() Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.
void	setExpectedBucketOwner(String expectedBucketOwner) The account id of the expected bucket owner.
void	setRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.
SetObjectAclRequest	withExpectedBucketOwner(String expectedBucketOwner) The account id of the expected bucket owner.
SetObjectAclRequest	withRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.

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

SetObjectAclRequest

public SetObjectAclRequest(String bucketName,
                           String key,
                           AccessControlList acl)

Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.

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 AWS 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 object whose ACL is being set.

key - The name of the object whose ACL is being set.

acl - The custom Access Control List containing the access rules to apply to the specified bucket when this request is executed.

SetObjectAclRequest

public SetObjectAclRequest(String bucketName,
                           String key,
                           CannedAccessControlList acl)

Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.

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 AWS 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 object whose ACL is being set.

key - The name of the object whose ACL is being set.

acl - The Canned Access Control List to apply to the specified bucket when this request is executed.

SetObjectAclRequest

public SetObjectAclRequest(String bucketName,
                           String key,
                           String versionId,
                           AccessControlList acl)

Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.

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 AWS 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 object whose ACL is being set.

key - The name of the object whose ACL is being set.

versionId - The version ID of the object version whose ACL is being set.

acl - The custom Access Control List containing the access rules to apply to the specified bucket when this request is executed.

SetObjectAclRequest

public SetObjectAclRequest(String bucketName,
                           String key,
                           String versionId,
                           CannedAccessControlList acl)

Constructs a new SetObjectAclRequest object, ready to set the specified ACL on the specified object when this request is executed.

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 AWS 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 object whose ACL is being set.

key - The name of the object whose ACL is being set.

versionId - The version ID of the object version whose ACL is being set.

acl - The Canned Access Control List to apply to the specified bucket when this request is executed.

Method Detail

getExpectedBucketOwner

public String getExpectedBucketOwner()

Description copied from interface: ExpectedBucketOwnerRequest

The account id of the expected bucket owner. If the bucket is owned by a different account than the expected owner, the request will fail.

Specified by:

getExpectedBucketOwner in interface ExpectedBucketOwnerRequest

withExpectedBucketOwner

public SetObjectAclRequest withExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

The account id of the expected bucket owner. If the bucket is owned by a different account than the expected owner, the request will fail.

Specified by:

withExpectedBucketOwner in interface ExpectedBucketOwnerRequest

setExpectedBucketOwner

public void setExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

The account id of the expected bucket owner. If the bucket is owned by a different account than the expected owner, the request will fail.

Specified by:

setExpectedBucketOwner in interface ExpectedBucketOwnerRequest

getBucketName

public String getBucketName()

Returns the name of the bucket containing the object whose ACL is being set.

Returns:

The name of the bucket containing the object whose ACL is being set.

getKey

public String getKey()

Returns the name of the object whose ACL is being set.

Returns:

The name of the object whose ACL is being set.

getVersionId

public String getVersionId()

Returns the version ID of the object version whose ACL is being set.

Returns:

The version ID of the object version whose ACL is being set.

getAcl

public AccessControlList getAcl()

Returns the custom ACL to be applied to the specified object when this request is executed. A request can use either a custom ACL or a canned ACL, but not both.

Returns:

The custom ACL to be applied to the specified bucket when this request is executed, or null if the request is to be executed with a canned ACL.

getCannedAcl

public CannedAccessControlList getCannedAcl()

Returns the canned ACL to be applied to the specified object when this request is executed. A request can use either a custom ACL or a canned ACL, but not both.

Returns:

The canned ACL to be applied to the specified bucket when this request is executed, or null if the request is to be executed with a custom ACL.

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