Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(Unicode C) Glacier Initiate Inventory Retrieval JobDemonstrates how to initiate an inventory retrieval job to get a list of archives from the examplevault vault. The Format set to CSV in the body of the request indicates that the inventory is returned in CSV format. Note: This example requires Chilkat v9.5.0.78 or greater.
#include <C_CkRestW.h> #include <C_CkAuthAwsW.h> #include <C_CkJsonObjectW.h> #include <C_CkStringBuilderW.h> void ChilkatSample(void) { HCkRestW rest; BOOL bTls; int port; BOOL bAutoReconnect; BOOL success; HCkAuthAwsW authAws; HCkJsonObjectW json; HCkStringBuilderW sbRequestBody; HCkStringBuilderW sbResponseBody; int respStatusCode; const wchar_t *jobId; const wchar_t *location; // This example requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. rest = CkRestW_Create(); // Connect to the Amazon AWS REST server in the desired region. bTls = TRUE; port = 443; bAutoReconnect = TRUE; success = CkRestW_Connect(rest,L"glacier.us-west-2.amazonaws.com",port,bTls,bAutoReconnect); // Provide AWS credentials. authAws = CkAuthAwsW_Create(); CkAuthAwsW_putAccessKey(authAws,L"AWS_ACCESS_KEY"); CkAuthAwsW_putSecretKey(authAws,L"AWS_SECRET_KEY"); CkAuthAwsW_putServiceName(authAws,L"glacier"); CkAuthAwsW_putRegion(authAws,L"us-west-2"); success = CkRestW_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 Initiate Job Post Reference Documentation // CkRestW_AddHeader(rest,L"x-amz-glacier-version",L"2012-06-01"); // The body of our request will contain this JSON: // { // "Type": "inventory-retrieval", // "Description": "My inventory job", // "Format": "CSV", // "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" // } // Use this online tool to generate the code from sample JSON: // Generate Code to Create JSON json = CkJsonObjectW_Create(); CkJsonObjectW_UpdateString(json,L"Type",L"inventory-retrieval"); CkJsonObjectW_UpdateString(json,L"Description",L"My inventory job"); CkJsonObjectW_UpdateString(json,L"Format",L"CSV"); // The SNSTopic is optional. If included, then notification is sent to the SNS topic when the job is complete. // This example will omit the SNSTopic. sbRequestBody = CkStringBuilderW_Create(); CkJsonObjectW_EmitSb(json,sbRequestBody); sbResponseBody = CkStringBuilderW_Create(); // Start an inventory retrieval job for the vault named "chilkat". success = CkRestW_FullRequestSb(rest,L"POST",L"/AWS_ACCOUNT_ID/vaults/chilkat/jobs",sbRequestBody,sbResponseBody); if (success != TRUE) { wprintf(L"%s\n",CkRestW_lastErrorText(rest)); CkRestW_Dispose(rest); CkAuthAwsW_Dispose(authAws); CkJsonObjectW_Dispose(json); CkStringBuilderW_Dispose(sbRequestBody); CkStringBuilderW_Dispose(sbResponseBody); return; } respStatusCode = CkRestW_getResponseStatusCode(rest); if (respStatusCode >= 400) { wprintf(L"Response Status Code = %d\n",respStatusCode); wprintf(L"Response Header:\n"); wprintf(L"%s\n",CkRestW_responseHeader(rest)); wprintf(L"Response Body:\n"); wprintf(L"%s\n",CkStringBuilderW_getAsString(sbResponseBody)); CkRestW_Dispose(rest); CkAuthAwsW_Dispose(authAws); CkJsonObjectW_Dispose(json); CkStringBuilderW_Dispose(sbRequestBody); CkStringBuilderW_Dispose(sbResponseBody); return; } // Success is indicated by a 202 response status with an empty response body. wprintf(L"response status code = %d\n",respStatusCode); // If successful, the response header looks like this. // The Location and x-amz-job-id are two items of information we may wish to save.. // HTTP/1.1 202 Accepted // x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q // Date: Wed, 10 Feb 2017 12:00:00 GMT // Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID // x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID // jobId = CkRestW_responseHdrByName(rest,L"x-amz-job-id"); wprintf(L"x-amz-job-id = %s\n",jobId); location = CkRestW_responseHdrByName(rest,L"Location"); wprintf(L"Location = %s\n",location); CkRestW_Dispose(rest); CkAuthAwsW_Dispose(authAws); CkJsonObjectW_Dispose(json); CkStringBuilderW_Dispose(sbRequestBody); CkStringBuilderW_Dispose(sbResponseBody); } |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.