(PowerBuilder) 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

integer li_rc
oleobject loo_Rest
integer li_BTls
integer li_Port
integer li_BAutoReconnect
integer li_Success
oleobject loo_AuthAws
string ls_FilePath
oleobject loo_Crypt
string ls_TreeHashHex
string ls_LinearHashHex
oleobject loo_FileStream
string ls_ResponseStr
integer li_RespStatusCode
string ls_ArchiveId
string ls_Location

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

loo_Rest = create oleobject
// Use "Chilkat_9_5_0.Rest" for versions of Chilkat < 10.0.0
li_rc = loo_Rest.ConnectToNewObject("Chilkat.Rest")
if li_rc < 0 then
    destroy loo_Rest
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Connect to the Amazon AWS REST server in the desired region.
li_BTls = 1
li_Port = 443
li_BAutoReconnect = 1
li_Success = loo_Rest.Connect("glacier.us-west-2.amazonaws.com",li_Port,li_BTls,li_BAutoReconnect)

// Provide AWS credentials.
loo_AuthAws = create oleobject
// Use "Chilkat_9_5_0.AuthAws" for versions of Chilkat < 10.0.0
li_rc = loo_AuthAws.ConnectToNewObject("Chilkat.AuthAws")

loo_AuthAws.AccessKey = "AWS_ACCESS_KEY"
loo_AuthAws.SecretKey = "AWS_SECRET_KEY"
loo_AuthAws.ServiceName = "glacier"
loo_AuthAws.Region = "us-west-2"

li_Success = loo_Rest.SetAuthAws(loo_AuthAws)

// --------------------------------------------------------------------------
// 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
// 
loo_Rest.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
ls_FilePath = "qa_data/zips/somethingBig.zip"

loo_Crypt = create oleobject
// Use "Chilkat_9_5_0.Crypt2" for versions of Chilkat < 10.0.0
li_rc = loo_Crypt.ConnectToNewObject("Chilkat.Crypt2")

loo_Crypt.HashAlgorithm = "sha256-tree-hash"
loo_Crypt.EncodingMode = "hexlower"
ls_TreeHashHex = loo_Crypt.HashFileENC(ls_FilePath)
loo_Rest.AddHeader("x-amz-sha256-tree-hash",ls_TreeHashHex)

loo_Crypt.HashAlgorithm = "sha256"
ls_LinearHashHex = loo_Crypt.HashFileENC(ls_FilePath)
loo_AuthAws.PrecomputedSha256 = ls_LinearHashHex

// 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.
loo_Rest.AddHeader("x-amz-archive-description",ls_FilePath)

// Upload the file to the vault named "chilkat"
loo_FileStream = create oleobject
// Use "Chilkat_9_5_0.Stream" for versions of Chilkat < 10.0.0
li_rc = loo_FileStream.ConnectToNewObject("Chilkat.Stream")

loo_FileStream.SourceFile = ls_FilePath

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

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

ls_ResponseStr = loo_Rest.FullRequestStream("POST","/AWS_ACCOUNT_ID/vaults/chilkat/archives",loo_FileStream)
if loo_Rest.LastMethodSuccess <> 1 then
    Write-Debug loo_Rest.LastErrorText
    destroy loo_Rest
    destroy loo_AuthAws
    destroy loo_Crypt
    destroy loo_FileStream
    return
end if

li_RespStatusCode = loo_Rest.ResponseStatusCode
if li_RespStatusCode >= 400 then
    Write-Debug "Response Status Code = " + string(li_RespStatusCode)
    Write-Debug "Response Header:"
    Write-Debug loo_Rest.ResponseHeader
    Write-Debug "Response Body:"
    Write-Debug ls_ResponseStr
    destroy loo_Rest
    destroy loo_AuthAws
    destroy loo_Crypt
    destroy loo_FileStream
    return
end if

// Success is indicated by a 201 response status with an empty response body.
Write-Debug "response status code = " + string(li_RespStatusCode)

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

ls_ArchiveId = loo_Rest.ResponseHdrByName("x-amz-archive-id")
Write-Debug "x-amz-archive-id = " + ls_ArchiveId

ls_Location = loo_Rest.ResponseHdrByName("Location")
Write-Debug "Location = " + ls_Location


destroy loo_Rest
destroy loo_AuthAws
destroy loo_Crypt
destroy loo_FileStream