com.amazonaws.services.s3.model

Class SetBucketLoggingConfigurationRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.SetBucketLoggingConfigurationRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, ExpectedBucketOwnerRequest, Serializable, Cloneable

public class SetBucketLoggingConfigurationRequest
extends AmazonWebServiceRequest
implements Serializable, ExpectedBucketOwnerRequest

Contains options for setting the logging configuration for a bucket. The bucket logging configuration object controls whether or not server access logging is enabled for the specified bucket. If server access logging is enabled, this object provides options for specifying where the server access logs are delivered and the optional log file prefix.

In order to deliver server access logs, the destination bucket must have log delivery write permissions. Use the CannedAccessControlList.LogDeliveryWrite ACL to quickly add the correct permissions to the destination bucket. Alternatively, modify the bucket's existing ACL to grant the GroupGrantee.LogDelivery group grantee the Permission.Write permission.

Changes to the logging status for a bucket are visible in the configuration API immediately, but take time to actually affect the delivery of log files. For example, when enabling logging for a bucket, some requests made in the following hour might be logged while others might not. For another example, when changing the target bucket for logging from bucket 'A' to bucket 'B', some logs for the next hour might continue to be delivered to bucket 'A.' Others might be delivered to the new target bucket 'B.' In all cases, the new settings will eventually take effect without any further action from the user.

See Also:

SetBucketLoggingConfigurationRequest(String, BucketLoggingConfiguration), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
SetBucketLoggingConfigurationRequest(String bucketName, BucketLoggingConfiguration loggingConfiguration) Constructs a new SetBucketLoggingConfigurationRequest to set the bucket logging configuration of the specified bucket.

Method Summary

Modifier and Type	Method and Description
String	getBucketName() Gets the name of the bucket whose logging configuration is being set.
String	getExpectedBucketOwner() Returns he account id of the expected bucket owner.
BucketLoggingConfiguration	getLoggingConfiguration() Gets the logging configuration for the specified bucket.
void	setBucketName(String bucketName) Sets the name of the bucket whose logging configuration is being set.
void	setExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
void	setLoggingConfiguration(BucketLoggingConfiguration loggingConfiguration) Sets the logging configuration for the specified bucket.
SetBucketLoggingConfigurationRequest	withBucketName(String bucketName) Sets the name of the bucket whose logging configuration is being set and returns this object, enabling additional method calls to be chained together.
SetBucketLoggingConfigurationRequest	withExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
SetBucketLoggingConfigurationRequest	withLoggingConfiguration(BucketLoggingConfiguration loggingConfiguration) Sets the logging configuration for the specified bucket and returns the updated object, enabling additional method calls to be chained together.

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

SetBucketLoggingConfigurationRequest

public SetBucketLoggingConfigurationRequest(String bucketName,
                                            BucketLoggingConfiguration loggingConfiguration)

Constructs a new SetBucketLoggingConfigurationRequest to set the bucket logging configuration of the specified bucket.

Parameters:

bucketName - The name of the bucket whose logging configuration is being set.

loggingConfiguration - The new logging configuration for the specified bucket.

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

Gets the name of the bucket whose logging configuration is being set.

Returns:

The name of the bucket whose logging configuration is being set.

See Also:

setBucketName(String), withLoggingConfiguration(BucketLoggingConfiguration)

setBucketName

public void setBucketName(String bucketName)

Sets the name of the bucket whose logging configuration is being set.

Parameters:

bucketName - The name of the bucket whose logging configuration is being set.

See Also:

getBucketName(), withBucketName(String)

withBucketName

public SetBucketLoggingConfigurationRequest withBucketName(String bucketName)

Sets the name of the bucket whose logging configuration is being set and returns this object, enabling additional method calls to be chained together.

Parameters:

bucketName - The name of the bucket whose logging configuration is being set.

Returns:

This SetBucketLoggingConfigurationRequest object, enabling additional method calls may to be chained together.

See Also:

getBucketName(), setBucketName(String)

getLoggingConfiguration

public BucketLoggingConfiguration getLoggingConfiguration()

Gets the logging configuration for the specified bucket.

Returns:

The logging configuration for the specified bucket.

See Also:

setLoggingConfiguration(BucketLoggingConfiguration), withLoggingConfiguration(BucketLoggingConfiguration)

setLoggingConfiguration

public void setLoggingConfiguration(BucketLoggingConfiguration loggingConfiguration)

Sets the logging configuration for the specified bucket.

Parameters:

loggingConfiguration - The logging configuration for the specified bucket.

See Also:

getLoggingConfiguration(), withLoggingConfiguration(BucketLoggingConfiguration)

withLoggingConfiguration

public SetBucketLoggingConfigurationRequest withLoggingConfiguration(BucketLoggingConfiguration loggingConfiguration)

Sets the logging configuration for the specified bucket and returns the updated object, enabling additional method calls to be chained together.

Parameters:

loggingConfiguration - The logging configuration for the specified bucket.

Returns:

This SetBucketLoggingConfigurationRequest object, enabling additional method calls to be chained together.

See Also:

getLoggingConfiguration(), setLoggingConfiguration(BucketLoggingConfiguration)