org.jclouds.s3.domain
Enum Payer

java.lang.Object
  extended by java.lang.Enum<Payer>
      extended by org.jclouds.s3.domain.Payer
All Implemented Interfaces:
Serializable, Comparable<Payer>

public enum Payer
extends Enum<Payer>

Specifies who pays for the download and request fees.

In general, bucket owners pay for all Amazon S3 storage and data transfer costs associated with their bucket. A bucket owner, however, can configure a bucket to be a Requester Pays bucket. With Requester Pays buckets, the requester instead of the bucket owner pays the cost of the request and the data download from the bucket. The bucket owner always pays the cost of storing data.

Typically, you configure buckets to be Requester Pays when you want to share data but not incur charges associated with others accessing the data. You might, for example, use Requester Pays buckets when making available large data sets, such as zip code directories, reference data, geospatial information, or web crawling data.

Important

If you enable Requester Pays on a bucket, anonymous access to that bucket is not allowed.

You must authenticate all requests involving Requester Pays buckets. The request authentication enables Amazon S3 to identify and charge the requester for their use of the Requester Pays bucket.

After you configure a bucket to be a Requester Pays bucket, requesters must include x-amz-request-payer in their requests either in the header, for POST and GET requests, or as a parameter in a REST request to show that they understand that they will be charged for the request and the data download.

Requester Pays buckets do not support the following.

You cannot use a Requester Pays bucket as the target bucket for end user logging, or vice versa. However, you can turn on end user logging on a Requester Pays bucket where the target bucket is a non Requester Pays bucket.

Author:
Adrian Cole
See Also:

Enum Constant Summary
BUCKET_OWNER
           
REQUESTER
           
UNRECOGNIZED
           
 
Method Summary
static Payer fromValue(String payer)
           
 String value()
           
static Payer valueOf(String name)
          Returns the enum constant of this type with the specified name.
static Payer[] values()
          Returns an array containing the constants of this enum type, in the order they are declared.
 
Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Enum Constant Detail

REQUESTER

public static final Payer REQUESTER

BUCKET_OWNER

public static final Payer BUCKET_OWNER

UNRECOGNIZED

public static final Payer UNRECOGNIZED
Method Detail

values

public static Payer[] values()
Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
for (Payer c : Payer.values())
    System.out.println(c);

Returns:
an array containing the constants of this enum type, in the order they are declared

valueOf

public static Payer valueOf(String name)
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:
name - the name of the enum constant to be returned.
Returns:
the enum constant with the specified name
Throws:
IllegalArgumentException - if this enum type has no constant with the specified name
NullPointerException - if the argument is null

value

public String value()

fromValue

public static Payer fromValue(String payer)


Copyright © 2009-2011 jclouds. All Rights Reserved.