Lua

S3 Add Tags to an Object

See more Amazon S3 (new) Examples

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

local chilkat = require("chilkat")

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

local rest = chilkat.Rest.new()

-- 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")
local bTls = true
local port = 443
local bAutoReconnect = true
local success = rest:connect("s3.amazonaws.com", port, bTls, bAutoReconnect)

-- Provide AWS credentials.
local authAws = chilkat.AuthAws.new()
authAws.access_key = "AWS_ACCESS_KEY"
authAws.secret_key = "AWS_SECRET_KEY"
authAws.service_name = "s3"
authAws.region = "us-east-1"

rest:set_auth_aws(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"

local xml = chilkat.Xml.new()
xml.tag = "Tagging"
xml:update_child_content("TagSet|Tag|Key", "plant")
xml:update_child_content("TagSet|Tag|Value", "chili pepper")

local sbRequestBody = chilkat.StringBuilder.new()
xml:get_xml_sb(sbRequestBody)

-- It is important to add the terminating "=" after the "?tagging".
local sbResponse = chilkat.StringBuilder.new()
success = rest:full_request_sb("PUT", "/chiliPepper.gif?tagging=", sbRequestBody, sbResponse)
if not success then
    print(rest.last_error_text)
    return
end

print("Response status code: " .. rest.response_status_code)

-- When successful, the S3 Storage service will respond with a 200 response code,
-- with an XML body.
if rest.response_status_code ~= 200 then
    -- Examine the request/response to see what happened.
    print("response status code = " .. rest.response_status_code)
    print("response status text = " .. rest.response_status_text)
    print("response header: " .. rest.response_header)
    print("response body: " .. sbResponse:get_as_string())
    print("---")
    print("LastRequestStartLine: " .. rest.last_request_start_line)
    print("LastRequestHeader: " .. rest.last_request_header)
end

print(sbResponse:get_as_string())
print("Success.")