Rust

Upload using Azure Storage Account Shared Access Signature (SAS) Authorization

See more Azure Cloud Storage Examples

Sample code to upload binary bytes to a block blob in Azure Cloud Storage using an Azure Storage Account Shared Access Signature (SAS) Authorization. This creates a 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..

Note: This example requires Chilkat v9.5.0.65 or later.

Rust

// Note: This example requires Chilkat v9.5.0.65 or greater.

// Azure Blob Service Example: Upload binary bytes to a block blob.
// This uses a Shared Access Signature (SAS) for Authorization.
// 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.

let rest = chilkat::Rest::new();

// Connect to the Azure Storage Blob Service
let b_tls = true;
let port = 443;
let b_auto_reconnect = true;
// In this example, the storage account name is "chilkat".
if rest.connect("chilkat.blob.core.windows.net", port, b_tls, b_auto_reconnect).is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// ----------------------------------------------------------------------------------------------
// 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 Storage Account Shared Access Signature
let sb_token = chilkat::StringBuilder::new();
if sb_token.load_file("qa_data/tokens/azureStorageAccountSas.txt", "utf-8").is_err() {
    println!("Failed to load SAS token.");
    return;
}

// Add the Shared Access Signature query params for authorization.
let _ = rest.add_query_params(&sb_token.get_as_string().unwrap_or_default());

// IMPORTANT: Make sure to set the x-ms-blob-type header:
let _ = rest.add_header("x-ms-blob-type", "BlockBlob").is_ok();

// 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.
let _ = rest.add_header("x-ms-date", "NOW").is_ok();

// For this example, we'll just load a JPG file into memory..
let bin_data = chilkat::BinData::new();
if bin_data.load_file("qa_data/jpg/starfish.jpg").is_err() {
    println!("Failed to load JPG file.");
    return;
}

// 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..
let sb_response = chilkat::StringBuilder::new();
if rest.full_request_bd("PUT", "/mycontainer/starfish.jpg", &bin_data, &sb_response).is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// When successful, the Azure Storage service will respond with a 201 response status code,
// with no response body.
if rest.response_status_code() != 201 {
    // Examine the request/response to see what happened.
    println!("response status code = {}", rest.response_status_code());
    println!("response status text = {}", rest.response_status_text());
    println!("response header: {}", rest.response_header());
    println!("response body (if any): {}", sb_response.get_as_string().unwrap_or_default());
    println!("---");
    println!("LastRequestStartLine: {}", rest.last_request_start_line());
    println!("LastRequestHeader: {}", rest.last_request_header());
    println!("Failed.");
    return;
}

println!("Success.");