(Lianja) 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 Lianja Extension Download Chilkat Lianja Extension

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

loRest = createobject("CkRest")

// Connect to the Amazon AWS REST server.
llBTls = .T.
lnPort = 443
llBAutoReconnect = .T.
llSuccess = loRest.Connect("s3.amazonaws.com",lnPort,llBTls,llBAutoReconnect)

// Provide AWS credentials for the REST call.
loAuthAws = createobject("CkAuthAws")
loAuthAws.AccessKey = "AWS_ACCESS_KEY"
loAuthAws.SecretKey = "AWS_SECRET_KEY"
loAuthAws.ServiceName = "s3"
llSuccess = loRest.SetAuthAws(loAuthAws)

// 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"
lcBucketRegion = "eu-west-2"
loSbBucketRegion = createobject("CkStringBuilder")
loSbBucketRegion.Append(lcBucketRegion)

// We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
loXml = createobject("CkXml")
if (not loSbBucketRegion.ContentsEqual("us-east-1")) then
    loXml.Tag = "CreateBucketConfiguration"
    loXml.AddAttribute("xmlns","http://s3.amazonaws.com/doc/2006-03-01/")
    loXml.UpdateChildContent("LocationConstraint","eu-west-2")
endif

// --------------------------------------------------------------
// 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".
loRest.Host = "chilkateuwest2.s3.amazonaws.com"

// Make the call to create the bucket.

if (not loSbBucketRegion.ContentsEqual("us-east-1")) then
    lcResponseStr = loRest.FullRequestString("PUT","/",loXml.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.
    lcResponseStr = loRest.FullRequestNoBody("PUT","/")
endif

if (loRest.LastMethodSuccess <> .T.) then
    ? loRest.LastErrorText
    release loRest
    release loAuthAws
    release loSbBucketRegion
    release loXml
    return
endif

if (loRest.ResponseStatusCode <> 200) then
    ? "status code = " + str(loRest.ResponseStatusCode)
    loResponseXml = createobject("CkXml")
    loResponseXml.LoadXml(lcResponseStr)
    ? loResponseXml.GetXml()
    ? "Failed."
    release loRest
    release loAuthAws
    release loSbBucketRegion
    release loXml
    release loResponseXml
    return
endif

? "Bucket in the eu-west-2 region created."


release loRest
release loAuthAws
release loSbBucketRegion
release loXml
release loResponseXml