(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.

For more information, see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html

Chilkat .NET Downloads Chilkat .NET Framework Chilkat for .NET Core

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

Chilkat.Rest rest = new Chilkat.Rest();

// Connect to the Amazon AWS REST server.
bool bTls = true;
int port = 443;
bool bAutoReconnect = true;
bool success = rest.Connect("s3.amazonaws.com",port,bTls,bAutoReconnect);

// Provide AWS credentials for the REST call.
Chilkat.AuthAws authAws = new Chilkat.AuthAws();
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"
string bucketRegion = "eu-west-2";
Chilkat.StringBuilder sbBucketRegion = new Chilkat.StringBuilder();
sbBucketRegion.Append(bucketRegion);

// We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
Chilkat.Xml xml = new Chilkat.Xml();
if (!sbBucketRegion.ContentsEqual("us-east-1")) {
    xml.Tag = "CreateBucketConfiguration";
    xml.AddAttribute("xmlns","http://s3.amazonaws.com/doc/2006-03-01/");
    xml.UpdateChildContent("LocationConstraint","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.
string responseStr;
if (!sbBucketRegion.ContentsEqual("us-east-1")) {
    responseStr = rest.FullRequestString("PUT","/",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","/");
}

if (rest.LastMethodSuccess != true) {
    Debug.WriteLine(rest.LastErrorText);
    return;
}

if (rest.ResponseStatusCode != 200) {
    Debug.WriteLine("status code = " + Convert.ToString(rest.ResponseStatusCode));
    Chilkat.Xml responseXml = new Chilkat.Xml();
    responseXml.LoadXml(responseStr);
    Debug.WriteLine(responseXml.GetXml());
    Debug.WriteLine("Failed.");
    return;
}

Debug.WriteLine("Bucket in the eu-west-2 region created.");