org.jclouds.s3.domain
Class BucketLogging

java.lang.Object
  org.jclouds.s3.domain.BucketLogging

public class BucketLogging
extends Object

Each Amazon S3 bucket has an associated XML sub-resource that you can read and write in order to inspect or change the logging status for that bucket.

Author:

Adrian Cole

See Also:

Constructor Summary

BucketLogging(String targetBucket, String targetPrefix)

BucketLogging(String targetBucket, String targetPrefix, Iterable<AccessControlList.Grant> targetGrants)

Method Summary

boolean	equals(Object obj)
String	getTargetBucket() Specifies the bucket where server access logs will be delivered.
Set<AccessControlList.Grant>	getTargetGrants() The bucket owner is automatically granted FULL_CONTROL to all logs delivered to the bucket.
String	getTargetPrefix() This element lets you specify a prefix for the keys that the delivered log files will be stored under.
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

BucketLogging

public BucketLogging(String targetBucket,
                     String targetPrefix,
                     Iterable<AccessControlList.Grant> targetGrants)

Parameters:

targetBucket - getTargetBucket()

targetPrefix - getTargetPrefix()

targetGrants - getTargetGrants()

BucketLogging

public BucketLogging(String targetBucket,
                     String targetPrefix)

Parameters:

targetBucket - getTargetBucket()

targetPrefix - getTargetPrefix()

Method Detail

getTargetGrants

public Set<AccessControlList.Grant> getTargetGrants()

The bucket owner is automatically granted FULL_CONTROL to all logs delivered to the bucket. This optional element enables you grant access to others. Any specified TargetGrants are added to the default ACL. For more information about ACLs, see Access Control Lists.

getTargetBucket

public String getTargetBucket()

Specifies the bucket where server access logs will be delivered. You can have your logs delivered to any bucket that you own, including the same bucket that is being logged. You can also configure multiple buckets to deliver their logs to the same target bucket. In this case you should choose a different TargetPrefix for each source bucket so that the delivered log files can be distinguished by key.

Note

The source and the target buckets must be in the same location. For more information about bucket location constraints, see Buckets and Regions

getTargetPrefix

public String getTargetPrefix()

This element lets you specify a prefix for the keys that the delivered log files will be stored under. For information on how the key name for log files is constructed, see Delivery of Server Access Logs.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object