Xbase++

Amazon Glacier Upload Archive from In-Memory Data

See more Amazon Glacier Examples

Demonstrates how to add an archive to a vault from data in memory.

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

Xbase++

LOCAL nSuccess
LOCAL oRest
LOCAL nBTls
LOCAL nPort
LOCAL nBAutoReconnect
LOCAL oAuthAws
LOCAL oBd
LOCAL oCrypt
LOCAL cTreeHashHex
LOCAL cLinearHashHex
LOCAL oSbResponseBody
LOCAL nRespStatusCode
LOCAL cArchiveId
LOCAL cLocation

nSuccess := 0

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

oRest := CreateObject("Chilkat.Rest")

//  Connect to the Amazon AWS REST server in the desired region.
nBTls := 1
nPort := 443
nBAutoReconnect := 1
nSuccess := oRest:Connect("glacier.us-west-2.amazonaws.com", nPort, nBTls, nBAutoReconnect)

//  Provide AWS credentials.
oAuthAws := CreateObject("Chilkat.AuthAws")
oAuthAws:AccessKey := "AWS_ACCESS_KEY"
oAuthAws:SecretKey := "AWS_SECRET_KEY"
oAuthAws:ServiceName := "glacier"
oAuthAws:Region := "us-west-2"

nSuccess := oRest:SetAuthAws(oAuthAws)

//  --------------------------------------------------------------------------
//  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.
//  --------------------------------------------------------------------------

//  Load the data to be uploaded.
oBd := CreateObject("Chilkat.BinData")
nSuccess := oBd:LoadFile("qa_data/jpg/penguins.jpg")
//  (The point here is that the contents of the bd don't necessarily have to come from a file.)

//  For more information, see Glacier Upload Archive Reference Documentation
//  
oRest:AddHeader("x-amz-glacier-version", "2012-06-01")

//  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

oCrypt := CreateObject("Chilkat.Crypt2")
oCrypt:HashAlgorithm := "sha256-tree-hash"
oCrypt:EncodingMode := "hexlower"
cTreeHashHex := oCrypt:HashBdENC(oBd)
oRest:AddHeader("x-amz-sha256-tree-hash", cTreeHashHex)

oCrypt:HashAlgorithm := "sha256"
cLinearHashHex := oCrypt:HashBdENC(oBd)
oAuthAws:PrecomputedSha256 := cLinearHashHex

//  We can optionally add a description
oRest:AddHeader("x-amz-archive-description", "Penguins JPG")

oSbResponseBody := CreateObject("Chilkat.StringBuilder")
nSuccess := oRest:FullRequestBd("POST", "/AWS_ACCOUNT_ID/vaults/chilkat/archives", oBd, oSbResponseBody)
IF (nSuccess != 1)
    ? oRest:LastErrorText
    oRest:destroy()
    oAuthAws:destroy()
    oBd:destroy()
    oCrypt:destroy()
    oSbResponseBody:destroy()
    RETURN
ENDIF

nRespStatusCode := oRest:ResponseStatusCode
IF (nRespStatusCode >= 400)
    ? "Response Status Code = " + Str(nRespStatusCode)
    ? "Response Header:"
    ? oRest:ResponseHeader
    ? "Response Body:"
    ? oSbResponseBody:GetAsString()
    oRest:destroy()
    oAuthAws:destroy()
    oBd:destroy()
    oCrypt:destroy()
    oSbResponseBody:destroy()
    RETURN
ENDIF

//  Success is indicated by a 201 response status with an empty response body.
? "response status code = " + Str(nRespStatusCode)

//  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
//  

cArchiveId := oRest:ResponseHdrByName("x-amz-archive-id")
? "x-amz-archive-id = " + cArchiveId

cLocation := oRest:ResponseHdrByName("Location")
? "Location = " + cLocation

oRest:destroy()
oAuthAws:destroy()
oBd:destroy()
oCrypt:destroy()
oSbResponseBody:destroy()