Lua

REST File Streaming Upload

See more Azure Cloud Storage Examples

Demonstrates how to stream the REST body from a file. This example demonstrates a REST upload to the Azure Cloud Storage service. 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 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

-- Provide Azure Cloud credentials for the REST call.
local azAuth = chilkat.AuthAzureStorage.new()
azAuth.access_key = "AZURE_ACCESS_KEY"
-- The account name used here should match the 1st part of the domain passed in the call to Connect (above).
azAuth.account = "chilkat"
azAuth.scheme = "SharedKey"
azAuth.service = "Blob"
-- This causes the "x-ms-version: 2021-08-06" header to be automatically added.
azAuth.xms_version = "2021-08-06"
success = rest:set_auth_azure_storage(azAuth)

-- Set some request headers.
success = rest:add_header("x-ms-blob-content-disposition", "attachment; filename=\"hamlet.xml\"")
success = rest:add_header("x-ms-blob-type", "BlockBlob")
success = rest:add_header("x-ms-meta-m1", "v1")
success = rest:add_header("x-ms-meta-m2", "v2")

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

local fileStream = chilkat.Stream.new()
fileStream.source_file = "qa_data/xml/hamlet.xml"

-- Upload to the Azure Cloud Storage service.
-- The file is streamed, so the full file never has to completely reside in memory.
-- The file is uploaded to the container named "test".
local responseStr = rest:full_request_stream("PUT", "/test/hamlet.xml", fileStream)
if not rest.last_method_success then
    print(rest.last_error_text)
    return
end

-- When successful, the Azure Storage service will respond with a 201 response code,
-- with an empty body.  Therefore, in the success condition, the responseStr is empty.
if rest.response_status_code == 201 then
    print("File uploaded.")
else
    -- 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): " .. responseStr)
    print("---")
    print("LastRequestStartLine: " .. rest.last_request_start_line)
    print("LastRequestHeader: " .. rest.last_request_header)
end