- 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
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
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.
- Anonymous requests
- SOAP requests
- Adrian Cole
- See Also:
public static final Payer REQUESTER
public static final Payer BUCKET_OWNER
public static final Payer UNRECOGNIZED
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())
- an array containing the constants of this enum type, in
the order they are declared
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
name - the name of the enum constant to be returned.
- the enum constant with the specified name
IllegalArgumentException - if this enum type has no constant
with the specified name
NullPointerException - if the argument is null
public String value()
public static Payer fromValue(String payer)
Copyright © 2009-2011 jclouds. All Rights Reserved.