Lua

Get Container Metadata

See more Azure Cloud Storage Examples

Azure Storage Blob Service REST API: Sample code to get the user-defined metadata of a container. Lua

local chilkat = require("chilkat")

-- Azure Blob Service Example: Get Container User-Defined Metadata
-- See also: https://msdn.microsoft.com/en-us/library/azure/ee691976.aspx

-- 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)

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

-- The expected success response is a 200 response status code with no response body.
-- In this example, we are getting the metadata of the container named "mycontainer".
local responseStr = rest:full_request_no_body("GET", "/mycontainer?restype=container&comp=metadata")
if not rest.last_method_success then
    print(rest.last_error_text)
    return
end

-- When successful, the Azure Storage service will respond with a 200 response status code,
-- with no response 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 (if any): " .. responseStr)
    print("---")
    print("LastRequestStartLine: " .. rest.last_request_start_line)
    print("LastRequestHeader: " .. rest.last_request_header)
    return
end

-- The user-defined metadata is located in the response header.
-- The full response header can be obtained like this:
print("response header: " .. rest.response_header)
print("--")

-- Metadata headers begin with "x-ms-meta-"
-- Individual response header fields can be retrieved like this:
print("x-ms-meta-Category: " .. rest:response_hdr_by_name("x-ms-meta-Category"))
print("x-ms-meta-Resolution: " .. rest:response_hdr_by_name("x-ms-meta-Resolution"))

print("Success.")