Lua

Use an Azure Service SAS

See more Azure Cloud Storage Examples

Shows how to use an Azure Service SAS. (In this case, it is an SAS for a blob.) Lua

local chilkat = require("chilkat")

-- Azure Blob Service Example: Upload binary bytes to a block blob.
-- This uses a Service SAS for Authorization.

-- 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 Azure Storage Blob Service
local bTls = true
local port = 443
local bAutoReconnect = true
-- In this example, the storage account name is "chilkat".
local success = rest:connect("chilkat.blob.core.windows.net", port, bTls, bAutoReconnect)
if not success then
    print(rest.last_error_text)
    return
end

-- ----------------------------------------------------------------------------------------------
-- The code above this comment could be placed inside a function/subroutine within the application
-- because the connection does not need to be made for every request.  Once the connection is made
-- the app may send many requests..
-- ----------------------------------------------------------------------------------------------

-- Note: The application does not need to explicitly set the following
-- headers: Content-Length, x-ms-date, Authorization.  These headers
-- are automatically set by Chilkat.

-- Let's load a previously computed Azure Storage Account SAS token and use it.
-- See How to Create an Azure Service SAS
local sbToken = chilkat.StringBuilder.new()
success = sbToken:load_file("qa_data/tokens/azureStorageServiceSas.txt", "utf-8")
if not success then
    print("Failed to load SAS token.")
    return
end

-- Add the Shared Access Signature query params for authorization.
rest:add_query_params(sbToken:get_as_string())

-- IMPORTANT: Make sure to set the x-ms-blob-type header:
success = rest:add_header("x-ms-blob-type", "BlockBlob")

-- IMPORTANT: Make sure to add the x-ms-date header.
-- When the header name is "x-ms-date", Chilkat will recognize the keyword "NOW"
-- and will substitute the current system date/time formatted as required by Microsoft.
success = rest:add_header("x-ms-date", "NOW")

-- For this example, we'll just load a JPG file into memory..
local binData = chilkat.BinData.new()
success = binData:load_file("qa_data/jpg/starfish.jpg")
if not success then
    print("Failed to load JPG file.")
    return
end

-- Note: The maximum size of a block blob created by uploading in a single step is 64MB.
-- For larger files, the upload must be broken up into blocks.  There is another Chilkat example for that..
local sbResponse = chilkat.StringBuilder.new()
success = rest:full_request_bd("PUT", "/mycontainer/starfish.jpg", binData, sbResponse)
if not success then
    print(rest.last_error_text)
    return
end

-- When successful, the Azure Storage service will respond with a 201 response status code,
-- with no response body.
if rest.response_status_code ~= 201 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 (if any): " .. sbResponse:get_as_string())
    print("---")
    print("LastRequestStartLine: " .. rest.last_request_start_line)
    print("LastRequestHeader: " .. rest.last_request_header)
    print("Failed.")
    return
end

print("Success.")