(Excel) S3 - Working with Buckets in a Region

Demonstrates how to work with S3 buckets located in a particular region.

Download Excel Class Modules Chilkat Excel Class Modules

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

' When usig the REST class to access an S3 bucket that has been created in a particular region,
' there are three important things to remember:
' 
' 1) Connect to the domain that includes the region.  For example, instead of connecting to
'    "s3.amazonaws.com", connect to "s3.eu-central-1.amazonaws.com" if your bucket is in the EU Frankfurt region.
'    See http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region   for a list of S3 region domains (endpoints)
' 
' 2) Set the AuthAws.Region property equal to the region, such as "eu-central-1".
' 
' 3) Include the region in request's Host header.
' 

' This example will upload to a bucket in the eu-central-1 region.
' 
Dim rest As Chilkat.Rest
Set rest = Chilkat.NewRest

' Connect to the Amazon AWS REST server.

bTls = True

port = 443

bAutoReconnect = True

success = rest.Connect("s3.eu-central-1.amazonaws.com",port,bTls,bAutoReconnect)

' Provide AWS credentials for the REST call.
Dim authAws As Chilkat.AuthAws
Set authAws = Chilkat.NewAuthAws
authAws.AccessKey = "AWS_ACCESS_KEY"
authAws.SecretKey = "AWS_SECRET_KEY"
authAws.ServiceName = "s3"
authAws.Region = "eu-central-1"
success = rest.SetAuthAws(authAws)

' Set the bucket name via the HOST header.
' In this case, the bucket name is "chilkateufrankfurt" (which was created in the eu-central-1 region)
rest.Host = "chilkateufrankfurt.s3.eu-central-1.amazonaws.com"

Dim fileData As Chilkat.BinData
Set fileData = Chilkat.NewBinData
success = fileData.LoadFile("qa_data/jpg/starfish.jpg")

' Upload the file to Amazon S3.
Dim responseBody As Chilkat.StringBuilder
Set responseBody = Chilkat.NewStringBuilder
success = rest.FullRequestBd("PUT","/starfish.jpg",fileData,responseBody)
If (success <> True) Then
    Debug.Print rest.LastErrorText
    Exit Sub
End If

' Did we get a 200 response indicating success?

statusCode = rest.ResponseStatusCode
If (statusCode <> 200) Then
    Debug.Print "Error response: "; responseBody.GetAsString()
    Debug.Print "Status code: "; statusCode; ", Status text: "; rest.ResponseStatusText
    Exit Sub
End If

Debug.Print "File successfully uploaded."