(Node.js) Glacier Upload Archive

Demonstrates how to add an archive to a vault. For a successful upload, your data is durably persisted. In response, Amazon S3 Glacier (Glacier) returns the archive ID in the x-amz-archive-id header of the response. You should save the archive ID returned so that you can access the archive later.

Note: This example requires Chilkat v9.5.0.78 or greater.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

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

    var rest = new chilkat.Rest();

    // Connect to the Amazon AWS REST server in the desired region.
    var bTls = true;
    var port = 443;
    var bAutoReconnect = true;
    var success = rest.Connect("glacier.us-west-2.amazonaws.com",port,bTls,bAutoReconnect);

    // Provide AWS credentials.
    var authAws = new chilkat.AuthAws();
    authAws.AccessKey = "AWS_ACCESS_KEY";
    authAws.SecretKey = "AWS_SECRET_KEY";
    authAws.ServiceName = "glacier";
    authAws.Region = "us-west-2";

    success = rest.SetAuthAws(authAws);

    // --------------------------------------------------------------------------
    // Note: The above REST connection and setup of the AWS credentials
    // can be done once.  After connecting, any number of REST calls can be made.
    // The "auto reconnect" property passed to rest.Connect indicates that if
    // the connection is lost, a REST method call will automatically reconnect
    // if needed.
    // --------------------------------------------------------------------------

    // 
    // For more information, see Glacier Upload Archive Reference Documentation
    // 
    rest.AddHeader("x-amz-glacier-version","2012-06-01");

    // We'll need to pre-compute the SHA256 tree hash and the SHA256 linear hash.
    // The hashes are added in the following request headers:

    // x-amz-sha256-tree-hash: SHA256 tree hash
    // x-amz-content-sha256: SHA256 linear hash

    // The file we'll be uploading
    var filePath = "qa_data/zips/somethingBig.zip";

    var crypt = new chilkat.Crypt2();
    crypt.HashAlgorithm = "sha256-tree-hash";
    crypt.EncodingMode = "hexlower";
    var treeHashHex = crypt.HashFileENC(filePath);
    rest.AddHeader("x-amz-sha256-tree-hash",treeHashHex);

    crypt.HashAlgorithm = "sha256";
    var linearHashHex = crypt.HashFileENC(filePath);
    authAws.PrecomputedSha256 = linearHashHex;

    // We can optionally add a description
    // In this case, we'll set the description equal to the local filepath of the file we're uploading.
    rest.AddHeader("x-amz-archive-description",filePath);

    // Upload the file to the vault named "chilkat"
    var fileStream = new chilkat.Stream();
    fileStream.SourceFile = filePath;

    // May need to increase the timeout if this is a really large file..
    rest.IdleTimeoutMs = 120000;

    //  Add an Expect: 100-continue request header
    rest.AddHeader("Expect","100-continue");

    var responseStr = rest.FullRequestStream("POST","/AWS_ACCOUNT_ID/vaults/chilkat/archives",fileStream);
    if (rest.LastMethodSuccess !== true) {
        console.log(rest.LastErrorText);
        return;
    }

    var respStatusCode = rest.ResponseStatusCode;
    if (respStatusCode >= 400) {
        console.log("Response Status Code = " + respStatusCode);
        console.log("Response Header:");
        console.log(rest.ResponseHeader);
        console.log("Response Body:");
        console.log(responseStr);
        return;
    }

    // Success is indicated by a 201 response status with an empty response body.
    console.log("response status code = " + respStatusCode);

    // If successful, the response header looks like this.
    // The Location and x-amz-archive-id are two items of information we may wish to save..

    // HTTP/1.1 201 Created
    // x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
    // Date: Wed, 10 Feb 2017 12:00:00 GMT
    // x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
    // Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTH ... GlqrEXAMPLEArchiveId
    // x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsu ... BfGlqrEXAMPLEArchiveId
    // 

    var archiveId = rest.ResponseHdrByName("x-amz-archive-id");
    console.log("x-amz-archive-id = " + archiveId);

    var location = rest.ResponseHdrByName("Location");
    console.log("Location = " + location);

}

chilkatExample();