(PureBasic) S3 List Bucket Objects (using Chilkat REST)

Demonstrates how to fetch a list of objects in an S3 bucket.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkXml.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkAuthAws.pb"
IncludeFile "CkRest.pb"

Procedure ChilkatExample()

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

    rest.i = CkRest::ckCreate()
    If rest.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Connect to the Amazon AWS REST server.
    bTls.i = 1
    port.i = 443
    bAutoReconnect.i = 1
    success.i = CkRest::ckConnect(rest,"s3.amazonaws.com",port,bTls,bAutoReconnect)

    ; ----------------------------------------------------------------------------
    ; Important: For buckets created in regions outside us-east-1,
    ; there are three important changes that need to be made.
    ; See Working with S3 Buckets in Non-us-east-1 Regions for the details.
    ; ----------------------------------------------------------------------------

    ; Provide AWS credentials for the REST call.
    authAws.i = CkAuthAws::ckCreate()
    If authAws.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkAuthAws::setCkAccessKey(authAws, "AWS_ACCESS_KEY")
    CkAuthAws::setCkSecretKey(authAws, "AWS_SECRET_KEY")
    CkAuthAws::setCkServiceName(authAws, "s3")
    success = CkRest::ckSetAuthAws(rest,authAws)

    ;  Set the bucket name via the HOST header.
    ;  In this case, the bucket name is "chilkat100".
    CkRest::setCkHost(rest, "chilkat100.s3.amazonaws.com")

    sbResponse.i = CkStringBuilder::ckCreate()
    If sbResponse.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkRest::ckFullRequestNoBodySb(rest,"GET","/",sbResponse)
    If success <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkRest::ckDispose(rest)
        CkAuthAws::ckDispose(authAws)
        CkStringBuilder::ckDispose(sbResponse)
        ProcedureReturn
    EndIf

    statusCode.i = CkRest::ckResponseStatusCode(rest)
    Debug "Response status code = " + Str(statusCode)

    xml.i = CkXml::ckCreate()
    If xml.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkXml::ckLoadSb(xml,sbResponse,1)
    Debug CkXml::ckGetXml(xml)

    If statusCode <> 200
        Debug "Failed.  See error information in the XML."
        CkRest::ckDispose(rest)
        CkAuthAws::ckDispose(authAws)
        CkStringBuilder::ckDispose(sbResponse)
        CkXml::ckDispose(xml)
        ProcedureReturn
    EndIf

    ; Use this online tool to generate code from sample XML: 
    ; Generate Code to Create XML

    Key.s
    LastModified.s
    ETag.s
    SizeDecimalStr.s
    ID.s
    DisplayName.s
    StorageClass.s

    Name.s = CkXml::ckGetChildContent(xml,"Name")
    MaxKeys.i = CkXml::ckGetChildIntValue(xml,"MaxKeys")
    IsTruncated.s = CkXml::ckGetChildContent(xml,"IsTruncated")
    i.i = 0
    count_i.i = CkXml::ckNumChildrenHavingTag(xml,"Contents")
    While i < count_i
        CkXml::setCkI(xml, i)
        Key = CkXml::ckGetChildContent(xml,"Contents[i]|Key")
        LastModified = CkXml::ckGetChildContent(xml,"Contents[i]|LastModified")
        ETag = CkXml::ckGetChildContent(xml,"Contents[i]|ETag")
        SizeDecimalStr = CkXml::ckGetChildContent(xml,"Contents[i]|Size")
        ID = CkXml::ckGetChildContent(xml,"Contents[i]|Owner|ID")
        DisplayName = CkXml::ckGetChildContent(xml,"Contents[i]|Owner|DisplayName")
        StorageClass = CkXml::ckGetChildContent(xml,"Contents[i]|StorageClass")
        i = i + 1
    Wend


    CkRest::ckDispose(rest)
    CkAuthAws::ckDispose(authAws)
    CkStringBuilder::ckDispose(sbResponse)
    CkXml::ckDispose(xml)


    ProcedureReturn
EndProcedure