(DataFlex) Glacier Upload Archive

Demonstrates how to add an archive to a vault. For a successful upload, your data is durably persisted. In response, Amazon S3 Glacier (Glacier) returns the archive ID in the x-amz-archive-id header of the response. You should save the archive ID returned so that you can access the archive later.

Note: This example requires Chilkat v9.5.0.78 or greater.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoRest
    Boolean iBTls
    Integer iPort
    Boolean iBAutoReconnect
    Boolean iSuccess
    Variant vAuthAws
    Handle hoAuthAws
    String sFilePath
    Handle hoCrypt
    String sTreeHashHex
    String sLinearHashHex
    Variant vFileStream
    Handle hoFileStream
    String sResponseStr
    Integer iRespStatusCode
    String sArchiveId
    String sLocation
    String sTemp1
    Boolean bTemp1

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

    Get Create (RefClass(cComChilkatRest)) To hoRest
    If (Not(IsComObjectCreated(hoRest))) Begin
        Send CreateComObject of hoRest
    End

    // Connect to the Amazon AWS REST server in the desired region.
    Move True To iBTls
    Move 443 To iPort
    Move True To iBAutoReconnect
    Get ComConnect Of hoRest "glacier.us-west-2.amazonaws.com" iPort iBTls iBAutoReconnect To iSuccess

    // Provide AWS credentials.
    Get Create (RefClass(cComChilkatAuthAws)) To hoAuthAws
    If (Not(IsComObjectCreated(hoAuthAws))) Begin
        Send CreateComObject of hoAuthAws
    End
    Set ComAccessKey Of hoAuthAws To "AWS_ACCESS_KEY"
    Set ComSecretKey Of hoAuthAws To "AWS_SECRET_KEY"
    Set ComServiceName Of hoAuthAws To "glacier"
    Set ComRegion Of hoAuthAws To "us-west-2"

    Get pvComObject of hoAuthAws to vAuthAws
    Get ComSetAuthAws Of hoRest vAuthAws To iSuccess

    // --------------------------------------------------------------------------
    // Note: The above REST connection and setup of the AWS credentials
    // can be done once.  After connecting, any number of REST calls can be made.
    // The "auto reconnect" property passed to rest.Connect indicates that if
    // the connection is lost, a REST method call will automatically reconnect
    // if needed.
    // --------------------------------------------------------------------------

    // 
    // For more information, see Glacier Upload Archive Reference Documentation
    // 
    Get ComAddHeader Of hoRest "x-amz-glacier-version" "2012-06-01" To iSuccess

    // We'll need to pre-compute the SHA256 tree hash and the SHA256 linear hash.
    // The hashes are added in the following request headers:

    // x-amz-sha256-tree-hash: SHA256 tree hash
    // x-amz-content-sha256: SHA256 linear hash

    // The file we'll be uploading
    Move "qa_data/zips/somethingBig.zip" To sFilePath

    Get Create (RefClass(cComChilkatCrypt2)) To hoCrypt
    If (Not(IsComObjectCreated(hoCrypt))) Begin
        Send CreateComObject of hoCrypt
    End
    Set ComHashAlgorithm Of hoCrypt To "sha256-tree-hash"
    Set ComEncodingMode Of hoCrypt To "hexlower"
    Get ComHashFileENC Of hoCrypt sFilePath To sTreeHashHex
    Get ComAddHeader Of hoRest "x-amz-sha256-tree-hash" sTreeHashHex To iSuccess

    Set ComHashAlgorithm Of hoCrypt To "sha256"
    Get ComHashFileENC Of hoCrypt sFilePath To sLinearHashHex
    Set ComPrecomputedSha256 Of hoAuthAws To sLinearHashHex

    // We can optionally add a description
    // In this case, we'll set the description equal to the local filepath of the file we're uploading.
    Get ComAddHeader Of hoRest "x-amz-archive-description" sFilePath To iSuccess

    // Upload the file to the vault named "chilkat"
    Get Create (RefClass(cComChilkatStream)) To hoFileStream
    If (Not(IsComObjectCreated(hoFileStream))) Begin
        Send CreateComObject of hoFileStream
    End
    Set ComSourceFile Of hoFileStream To sFilePath

    // May need to increase the timeout if this is a really large file..
    Set ComIdleTimeoutMs Of hoRest To 120000

    //  Add an Expect: 100-continue request header
    Get ComAddHeader Of hoRest "Expect" "100-continue" To iSuccess

    Get pvComObject of hoFileStream to vFileStream
    Get ComFullRequestStream Of hoRest "POST" "/AWS_ACCOUNT_ID/vaults/chilkat/archives" vFileStream To sResponseStr
    Get ComLastMethodSuccess Of hoRest To bTemp1
    If (bTemp1 <> True) Begin
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get ComResponseStatusCode Of hoRest To iRespStatusCode
    If (iRespStatusCode >= 400) Begin
        Showln "Response Status Code = " iRespStatusCode
        Showln "Response Header:"
        Get ComResponseHeader Of hoRest To sTemp1
        Showln sTemp1
        Showln "Response Body:"
        Showln sResponseStr
        Procedure_Return
    End

    // Success is indicated by a 201 response status with an empty response body.
    Showln "response status code = " iRespStatusCode

    // If successful, the response header looks like this.
    // The Location and x-amz-archive-id are two items of information we may wish to save..

    // HTTP/1.1 201 Created
    // x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
    // Date: Wed, 10 Feb 2017 12:00:00 GMT
    // x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
    // Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTH ... GlqrEXAMPLEArchiveId
    // x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsu ... BfGlqrEXAMPLEArchiveId
    // 

    Get ComResponseHdrByName Of hoRest "x-amz-archive-id" To sArchiveId
    Showln "x-amz-archive-id = " sArchiveId

    Get ComResponseHdrByName Of hoRest "Location" To sLocation
    Showln "Location = " sLocation


End_Procedure