Visual FoxPro

Glacier Upload Archive

See more Amazon Glacier Examples

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.

Visual FoxPro

LOCAL lnSuccess
LOCAL loRest
LOCAL lnBTls
LOCAL lnPort
LOCAL lnBAutoReconnect
LOCAL loAuthAws
LOCAL lcFilePath
LOCAL loCrypt
LOCAL lcTreeHashHex
LOCAL lcLinearHashHex
LOCAL loFileStream
LOCAL lcResponseStr
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.
* --------------------------------------------------------------------------

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

* The file we'll be uploading
lcFilePath = "qa_data/zips/somethingBig.zip"

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

loCrypt.HashAlgorithm = "sha256"
lcLinearHashHex = loCrypt.HashFileENC(lcFilePath)
loAuthAws.PrecomputedSha256 = lcLinearHashHex

* 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.
loRest.AddHeader("x-amz-archive-description",lcFilePath)

* Upload the file to the vault named "chilkat"
loFileStream = CreateObject('Chilkat.Stream')
loFileStream.SourceFile = lcFilePath

* May need to increase the timeout if this is a really large file..
loRest.IdleTimeoutMs = 120000

*  Add an Expect: 100-continue request header
loRest.AddHeader("Expect","100-continue")

lcResponseStr = loRest.FullRequestStream("POST","/AWS_ACCOUNT_ID/vaults/chilkat/archives",loFileStream)
IF (loRest.LastMethodSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loRest
    RELEASE loAuthAws
    RELEASE loCrypt
    RELEASE loFileStream
    CANCEL
ENDIF

lnRespStatusCode = loRest.ResponseStatusCode
IF (lnRespStatusCode >= 400) THEN
    ? "Response Status Code = " + STR(lnRespStatusCode)
    ? "Response Header:"
    ? loRest.ResponseHeader
    ? "Response Body:"
    ? lcResponseStr
    RELEASE loRest
    RELEASE loAuthAws
    RELEASE loCrypt
    RELEASE loFileStream
    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 loCrypt
RELEASE loFileStream