Objective-C

Create S3 Bucket in a Region

See more Amazon S3 Examples

Demonstrates how to create an S3 bucket in a specified region. This example will create a bucket in the eu-west-2 region. Objective-C

#import <CkoRest.h>
#import <CkoAuthAws.h>
#import <NSString.h>
#import <CkoStringBuilder.h>
#import <CkoXml.h>

BOOL success = NO;

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

CkoRest *rest = [[CkoRest alloc] init];

// Connect to the Amazon AWS REST server.
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
success = [rest Connect: @"s3.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";
success = [rest SetAuthAws: authAws];

// We'll send a PUT request having an XML body such as this:
// <CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
//   <LocationConstraint>BucketRegion</LocationConstraint> 
//   </CreateBucketConfiguration>

// Create the XML body specifying the region as "eu-west-2"
NSString *bucketRegion = @"eu-west-2";
CkoStringBuilder *sbBucketRegion = [[CkoStringBuilder alloc] init];
[sbBucketRegion Append: bucketRegion];

// We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
CkoXml *xml = [[CkoXml alloc] init];
if (![sbBucketRegion ContentsEqual: @"us-east-1"]) {
    xml.Tag = @"CreateBucketConfiguration";
    [xml AddAttribute: @"xmlns" value: @"http://s3.amazonaws.com/doc/2006-03-01/"];
    [xml UpdateChildContent: @"LocationConstraint" value: @"eu-west-2"];
}

// --------------------------------------------------------------
// IMPORTANT: To create a bucket in the default us-east-1 region,
// do not add the LocationConstraint.  Adding a LocationConstraint of "us-east-1"
// causes an error "The specified location-constraint is not valid."
// By default, the bucket is created in us-east-1 by sending a PUT with an empty body.
// --------------------------------------------------------------

// Set the bucket name via the HOST header.
// In this case, the bucket name is "chilkateuwest2".
rest.Host = @"chilkateuwest2.s3.amazonaws.com";

// Make the call to create the bucket.
NSString *responseStr = 0;
if (![sbBucketRegion ContentsEqual: @"us-east-1"]) {
    responseStr = [rest FullRequestString: @"PUT" uriPath: @"/" bodyText: [xml GetXml]];
}
else {
    // If the bucket is to be created in the us-east-1 region (the default region)
    // just send a PUT with no body.
    responseStr = [rest FullRequestNoBody: @"PUT" uriPath: @"/"];
}

if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

if ([rest.ResponseStatusCode intValue] != 200) {
    NSLog(@"%@%d",@"status code = ",[rest.ResponseStatusCode intValue]);
    CkoXml *responseXml = [[CkoXml alloc] init];
    [responseXml LoadXml: responseStr];
    NSLog(@"%@",[responseXml GetXml]);
    NSLog(@"%@",@"Failed.");
    return;
}

NSLog(@"%@",@"Bucket in the eu-west-2 region created.");