(JavaScript) Upload File with User-Defined Metadata

Demonstrates how to upload a file with user-defined metadata to the Amazon S3 service.

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

var success = false;

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

var http = new CkHttp();

// Insert your AWS keys here:
http.AwsAccessKey = "AWS_ACCESS_KEY";
http.AwsSecretKey = "AWS_SECRET_KEY";

var bucketName = "chilkat.ocean";
var objectName = "seahorse.jpg";
var localFilePath = "qa_data/jpg/seahorse.jpg";
var contentType = "image/jpg";

// User-defined metadata are name/value pairs, and are added to the HTTP request header.
// Header names must begin with "x-amz-meta-" to distinguish them from other HTTP headers.
// Note that Amazon S3 stores user-defined metadata keys in lowercase.

// For example, to add genus=Hippocampus, we do this:
http.SetRequestHeader("x-amz-meta-genus","Hippocampus");

// Add a few more user-metadata key pairs.
http.SetRequestHeader("x-amz-meta-species","big-belly seahorse");
http.SetRequestHeader("x-amz-meta-habitat","shallow tropical and temperate waters");

success = http.S3_UploadFile(localFilePath,contentType,bucketName,objectName);

if (success !== true) {
    console.log(http.LastErrorText);
}
else {
    console.log("File uploaded.");
}