(Visual FoxPro) 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 ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loRest
LOCAL lnBTls
LOCAL lnPort
LOCAL lnBAutoReconnect
LOCAL lnSuccess
LOCAL loAuthAws
LOCAL lcBucketRegion
LOCAL loSbBucketRegion
LOCAL loXml
LOCAL lcResponseStr
LOCAL loResponseXml

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Rest')
loRest = CreateObject('Chilkat.Rest')

* Connect to the Amazon AWS REST server.
lnBTls = 1
lnPort = 443
lnBAutoReconnect = 1
lnSuccess = loRest.Connect("s3.amazonaws.com",lnPort,lnBTls,lnBAutoReconnect)

* Provide AWS credentials for the REST call.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.AuthAws')
loAuthAws = CreateObject('Chilkat.AuthAws')
loAuthAws.AccessKey = "AWS_ACCESS_KEY"
loAuthAws.SecretKey = "AWS_SECRET_KEY"
loAuthAws.ServiceName = "s3"
lnSuccess = 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"
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbBucketRegion = CreateObject('Chilkat.StringBuilder')
loSbBucketRegion.Append(lcBucketRegion)

* We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Xml')
loXml = CreateObject('Chilkat.Xml')
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 <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loRest
    RELEASE loAuthAws
    RELEASE loSbBucketRegion
    RELEASE loXml
    CANCEL
ENDIF

IF (loRest.ResponseStatusCode <> 200) THEN
    ? "status code = " + STR(loRest.ResponseStatusCode)
    * For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Xml')
    loResponseXml = CreateObject('Chilkat.Xml')
    loResponseXml.LoadXml(lcResponseStr)
    ? loResponseXml.GetXml()
    ? "Failed."
    RELEASE loRest
    RELEASE loAuthAws
    RELEASE loSbBucketRegion
    RELEASE loXml
    RELEASE loResponseXml
    CANCEL
ENDIF

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

RELEASE loRest
RELEASE loAuthAws
RELEASE loSbBucketRegion
RELEASE loXml
RELEASE loResponseXml