Lua

Create S3 Bucket in a Region

See more Amazon S3 Examples

Demonstrates how to create an S3 bucket in a specified region. This example will create a bucket in the eu-west-2 region. 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.
local bTls = true
local port = 443
local bAutoReconnect = true
local success = rest:connect("s3.amazonaws.com", port, bTls, bAutoReconnect)

-- Provide AWS credentials for the REST call.
local authAws = chilkat.AuthAws.new()
authAws.access_key = "AWS_ACCESS_KEY"
authAws.secret_key = "AWS_SECRET_KEY"
authAws.service_name = "s3"
success = rest:set_auth_aws(authAws)

-- We'll send a PUT request having an XML body such as this:
-- <CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
--   <LocationConstraint>BucketRegion</LocationConstraint>
--   </CreateBucketConfiguration>

-- Create the XML body specifying the region as "eu-west-2"
local bucketRegion = "eu-west-2"
local sbBucketRegion = chilkat.StringBuilder.new()
sbBucketRegion:append(bucketRegion)

-- We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
local xml = chilkat.Xml.new()
if not sbBucketRegion:contents_equal("us-east-1", true) then
    xml.tag = "CreateBucketConfiguration"
    xml:add_attribute("xmlns", "http://s3.amazonaws.com/doc/2006-03-01/")
    xml:update_child_content("LocationConstraint", "eu-west-2")
end

-- --------------------------------------------------------------
-- IMPORTANT: To create a bucket in the default us-east-1 region,
-- do not add the LocationConstraint.  Adding a LocationConstraint of "us-east-1"
-- causes an error "The specified location-constraint is not valid."
-- By default, the bucket is created in us-east-1 by sending a PUT with an empty body.
-- --------------------------------------------------------------

-- Set the bucket name via the HOST header.
-- In this case, the bucket name is "chilkateuwest2".
rest.host = "chilkateuwest2.s3.amazonaws.com"

-- Make the call to create the bucket.
local responseStr = ""
if not sbBucketRegion:contents_equal("us-east-1", true) then
    responseStr = rest:full_request_string("PUT", "/", xml:get_xml())
else
    -- If the bucket is to be created in the us-east-1 region (the default region)
    -- just send a PUT with no body.
    responseStr = rest:full_request_no_body("PUT", "/")
end

if not rest.last_method_success then
    print(rest.last_error_text)
    return
end

if rest.response_status_code ~= 200 then
    print("status code = " .. rest.response_status_code)
    local responseXml = chilkat.Xml.new()
    responseXml:load_xml(responseStr)
    print(responseXml:get_xml())
    print("Failed.")
    return
end

print("Bucket in the eu-west-2 region created.")