org.jclouds.s3.domain
Class BucketLogging

java.lang.Object
  extended by 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


Copyright © 2009-2011 jclouds. All Rights Reserved.