Xbase++

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.

Xbase++

LOCAL nSuccess
LOCAL oRest
LOCAL nBTls
LOCAL nPort
LOCAL nBAutoReconnect
LOCAL oAuthAws
LOCAL cFilePath
LOCAL oCrypt
LOCAL cTreeHashHex
LOCAL cLinearHashHex
LOCAL oFileStream
LOCAL cResponseStr
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.
//  --------------------------------------------------------------------------

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

//  The file we'll be uploading
cFilePath := "qa_data/zips/somethingBig.zip"

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

oCrypt:HashAlgorithm := "sha256"
cLinearHashHex := oCrypt:HashFileENC(cFilePath)
oAuthAws:PrecomputedSha256 := cLinearHashHex

//  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.
oRest:AddHeader("x-amz-archive-description", cFilePath)

//  Upload the file to the vault named "chilkat"
oFileStream := CreateObject("Chilkat.Stream")
oFileStream:SourceFile := cFilePath

//  May need to increase the timeout if this is a really large file..
oRest:IdleTimeoutMs := 120000

//   Add an Expect: 100-continue request header
oRest:AddHeader("Expect", "100-continue")

cResponseStr := oRest:FullRequestStream("POST", "/AWS_ACCOUNT_ID/vaults/chilkat/archives", oFileStream)
IF (oRest:LastMethodSuccess != 1)
    ? oRest:LastErrorText
    oRest:destroy()
    oAuthAws:destroy()
    oCrypt:destroy()
    oFileStream:destroy()
    RETURN
ENDIF

nRespStatusCode := oRest:ResponseStatusCode
IF (nRespStatusCode >= 400)
    ? "Response Status Code = " + Str(nRespStatusCode)
    ? "Response Header:"
    ? oRest:ResponseHeader
    ? "Response Body:"
    ? cResponseStr
    oRest:destroy()
    oAuthAws:destroy()
    oCrypt:destroy()
    oFileStream: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()
oCrypt:destroy()
oFileStream:destroy()