C++

Upload File with User-Defined Metadata

See more Amazon S3 Examples

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

#include <CkHttp.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkHttp http;

    // Insert your AWS keys here:
    http.put_AwsAccessKey("AWS_ACCESS_KEY");
    http.put_AwsSecretKey("AWS_SECRET_KEY");

    const char *bucketName = "chilkat.ocean";
    const char *objectName = "seahorse.jpg";
    const char *localFilePath = "qa_data/jpg/seahorse.jpg";
    const char *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) {
        std::cout << http.lastErrorText() << "\r\n";
    }
    else {
        std::cout << "File uploaded." << "\r\n";
    }
    }