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. C++

#include <CkRest.h>
#include <CkAuthAws.h>
#include <CkStringBuilder.h>
#include <CkXml.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkRest rest;

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

    // Provide AWS credentials for the REST call.
    CkAuthAws authAws;
    authAws.put_AccessKey("AWS_ACCESS_KEY");
    authAws.put_SecretKey("AWS_SECRET_KEY");
    authAws.put_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"
    const char *bucketRegion = "eu-west-2";
    CkStringBuilder sbBucketRegion;
    sbBucketRegion.Append(bucketRegion);

    // We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
    CkXml xml;
    if (!sbBucketRegion.ContentsEqual("us-east-1")) {
        xml.put_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.put_Host("chilkateuwest2.s3.amazonaws.com");

    // Make the call to create the bucket.
    const char *responseStr = 0;
    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.get_LastMethodSuccess() != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() != 200) {
        std::cout << "status code = " << rest.get_ResponseStatusCode() << "\r\n";
        CkXml responseXml;
        responseXml.LoadXml(responseStr);
        std::cout << responseXml.getXml() << "\r\n";
        std::cout << "Failed." << "\r\n";
        return;
    }

    std::cout << "Bucket in the eu-west-2 region created." << "\r\n";
    }