Zig

Get Container ACL

See more Azure Cloud Storage Examples

Azure Storage Blob Service REST API: Sample code to get the permissions of a container. Zig

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

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

    // Azure Blob Service Example: Get Container ACL
    // See also: https://msdn.microsoft.com/en-us/library/azure/dd179469.aspx

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

    const rest = try chilkat.Rest.init();
    defer rest.deinit();

    // Connect to the Azure Storage Blob Service
    const b_tls = true;
    const port = 443;
    const b_auto_reconnect = true;
    // In this example, the storage account name is "chilkat".
    rest.connect("chilkat.blob.core.windows.net", port, b_tls, b_auto_reconnect) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // Provide Azure Cloud credentials for the REST call.
    const az_auth = try chilkat.AuthAzureStorage.init();
    defer az_auth.deinit();
    az_auth.setAccessKey("AZURE_ACCESS_KEY");
    // The account name used here should match the 1st part of the domain passed in the call to Connect (above).
    az_auth.setAccount("chilkat");
    az_auth.setScheme("SharedKey");
    az_auth.setService("Blob");
    // This causes the "x-ms-version: 2021-08-06" header to be automatically added.
    az_auth.setXMsVersion("2021-08-06");
    try rest.setAuthAzureStorage(az_auth);

    // Note: The application does not need to explicitly set the following
    // headers: x-ms-date, Authorization.  These headers
    // are automatically set by Chilkat.

    // The expected success response is a 200 response status code with an XML response body.
    // In this example, we are getting the ACL permissions of the container named "mycontainer".
    const response_str = rest.fullRequestNoBody(alloc, "GET", "/mycontainer?restype=container&comp=acl") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // When successful, the Azure Storage service will respond with a 200 response status code,
    // with an XML response body.

    if (rest.getResponseStatusCode() != 200) {
        // Examine the request/response to see what happened.
        std.debug.print("response status code = {d}\n", .{rest.getResponseStatusCode()});
        std.debug.print("response status text = {s}\n", .{try rest.getResponseStatusText(alloc)});
        std.debug.print("response header: {s}\n", .{try rest.getResponseHeader(alloc)});
        std.debug.print("response body (if any): {s}\n", .{response_str});
        std.debug.print("---\n", .{});
        std.debug.print("LastRequestStartLine: {s}\n", .{try rest.getLastRequestStartLine(alloc)});
        std.debug.print("LastRequestHeader: {s}\n", .{try rest.getLastRequestHeader(alloc)});
        return;
    }

    // Load the XML response for parsing.
    // An example of the response XML is shown below.
    const xml = try chilkat.Xml.init();
    defer xml.deinit();
    try xml.loadXml(response_str);

    std.debug.print("{s}\n", .{try xml.getXml(alloc)});

    // Use the ChilkatPath method to get various pieces of information out
    // of the XML.  For example:

    std.debug.print("Id = {s}\n", .{try xml.chilkatPath(alloc, "SignedIdentifier|Id|*")});
    const start_time_str = try xml.chilkatPath(alloc, "SignedIdentifier|AccessPolicy|Start|*");
    std.debug.print("Start Time = {s}\n", .{start_time_str});

    // The date/time string can be loaded into a CkDateTime object for
    // access to individual parts, or conversion to other formats.
    const date_time = try chilkat.DateTime.init();
    defer date_time.deinit();
    try date_time.setFromTimestamp(start_time_str);

    // For example..
    const b_local_time = true;
    const dt = try chilkat.DtObj.init();
    defer dt.deinit();
    date_time.toDtObj(b_local_time, dt);

    std.debug.print("{d}/{d}/{d}\n", .{ dt.getYear(), dt.getMonth(), dt.getDay() });

    // <?xml version="1.0" encoding="utf-8" ?>
    // <SignedIdentifiers>
    //     <SignedIdentifier>
    //         <Id>46KdrjGoh6bEJVbbLAKSVDLH3bBcjPKn</Id>
    //         <AccessPolicy>
    //             <Start>2016-05-04T22:10:49.0000000Z</Start>
    //             <Expiry>2017-05-04T22:10:49.0000000Z</Expiry>
    //             <Permission>rwd</Permission>
    //         </AccessPolicy>
    //     </SignedIdentifier>
    // </SignedIdentifiers>
}