Visual FoxPro

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.

Visual FoxPro

LOCAL lnSuccess
LOCAL loRest
LOCAL lnBTls
LOCAL lnPort
LOCAL lnBAutoReconnect
LOCAL loAuthAws
LOCAL loBd
LOCAL loCrypt
LOCAL lcTreeHashHex
LOCAL lcLinearHashHex
LOCAL loSbResponseBody
LOCAL lnRespStatusCode
LOCAL lcArchiveId
LOCAL lcLocation

lnSuccess = 0

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

loRest = CreateObject('Chilkat.Rest')

* Connect to the Amazon AWS REST server in the desired region.
lnBTls = 1
lnPort = 443
lnBAutoReconnect = 1
lnSuccess = loRest.Connect("glacier.us-west-2.amazonaws.com",lnPort,lnBTls,lnBAutoReconnect)

* Provide AWS credentials.
loAuthAws = CreateObject('Chilkat.AuthAws')
loAuthAws.AccessKey = "AWS_ACCESS_KEY"
loAuthAws.SecretKey = "AWS_SECRET_KEY"
loAuthAws.ServiceName = "glacier"
loAuthAws.Region = "us-west-2"

lnSuccess = loRest.SetAuthAws(loAuthAws)

* --------------------------------------------------------------------------
* 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.
loBd = CreateObject('Chilkat.BinData')
lnSuccess = loBd.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
* 
loRest.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

loCrypt = CreateObject('Chilkat.Crypt2')
loCrypt.HashAlgorithm = "sha256-tree-hash"
loCrypt.EncodingMode = "hexlower"
lcTreeHashHex = loCrypt.HashBdENC(loBd)
loRest.AddHeader("x-amz-sha256-tree-hash",lcTreeHashHex)

loCrypt.HashAlgorithm = "sha256"
lcLinearHashHex = loCrypt.HashBdENC(loBd)
loAuthAws.PrecomputedSha256 = lcLinearHashHex

* We can optionally add a description
loRest.AddHeader("x-amz-archive-description","Penguins JPG")

loSbResponseBody = CreateObject('Chilkat.StringBuilder')
lnSuccess = loRest.FullRequestBd("POST","/AWS_ACCOUNT_ID/vaults/chilkat/archives",loBd,loSbResponseBody)
IF (lnSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loRest
    RELEASE loAuthAws
    RELEASE loBd
    RELEASE loCrypt
    RELEASE loSbResponseBody
    CANCEL
ENDIF

lnRespStatusCode = loRest.ResponseStatusCode
IF (lnRespStatusCode >= 400) THEN
    ? "Response Status Code = " + STR(lnRespStatusCode)
    ? "Response Header:"
    ? loRest.ResponseHeader
    ? "Response Body:"
    ? loSbResponseBody.GetAsString()
    RELEASE loRest
    RELEASE loAuthAws
    RELEASE loBd
    RELEASE loCrypt
    RELEASE loSbResponseBody
    CANCEL
ENDIF

* Success is indicated by a 201 response status with an empty response body.
? "response status code = " + STR(lnRespStatusCode)

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

lcArchiveId = loRest.ResponseHdrByName("x-amz-archive-id")
? "x-amz-archive-id = " + lcArchiveId

lcLocation = loRest.ResponseHdrByName("Location")
? "Location = " + lcLocation

RELEASE loRest
RELEASE loAuthAws
RELEASE loBd
RELEASE loCrypt
RELEASE loSbResponseBody