Rust

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. Rust

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

let http = chilkat::Http::new();

// Insert your AWS keys here:
http.set_aws_access_key("AWS_ACCESS_KEY");
http.set_aws_secret_key("AWS_SECRET_KEY");

let bucket_name = "chilkat.ocean".to_string();
let object_name = "seahorse.jpg".to_string();
let local_file_path = "qa_data/jpg/seahorse.jpg".to_string();
let content_type = "image/jpg".to_string();

// 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.set_request_header("x-amz-meta-genus", "Hippocampus");

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

if http.s3_upload_file(&local_file_path, &content_type, &bucket_name, &object_name).is_err() {
    println!("{}", http.last_error_text());
} else {
    println!("File uploaded.");
}