(Tcl) Amazon Glacier Describe Vault

Returns information about a vault, including the vault Amazon Resource Name (ARN), the date the vault was created, the number of archives contained within the vault, and the total size of all the archives in the vault...

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set rest [new_CkRest]

# Connect to the Amazon AWS REST server in the desired region.
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "glacier.us-west-2.amazonaws.com" $port $bTls $bAutoReconnect]

# Provide AWS credentials.
set authAws [new_CkAuthAws]

CkAuthAws_put_AccessKey $authAws "AWS_ACCESS_KEY"
CkAuthAws_put_SecretKey $authAws "AWS_SECRET_KEY"
CkAuthAws_put_ServiceName $authAws "glacier"
CkAuthAws_put_Region $authAws "us-west-2"

set success [CkRest_SetAuthAws $rest $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 Describe Vault Reference Documentation
# 
CkRest_AddHeader $rest "x-amz-glacier-version" "2012-06-01"

# Describe the "chilkat" vault
set sbResponseBody [new_CkStringBuilder]

set success [CkRest_FullRequestNoBodySb $rest "GET" "/AWS_ACCOUNT_ID/vaults/chilkat" $sbResponseBody]
if {$success != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    delete_CkStringBuilder $sbResponseBody
    exit
}

set respStatusCode [CkRest_get_ResponseStatusCode $rest]
if {$respStatusCode >= 400} then {
    puts "Response Status Code = $respStatusCode"
    puts "Response Header:"
    puts [CkRest_responseHeader $rest]
    puts "Response Body:"
    puts [CkStringBuilder_getAsString $sbResponseBody]
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    delete_CkStringBuilder $sbResponseBody
    exit
}

# Success is indicated by a 200 response status with an empty response body.
puts "response status code = $respStatusCode"

set json [new_CkJsonObject]

CkJsonObject_LoadSb $json $sbResponseBody
CkJsonObject_put_EmitCompact $json 0

puts [CkJsonObject_emit $json]

# Use this online tool to generate parsing code from sample JSON: 
# Generate Parsing Code from JSON

set CreationDate [CkJsonObject_stringOf $json "CreationDate"]
set LastInventoryDate [CkJsonObject_stringOf $json "LastInventoryDate"]
set NumberOfArchives [CkJsonObject_IntOf $json "NumberOfArchives"]
set SizeInBytes [CkJsonObject_IntOf $json "SizeInBytes"]
set VaultARN [CkJsonObject_stringOf $json "VaultARN"]
set VaultName [CkJsonObject_stringOf $json "VaultName"]

# Sample response
# 
# {
#   "CreationDate": "2019-04-05T19:10:28.428Z",
#   "LastInventoryDate": null,
#   "NumberOfArchives": 0,
#   "SizeInBytes": 0,
#   "VaultARN": "arn:aws:glacier:us-west-2:954491834127:vaults/chilkat",
#   "VaultName": "chilkat"
# }
# 

delete_CkRest $rest
delete_CkAuthAws $authAws
delete_CkStringBuilder $sbResponseBody
delete_CkJsonObject $json