(Objective-C) S3 - Working with Buckets in a Region

Demonstrates how to work with S3 buckets located in a particular region.

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoRest.h>
#import <CkoAuthAws.h>
#import <CkoBinData.h>
#import <CkoStringBuilder.h>

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// When usig the REST class to access an S3 bucket that has been created in a particular region,
// there are three important things to remember:
// 
// 1) Connect to the domain that includes the region.  For example, instead of connecting to
//    "s3.amazonaws.com", connect to "s3.eu-central-1.amazonaws.com" if your bucket is in the EU Frankfurt region.
//    See http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region   for a list of S3 region domains (endpoints)
// 
// 2) Set the AuthAws.Region property equal to the region, such as "eu-central-1".
// 
// 3) Include the region in request's Host header.
// 

// This example will upload to a bucket in the eu-central-1 region.
// 
CkoRest *rest = [[CkoRest alloc] init];

// Connect to the Amazon AWS REST server.
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
BOOL success = [rest Connect: @"s3.eu-central-1.amazonaws.com" port: [NSNumber numberWithInt: port] tls: bTls autoReconnect: bAutoReconnect];

// Provide AWS credentials for the REST call.
CkoAuthAws *authAws = [[CkoAuthAws alloc] init];
authAws.AccessKey = @"AWS_ACCESS_KEY";
authAws.SecretKey = @"AWS_SECRET_KEY";
authAws.ServiceName = @"s3";
authAws.Region = @"eu-central-1";
success = [rest SetAuthAws: authAws];

// Set the bucket name via the HOST header.
// In this case, the bucket name is "chilkateufrankfurt" (which was created in the eu-central-1 region)
rest.Host = @"chilkateufrankfurt.s3.eu-central-1.amazonaws.com";

CkoBinData *fileData = [[CkoBinData alloc] init];
success = [fileData LoadFile: @"qa_data/jpg/starfish.jpg"];

// Upload the file to Amazon S3.
CkoStringBuilder *responseBody = [[CkoStringBuilder alloc] init];
success = [rest FullRequestBd: @"PUT" uriPath: @"/starfish.jpg" binData: fileData responseBody: responseBody];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// Did we get a 200 response indicating success?
int statusCode = [rest.ResponseStatusCode intValue];
if (statusCode != 200) {
    NSLog(@"%@%@",@"Error response: ",[responseBody GetAsString]);
    NSLog(@"%@%d%@%@",@"Status code: ",statusCode,@", Status text: ",rest.ResponseStatusText);
    return;
}

NSLog(@"%@",@"File successfully uploaded.");