(Node.js) Glacier Download Archive

Demonstrates how to download an Amazon Glacier archive. Downloading a Glacier archive is a two step process. First an archive retrieval job is initiated. After it completes, the job output is downloaded (i.e. the archive contents are downloaded.)

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 Retrieve Job Output Reference Documentation
    // 
    rest.AddHeader("x-amz-glacier-version","2012-06-01");

    // To download an archive, we'll make several method calls:
    // 1) Send the HTTPS GET request.
    // 2) Get the response body.
    // 3) If the response status code indicates success, stream the response body (i.e the archive data) to a file.
    // 4) If the response status code indicates an error, get the JSON error response.

    // Send the GET request.
    success = rest.SendReqNoBody("GET","/AWS_ACCOUNT_ID/vaults/chilkat/jobs/JOB_ID/output");
    if (success !== true) {
        console.log(rest.LastErrorText);
        return;
    }

    // Read the response header.
    var responseStatusCode = rest.ReadResponseHeader();
    if (responseStatusCode < 0) {
        console.log(rest.LastErrorText);
        return;
    }

    console.log("Response status code = " + responseStatusCode);

    // We expect a 200 response status if the archive data is coming.
    // Otherwise, we'll get a JSON response body with an error message(or no response body).
    if (responseStatusCode == 200) {

        var bodyStream = new chilkat.Stream();

        // The stream's sink will be a file.
        bodyStream.SinkFile = "qa_output/archiveData.dat";

        // Read the response body to the stream.
        success = rest.ReadRespBodyStream(bodyStream,true);
        if (success !== true) {
            console.log(rest.LastErrorText);
            return;
        }

        console.log("Successfully received the archive file.");

    }
    else {
        var jsonError = rest.ReadRespBodyString();
        if (rest.LastMethodSuccess !== true) {
            console.log(rest.LastErrorText);
        }
        else {
            console.log(jsonError);
        }

    }


}

chilkatExample();