Public Member Functions | Static Public Member Functions | Protected Attributes

S3Region Class Reference

Specifies constants that define Amazon S3 Regions. More...

#import <S3Region.h>

List of all members.

Public Member Functions

(id) - initWithStringValue:
 Returns an S3Region initialized with the supplied string value.

Static Public Member Functions

(S3Region *) + USStandard
 The US Standard Amazon S3 Region.
(S3Region *) + USWest
 The US-West (Northern California) Amazon S3 Region.
(S3Region *) + EUIreland
 The EU (Ireland) Amazon S3 Region.
(S3Region *) + APSingapore
 The Asia Pacific (Singapore) Region.
(S3Region *) + regionWithString:
 Convert a string describing an Amazon S3 region to the corresponding S3Region.

Protected Attributes

NSString * stringValue

Detailed Description

Specifies constants that define Amazon S3 Regions.

Amazon S3 Regions allow the user to choose the geographical region where Amazon S3 will store the buckets the user creates. Choose a Amazon S3 Region to optimize latency, minimize costs, or address regulatory requirements.

Objects stored in a Amazon S3 Region never leave that region unless explicitly transfered to another region.


Member Function Documentation

+ (S3Region * S3Region.)APSingapore  

The Asia Pacific (Singapore) Region.

This region uses Amazon S3 servers located in Singapore.

When using buckets in this region, optionally set the client endpoint to s3-ap-southeast-1.amazonaws.com on all requests to these buckets to reduce any latency experienced after the first hour of creating a bucket in this region.

+ (S3Region * S3Region.)EUIreland  

The EU (Ireland) Amazon S3 Region.

This region uses Amazon S3 servers located in Ireland.

In Amazon S3, the EU (Ireland) Region provides read-after-write consistency for PUTS of new objects in Amazon S3 buckets and eventual consistency for overwrite PUTS and DELETES.

- (id S3Region.)initWithStringValue: (NSString *)  value  

Returns an S3Region initialized with the supplied string value.

+ (S3Region * S3Region.)regionWithString: (NSString *)  regionName  

Convert a string describing an Amazon S3 region to the corresponding S3Region.

Parameters:
regionName A string representation of an Amazon S3 region.
Returns:
The corresponding S3Region.
Exceptions:
AWSClientException If the specified string does not match one of the Amazon S3 regions.
+ (S3Region * S3Region.)USStandard  

The US Standard Amazon S3 Region.

This region uses Amazon S3 servers located in the United States.

This is the default Amazon S3 Region. All requests sent to s3.amazonaws.com go to this region unless a location constraint is specified when creating a bucket. The US Standard Region automatically places data in either Amazon's east or west coast data centers depending on which one provides the lowest latency. The US Standard Region provides eventual consistency for all requests.

+ (S3Region * S3Region.)USWest  

The US-West (Northern California) Amazon S3 Region.

This region uses Amazon S3 servers located in Northern California.

When using buckets in this region, optionally set the client endpoint to s3-us-west-1.amazonaws.com on all requests to these buckets to reduce any latency experienced after the first hour of creating a bucket in this region.

In Amazon S3, the US-West (Northern California) Region provides read-after-write consistency for PUTS of new objects in Amazon S3 buckets and eventual consistency for overwrite PUTS and DELETES.


The documentation for this class was generated from the following file: