(Node.js) S3 - Working with Buckets in a Region

Demonstrates how to work with S3 buckets located in a particular region.

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

var os = require('os');
if (os.platform() == 'win32') {  
  var chilkat = require('@chilkat/ck-node23-win64'); 
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node23-linux-arm');
    } else if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node23-linux-arm64');
    } else {
        var chilkat = require('@chilkat/ck-node23-linux-x64');
    }
} else if (os.platform() == 'darwin') {
  var chilkat = require('@chilkat/ck-node23-mac-universal');
}

function chilkatExample() {

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

    // When usig the REST class to access an S3 bucket that has been created in a particular region,
    // there are three important things to remember:
    // 
    // 1) Connect to the domain that includes the region.  For example, instead of connecting to
    //    "s3.amazonaws.com", connect to "s3.eu-central-1.amazonaws.com" if your bucket is in the EU Frankfurt region.
    //    See http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region   for a list of S3 region domains (endpoints)
    // 
    // 2) Set the AuthAws.Region property equal to the region, such as "eu-central-1".
    // 
    // 3) Include the region in request's Host header.
    // 

    // This example will upload to a bucket in the eu-central-1 region.
    // 
    var rest = new chilkat.Rest();

    // Connect to the Amazon AWS REST server.
    var bTls = true;
    var port = 443;
    var bAutoReconnect = true;
    var success = rest.Connect("s3.eu-central-1.amazonaws.com",port,bTls,bAutoReconnect);

    // 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";
    authAws.Region = "eu-central-1";
    success = rest.SetAuthAws(authAws);

    // Set the bucket name via the HOST header.
    // In this case, the bucket name is "chilkateufrankfurt" (which was created in the eu-central-1 region)
    rest.Host = "chilkateufrankfurt.s3.eu-central-1.amazonaws.com";

    var fileData = new chilkat.BinData();
    success = fileData.LoadFile("qa_data/jpg/starfish.jpg");

    // Upload the file to Amazon S3.
    var responseBody = new chilkat.StringBuilder();
    success = rest.FullRequestBd("PUT","/starfish.jpg",fileData,responseBody);
    if (success !== 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: " + responseBody.GetAsString());
        console.log("Status code: " + statusCode + ", Status text: " + rest.ResponseStatusText);
        return;
    }

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

}

chilkatExample();