Payer (Apache jclouds 1.7.3 API)

Enum Constants
Enum Constant and Description
`BUCKET_OWNER`
`REQUESTER`
`UNRECOGNIZED`

Methods
Modifier and Type	Method and Description
`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.

java.lang.Object
- java.lang.Enum<Payer>
- - 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.
- Anonymous requests
- BitTorrent
- SOAP requests
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

Enum Constants
Enum Constant and Description

BUCKET_OWNER

REQUESTER

UNRECOGNIZED

Method Summary

Methods
Modifier and Type Method and Description

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)
```

Enum Payer

Important

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

REQUESTER

BUCKET_OWNER

UNRECOGNIZED

Method Detail

values

valueOf

value

fromValue