(VB.NET) S3 - Working with Buckets in a Region

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

Chilkat .NET Downloads Chilkat .NET Framework Chilkat for .NET Core

' 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 New Chilkat.Rest

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

' Provide AWS credentials for the REST call.
Dim authAws As New Chilkat.AuthAws
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 New Chilkat.BinData
success = fileData.LoadFile("qa_data/jpg/starfish.jpg")

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


' Did we get a 200 response indicating success?
Dim statusCode As Integer = rest.ResponseStatusCode
If (statusCode <> 200) Then
    Debug.WriteLine("Error response: " & responseBody.GetAsString())
    Debug.WriteLine("Status code: " & statusCode & ", Status text: " & rest.ResponseStatusText)
    Exit Sub
End If


Debug.WriteLine("File successfully uploaded.")