C
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
#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);
}