B4X

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. B4X

Dim success As Boolean = False

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

Dim rest As ChilkatRest
rest.Initialize("rest")

'  Connect to the Amazon AWS REST server.
Dim bTls As Boolean = True
Dim port As Int = 443
Dim bAutoReconnect As Boolean = True
success = rest.Connect("s3.amazonaws.com", port, bTls, bAutoReconnect)

'  Provide AWS credentials for the REST call.
Dim authAws As ChilkatAuthAws
authAws.Initialize
authAws.AccessKey = "AWS_ACCESS_KEY"
authAws.SecretKey = "AWS_SECRET_KEY"
authAws.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"
Dim bucketRegion As String = "eu-west-2"
Dim sbBucketRegion As ChilkatStringBuilder
sbBucketRegion.Initialize
sbBucketRegion.Append(bucketRegion)

'  We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
Dim xml As ChilkatXml
xml.Initialize
If Not(sbBucketRegion.ContentsEqual("us-east-1")) Then
    xml.Tag = "CreateBucketConfiguration"
    xml.AddAttribute("xmlns", "http://s3.amazonaws.com/doc/2006-03-01/")
    xml.UpdateChildContent("LocationConstraint", "eu-west-2")
End If


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

'  Make the call to create the bucket.
Dim responseStr As String
If Not(sbBucketRegion.ContentsEqual("us-east-1")) Then
    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", "/")
End If

If rest.LastMethodSuccess <> True Then
    Log(rest.LastErrorText)
    Return
End If


If rest.ResponseStatusCode <> 200 Then
    Log("status code = " & rest.ResponseStatusCode)
    Dim responseXml As ChilkatXml
    responseXml.Initialize
    responseXml.LoadXml(responseStr)
    Log(responseXml.GetXml)
    Log("Failed.")
    Return
End If


Log("Bucket in the eu-west-2 region created.")