Zig

Backblaze S3 List Bucket Objects

See more Backblaze S3 Examples

Demonstrates how to list the objects in a bucket.

The Chilkat S3 functions in the HTTP class are compatible with the Backblaze service. However, because of some specific issues, Chilkat v9.5.0.89 or later is needed.

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();

    // keyID = Access Key ID or Access Key
    http.setAwsAccessKey("access-key");

    // applicationKey = Secret Access Key or Secret Key
    http.setAwsSecretKey("secret-key");

    // Region is the 2nd part of your S3 Endpoint
    http.setAwsEndpoint("s3.us-west-002.backblazeb2.com");

    const bucket_name = "chilkat-test";

    const str_xml = http.s3ListBucketObjects(alloc, bucket_name) 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", .{});

    // Use this online tool to generate parsing code from sample XML:
    // Generate Parsing Code from XML

    // <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    // <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    //     <Contents>
    //         <ETag>"303fb46cf341094fef6274b7789cd6aa"</ETag>
    //         <Key>orchard.json</Key>
    //         <LastModified>2021-10-30T14:45:52.000Z</LastModified>
    //         <Owner>
    //             <ID>f2ebbc5f792c</ID>
    //             <DisplayName/>
    //         </Owner>
    //         <Size>22</Size>
    //         <StorageClass>STANDARD</StorageClass>
    //     </Contents>
    //     <Contents>
    //         <ETag>"a8551f0a5437f43a796fca7623ee9232"</ETag>
    //         <Key>seahorse.jpg</Key>
    //         <LastModified>2021-10-30T14:38:53.000Z</LastModified>
    //         <Owner>
    //             <ID>f2ebbc5f792c</ID>
    //             <DisplayName/>
    //         </Owner>
    //         <Size>24388</Size>
    //         <StorageClass>STANDARD</StorageClass>
    //     </Contents>
    //     <IsTruncated>false</IsTruncated>
    //     <MaxKeys>1000</MaxKeys>
    //     <Name>chilkat-test</Name>
    //     <Prefix/>
    //     <Marker/>
    // </ListBucketResult>

    var e_tag: [:0]const u8 = "";
    var key: [:0]const u8 = "";
    var last_modified: [:0]const u8 = "";
    var id: [:0]const u8 = "";
    var size_decimal_str: [:0]const u8 = "";
    var storage_class: [:0]const u8 = "";

    _ = try xml.getAttrValue(alloc, "xmlns");
    var i: i32 = 0;
    const count_i = xml.numChildrenHavingTag("Contents");
    while (i < count_i) {
        xml.setI(i);
        e_tag = try xml.getChildContent(alloc, "Contents[i]|ETag");
        key = try xml.getChildContent(alloc, "Contents[i]|Key");
        last_modified = try xml.getChildContent(alloc, "Contents[i]|LastModified");
        id = try xml.getChildContent(alloc, "Contents[i]|Owner|ID");
        size_decimal_str = try xml.getChildContent(alloc, "Contents[i]|Size");
        storage_class = try xml.getChildContent(alloc, "Contents[i]|StorageClass");
        i = i + 1;
    }

    _ = try xml.getChildContent(alloc, "IsTruncated");
    _ = xml.getChildIntValue("MaxKeys");
    _ = try xml.getChildContent(alloc, "Name");
}