(Xojo Plugin) S3 Add Tags to an Object

See more Amazon S3 (new) Examples

Demonstrates how to add one or more tags to an S3 object.

For more information, see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html

Chilkat Xojo Plugin Download Xojo Plugin for Windows, Linux, Mac OS X, and ARM, ARM64

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

Dim rest As New Chilkat.Rest

// Connect to the Amazon AWS REST server in the desired region.
// (for us-east-1, we use "s3.amazonaws.com", but for another region, such as us-west-2, we would use "s3-us-west-2.amazonaws.com")
Dim bTls As Boolean
bTls = True
Dim port As Int32
port = 443
Dim bAutoReconnect As Boolean
bAutoReconnect = True
Dim success As Boolean
success = rest.Connect("s3.amazonaws.com",port,bTls,bAutoReconnect)

// Provide AWS credentials.
Dim authAws As New Chilkat.AuthAws
authAws.AccessKey = "AWS_ACCESS_KEY"
authAws.SecretKey = "AWS_SECRET_KEY"
authAws.ServiceName = "s3"
authAws.Region = "us-east-1"

success = rest.SetAuthAws(authAws)

// Set the bucket name via the HOST header.
// In this case, the bucket name is "chilkat100".
// Note that the Host header should use "bucketName.s3.amazonaws.com", not "bucketName.s3-us-east-1.amazonaws.com"
// The same applies to aother regions.  The Host header should simply be <bucketName>.s3.amazonaws.com regardless of the region.
rest.Host = "chilkat100.s3.amazonaws.com"

Dim xml As New Chilkat.Xml
xml.Tag = "Tagging"
xml.UpdateChildContent "TagSet|Tag|Key","plant"
xml.UpdateChildContent "TagSet|Tag|Value","chili pepper"

Dim sbRequestBody As New Chilkat.StringBuilder
success = xml.GetXmlSb(sbRequestBody)

// It is important to add the terminating "=" after the "?tagging".
Dim sbResponse As New Chilkat.StringBuilder
success = rest.FullRequestSb("PUT","/chiliPepper.gif?tagging=",sbRequestBody,sbResponse)
If (success = False) Then
    System.DebugLog(rest.LastErrorText)
    Return
End If

System.DebugLog("Response status code: " + Str(rest.ResponseStatusCode))

// When successful, the S3 Storage service will respond with a 200 response code,
// with an XML body.  
If (rest.ResponseStatusCode <> 200) Then
    // Examine the request/response to see what happened.
    System.DebugLog("response status code = " + Str(rest.ResponseStatusCode))
    System.DebugLog("response status text = " + rest.ResponseStatusText)
    System.DebugLog("response header: " + rest.ResponseHeader)
    System.DebugLog("response body: " + sbResponse.GetAsString())
    System.DebugLog("---")
    System.DebugLog("LastRequestStartLine: " + rest.LastRequestStartLine)
    System.DebugLog("LastRequestHeader: " + rest.LastRequestHeader)
End If

System.DebugLog(sbResponse.GetAsString())
System.DebugLog("Success.")