Sample code for 30+ languages & platforms
B4X

Upload File with User-Defined Metadata

See more Amazon S3 Examples

Demonstrates how to upload a file with user-defined metadata to the Amazon S3 service.

Chilkat B4X Downloads

B4X
Dim success As Boolean = False

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

Dim http As ChilkatHttp
http.Initialize("http")

'  Insert your AWS keys here:
http.AwsAccessKey = "AWS_ACCESS_KEY"
http.AwsSecretKey = "AWS_SECRET_KEY"

Dim bucketName As String = "chilkat.ocean"
Dim objectName As String = "seahorse.jpg"
Dim localFilePath As String = "qa_data/jpg/seahorse.jpg"
Dim contentType As String = "image/jpg"

'  User-defined metadata are name/value pairs, and are added to the HTTP request header.
'  Header names must begin with "x-amz-meta-" to distinguish them from other HTTP headers.
'  Note that Amazon S3 stores user-defined metadata keys in lowercase.

'  For example, to add genus=Hippocampus, we do this:
http.SetRequestHeader("x-amz-meta-genus", "Hippocampus")

'  Add a few more user-metadata key pairs.
http.SetRequestHeader("x-amz-meta-species", "big-belly seahorse")
http.SetRequestHeader("x-amz-meta-habitat", "shallow tropical and temperate waters")

success = http.S3_UploadFile(localFilePath, contentType, bucketName, objectName)

If success <> True Then
    Log(http.LastErrorText)
Else
    Log("File uploaded.")
End If