Sample code for 30+ languages & platforms
Node.js

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.

Chilkat Node.js Downloads

Node.js
NODEJS_PRELUDE

function chilkatExample() {

    var success = false;

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

    var rest = new chilkat.Rest();

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

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

    //  We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
    var 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.
    var 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) {
        console.log(rest.LastErrorText);
        return;
    }

    if (rest.ResponseStatusCode !== 200) {
        console.log("status code = " + rest.ResponseStatusCode);
        var responseXml = new chilkat.Xml();
        responseXml.LoadXml(responseStr);
        console.log(responseXml.GetXml());
        console.log("Failed.");
        return;
    }

    console.log("Bucket in the eu-west-2 region created.");

}

chilkatExample();