Zig

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

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    var success: bool = false;

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

    const http = try chilkat.Http.init();
    defer http.deinit();

    // Insert your AWS keys here:
    http.setAwsAccessKey("AWS_ACCESS_KEY");
    http.setAwsSecretKey("AWS_SECRET_KEY");

    const bucket_name = "chilkat.ocean";
    const object_name = "seahorse.jpg";
    const local_file_path = "qa_data/jpg/seahorse.jpg";
    const content_type = "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 = if (http.s3UploadFile(local_file_path, content_type, bucket_name, object_name)) true else |_| false;
    if (!success) {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
    } else {
        std.debug.print("File uploaded.\n", .{});
    }
}