Zig

S3 Get Bucket Objects with CommonPrefixes

See more Amazon S3 Examples

Demonstrates how to get a list of bucket objects using the prefix and delimiter query params to get an XML result with CommonPrefixes. Zig

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

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

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

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

    // Insert your access key here:
    http.setAwsAccessKey("AWS_ACCESS_KEY");

    // Insert your secret key here:
    http.setAwsSecretKey("AWS_SECRET_KEY");

    // In this example, my bucket is "chilkat100".
    // It contains a number of folders, one of which is named "images".
    // I want to get a list of all sub-folders under the "images" folder
    const str_xml = http.s3ListBucketObjects(alloc, "chilkat100?prefix=images/&delimiter=/") catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Response status code = {d}\n", .{http.getLastStatus()});

    const xml = try chilkat.Xml.init();
    defer xml.deinit();
    xml.loadXml(str_xml) catch {
        std.debug.print("{s}\n", .{try xml.getLastErrorText(alloc)});
        return;
    };

    // If the response status code was not 200, then the XML response is not a
    // listing of objects, but instead contains error information.
    if (http.getLastStatus() != 200) {
        std.debug.print("{s}\n", .{try xml.getXml(alloc)});
        std.debug.print("Failed.\n", .{});
        return;
    }

    // A sample response is shown below.
    std.debug.print("{s}\n", .{try xml.getXml(alloc)});
    std.debug.print("----\n", .{});

    // Here is the list of sub-folders (i.e. CommonPrefixes)

    // <?xml version="1.0" encoding="UTF-8"?>
    // <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    //     <Name>chilkat100</Name>
    //     <Prefix>images/</Prefix>
    //     <Marker/>
    //     <MaxKeys>1000</MaxKeys>
    //     <Delimiter>/</Delimiter>
    //     <IsTruncated>false</IsTruncated>
    //     <CommonPrefixes>
    //         <Prefix>images/africa/</Prefix>
    //     </CommonPrefixes>
    //     <CommonPrefixes>
    //         <Prefix>images/sea_creatures/</Prefix>
    //     </CommonPrefixes>
    // </ListBucketResult>

    var prefix: [:0]const u8 = "";

    // The XML can be parsed like this:
    var i: i32 = 0;
    const count_i = xml.numChildrenHavingTag("CommonPrefixes");
    while (i < count_i) {
        xml.setI(i);
        prefix = try xml.getChildContent(alloc, "CommonPrefixes[i]|Prefix");
        std.debug.print("Prefix = {s}\n", .{prefix});
        i = i + 1;
    }
}