B4X

S3 Add Tags to an Object

See more Amazon S3 (new) Examples

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

Dim success As Boolean = False

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

Dim rest As ChilkatRest
rest.Initialize("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 = True
Dim port As Int = 443
Dim bAutoReconnect As Boolean = True
success = rest.Connect("s3.amazonaws.com", port, bTls, bAutoReconnect)

'  Provide AWS credentials.
Dim authAws As ChilkatAuthAws
authAws.Initialize
authAws.AccessKey = "AWS_ACCESS_KEY"
authAws.SecretKey = "AWS_SECRET_KEY"
authAws.ServiceName = "s3"
authAws.Region = "us-east-1"

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 ChilkatXml
xml.Initialize
xml.Tag = "Tagging"
xml.UpdateChildContent("TagSet|Tag|Key", "plant")
xml.UpdateChildContent("TagSet|Tag|Value", "chili pepper")

Dim sbRequestBody As ChilkatStringBuilder
sbRequestBody.Initialize
xml.GetXmlSb(sbRequestBody)

'  It is important to add the terminating "=" after the "?tagging".
Dim sbResponse As ChilkatStringBuilder
sbResponse.Initialize
success = rest.FullRequestSb("PUT", "/chiliPepper.gif?tagging=", sbRequestBody, sbResponse)
If success = False Then
    Log(rest.LastErrorText)
    Return
End If


Log("Response status code: " & 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.
    Log("response status code = " & rest.ResponseStatusCode)
    Log("response status text = " & rest.ResponseStatusText)
    Log("response header: " & rest.ResponseHeader)
    Log("response body: " & sbResponse.GetAsString)
    Log("---")
    Log("LastRequestStartLine: " & rest.LastRequestStartLine)
    Log("LastRequestHeader: " & rest.LastRequestHeader)
End If


Log(sbResponse.GetAsString)
Log("Success.")