(Tcl) Azure Storage: Upload Contents of String Variable to Block Blob

Sample code to upload the contents of a string variable to a block blob in Azure Cloud Storage. This creates the block blob, or replaces an existing block blob.

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

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

# Azure Blob Service Example: Upload the contents of a string variable to a block blob.
# This creates a new block blob or replaces an existing one in its entirety.
# See also: https://msdn.microsoft.com/en-us/library/azure/dd179451.aspx

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

set rest [new_CkRest]

# Connect to the Azure Storage Blob Service
set bTls 1
set port 443
set bAutoReconnect 1
# In this example, the storage account name is "chilkat".
set success [CkRest_Connect $rest "chilkat.blob.core.windows.net" $port $bTls $bAutoReconnect]
if {$success != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    exit
}

# Provide Azure Cloud credentials for the REST call.
set azAuth [new_CkAuthAzureStorage]

CkAuthAzureStorage_put_AccessKey $azAuth "AZURE_ACCESS_KEY"
# The account name used here should match the 1st part of the domain passed in the call to Connect (above).
CkAuthAzureStorage_put_Account $azAuth "chilkat"
CkAuthAzureStorage_put_Scheme $azAuth "SharedKey"
CkAuthAzureStorage_put_Service $azAuth "Blob"
# This causes the "x-ms-version: 2020-08-04" header to be automatically added.
CkAuthAzureStorage_put_XMsVersion $azAuth "2020-08-04"
set success [CkRest_SetAuthAzureStorage $rest $azAuth]

# 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.

# IMPORTANT: Make sure to set the x-ms-blob-type header:
set success [CkRest_AddHeader $rest "x-ms-blob-type" "BlockBlob"]

# After uploading, the block blob named helloWorld.txt (in the container named "mycontainer")
# will contain the following string:
set blobContents "Hello World!"

# 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..
set responseStr [CkRest_fullRequestString $rest "PUT" "/mycontainer/helloWorld.txt" $blobContents]
if {[CkRest_get_LastMethodSuccess $rest] != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkAuthAzureStorage $azAuth
    exit
}

# When successful, the Azure Storage service will respond with a 201 response status code,
# with no response body.

if {[CkRest_get_ResponseStatusCode $rest] != 201} then {
    # Examine the request/response to see what happened.
    puts "response status code = [CkRest_get_ResponseStatusCode $rest]"
    puts "response status text = [CkRest_responseStatusText $rest]"
    puts "response header: [CkRest_responseHeader $rest]"
    puts "response body (if any): $responseStr"
    puts "---"
    puts "LastRequestStartLine: [CkRest_lastRequestStartLine $rest]"
    puts "LastRequestHeader: [CkRest_lastRequestHeader $rest]"
    delete_CkRest $rest
    delete_CkAuthAzureStorage $azAuth
    exit
}

puts "Success."

delete_CkRest $rest
delete_CkAuthAzureStorage $azAuth