(Node.js) S3 Upload String using AWS Signature Version 2

Example to upload the contents of a string to the Amazon S3 service, using the older AWS Signature Version 2.

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

    // Demonstrates how to use older AWS S3 Signature Version 2 for uploading the contents
    // of a string variable to an object in a bucket.

    // 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.
    var bTls = true;
    var port = 443;
    var bAutoReconnect = true;
    // The file is uploaded to the bucket named "chilkat100", which becomes part of the domain:
    var success = rest.Connect("chilkat100.s3.amazonaws.com",port,bTls,bAutoReconnect);

    // ----------------------------------------------------------------------------
    // Important: For buckets created in regions outside us-east-1,
    // there are three important changes that need to be made.
    // See Working with S3 Buckets in Non-us-east-1 Regions for the details.
    // ----------------------------------------------------------------------------

    // Provide AWS credentials for the REST call.
    var authAws = new chilkat.AuthAws();
    authAws.AccessKey = "AWS_ACCESS_KEY";
    authAws.SecretKey = "AWS_SECRET_KEY";
    authAws.ServiceName = "s3";

    // For AWS Signature Version 2, the following two properties need to be set:
    authAws.SignatureVersion = 2;
    // See http://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html#ConstructingTheCanonicalizedResourceElement
    // The bucket is "chilkat100", and the uriPath is "/hamlet_play.xml", which must match
    // the URI path passed to the FullRequestString method below.
    authAws.CanonicalizedResourceV2 = "/chilkat100/hamlet_play.xml";

    success = rest.SetAuthAws(authAws);

    // Load a text file into memory.
    var fac = new chilkat.FileAccess();
    var fileContents = fac.ReadEntireTextFile("qa_data/xml/hamlet.xml","utf-8");
    if (fac.LastMethodSuccess !== true) {
        console.log(fac.LastErrorText);
        return;
    }

    // To send the file in gzip or deflate compressed format, set the Content-Encoding request
    // header to "gzip" or "deflate".  (this is optional)
    success = rest.AddHeader("Content-Encoding","gzip");

    // Indicate the Content-Type of our upload.  (This is optional)
    success = rest.AddHeader("Content-Type","text/xml");

    // We can add an "Expect: 100-continue" header so that if the request is rejected
    // by the server immediately after receiving the request header, it can respond
    // and the client (Chilkat) can avoid sending the file data.
    // (this is optional)
    success = rest.AddHeader("Expect","100-continue");

    // Upload the file to Amazon S3.
    var responseBodyStr = rest.FullRequestString("PUT","/hamlet_play.xml",fileContents);
    if (rest.LastMethodSuccess !== true) {
        console.log(rest.LastErrorText);
        return;
    }

    // Did we get a 200 response indicating success?
    var statusCode = rest.ResponseStatusCode;
    if (statusCode !== 200) {
        console.log("Error response: " + responseBodyStr);
        console.log("Status code: " + statusCode + ", Status text: " + rest.ResponseStatusText);
        return;
    }

    console.log("File successfully uploaded.");

}

chilkatExample();