Sample code for 30+ languages & platforms
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.

Chilkat C Downloads

C
#include <C_CkRest.h>
#include <C_CkAuthAws.h>
#include <C_CkStringBuilder.h>
#include <C_CkXml.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkRest rest;
    BOOL bTls;
    int port;
    BOOL bAutoReconnect;
    HCkAuthAws authAws;
    const char *bucketRegion;
    HCkStringBuilder sbBucketRegion;
    HCkXml xml;
    const char *responseStr;
    HCkXml responseXml;

    success = FALSE;

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

    rest = CkRest_Create();

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

    // Provide AWS credentials for the REST call.
    authAws = CkAuthAws_Create();
    CkAuthAws_putAccessKey(authAws,"AWS_ACCESS_KEY");
    CkAuthAws_putSecretKey(authAws,"AWS_SECRET_KEY");
    CkAuthAws_putServiceName(authAws,"s3");
    success = CkRest_SetAuthAws(rest,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"
    bucketRegion = "eu-west-2";
    sbBucketRegion = CkStringBuilder_Create();
    CkStringBuilder_Append(sbBucketRegion,bucketRegion);

    // We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
    xml = CkXml_Create();
    if (!CkStringBuilder_ContentsEqual(sbBucketRegion,"us-east-1")) {
        CkXml_putTag(xml,"CreateBucketConfiguration");
        CkXml_AddAttribute(xml,"xmlns","http://s3.amazonaws.com/doc/2006-03-01/");
        CkXml_UpdateChildContent(xml,"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".
    CkRest_putHost(rest,"chilkateuwest2.s3.amazonaws.com");

    // Make the call to create the bucket.

    if (!CkStringBuilder_ContentsEqual(sbBucketRegion,"us-east-1")) {
        responseStr = CkRest_fullRequestString(rest,"PUT","/",CkXml_getXml(xml));
    }
    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 = CkRest_fullRequestNoBody(rest,"PUT","/");
    }

    if (CkRest_getLastMethodSuccess(rest) != TRUE) {
        printf("%s\n",CkRest_lastErrorText(rest));
        CkRest_Dispose(rest);
        CkAuthAws_Dispose(authAws);
        CkStringBuilder_Dispose(sbBucketRegion);
        CkXml_Dispose(xml);
        return;
    }

    if (CkRest_getResponseStatusCode(rest) != 200) {
        printf("status code = %d\n",CkRest_getResponseStatusCode(rest));
        responseXml = CkXml_Create();
        CkXml_LoadXml(responseXml,responseStr);
        printf("%s\n",CkXml_getXml(responseXml));
        printf("Failed.\n");
        CkRest_Dispose(rest);
        CkAuthAws_Dispose(authAws);
        CkStringBuilder_Dispose(sbBucketRegion);
        CkXml_Dispose(xml);
        CkXml_Dispose(responseXml);
        return;
    }

    printf("Bucket in the eu-west-2 region created.\n");


    CkRest_Dispose(rest);
    CkAuthAws_Dispose(authAws);
    CkStringBuilder_Dispose(sbBucketRegion);
    CkXml_Dispose(xml);
    CkXml_Dispose(responseXml);

    }