B4X
B4X
S3 - Working with Buckets in a Region
See more Amazon S3 (new) Examples
Demonstrates how to work with S3 buckets located in a particular region.Chilkat B4X Downloads
Dim success As Boolean = False
' 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 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.eu-central-1.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"
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 ChilkatBinData
fileData.Initialize
success = fileData.LoadFile("qa_data/jpg/starfish.jpg")
' Upload the file to Amazon S3.
Dim responseBody As ChilkatStringBuilder
responseBody.Initialize
success = rest.FullRequestBd("PUT", "/starfish.jpg", fileData, responseBody)
If success <> True Then
Log(rest.LastErrorText)
Return
End If
' Did we get a 200 response indicating success?
Dim statusCode As Int = rest.ResponseStatusCode
If statusCode <> 200 Then
Log("Error response: " & responseBody.GetAsString)
Log("Status code: " & statusCode & ", Status text: " & rest.ResponseStatusText)
Return
End If
Log("File successfully uploaded.")