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) S3 Complete a Multipart UploadThis operation completes a multipart upload by assembling previously uploaded parts. Processing of a Complete Multipart Upload request could take several minutes to complete. After Amazon S3 begins processing the request, it sends an HTTP response header that specifies a 200 OK response. While processing is in progress, Amazon S3 periodically sends whitespace characters to keep the connection from timing out. Because a request could fail after the initial 200 OK response has been sent, it is important that you check the response body to determine whether the request succeeded. This example sends a POST request to complete a multipart upload, which looks like this: POST /ObjectName?uploadId=UploadId HTTP/1.1 Host: BucketName.s3.amazonaws.com Date: Date Content-Length: Size Authorization: authorization string <CompleteMultipartUpload> <Part> <PartNumber>PartNumber</PartNumber> <ETag>ETag</ETag> </Part> ... </CompleteMultipartUpload>
#include <C_CkXmlW.h> #include <C_CkRestW.h> #include <C_CkAuthAwsW.h> void ChilkatSample(void) { HCkXmlW xmlInit; BOOL success; const wchar_t *uploadId; HCkXmlW xmlPartsList; HCkRestW rest; BOOL bTls; int port; BOOL bAutoReconnect; HCkAuthAwsW authAws; const wchar_t *responseXml; HCkXmlW xml; // This example requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. // The 1st step in an S3 multipart upload is to initiate it, // as shown here: Initiate S3 Multipart Upload // The 2nd step is to upload the parts // as shown here: S3 Upload Parts // The 3rd and final step (this example) is to complete the multipart upload. // Other S3 Multipart Upload Examples: // Abort Multipart Upload // List Parts // When the multipart upload was initiated, an UploadId was provided in the XML response, and it // was saved to a file. Steps 2 and 3 begin by loading the XML and getting // the Upload ID. xmlInit = CkXmlW_Create(); success = CkXmlW_LoadXmlFile(xmlInit,L"s3_multipart_uploads/initiate.xml"); if (success != TRUE) { wprintf(L"Did not find the initiate.xml XML file.\n"); CkXmlW_Dispose(xmlInit); return; } uploadId = CkXmlW_getChildContent(xmlInit,L"UploadId"); wprintf(L"UploadId = %s\n",uploadId); // We'll also need the XML file that contains a record of the parts // with part numbers and ETags. (This file was produced when parts were being uploaded.) xmlPartsList = CkXmlW_Create(); success = CkXmlW_LoadXmlFile(xmlPartsList,L"s3_multipart_uploads/partsList.xml"); if (success != TRUE) { wprintf(L"Did not find the partsList.xml XML file.\n"); CkXmlW_Dispose(xmlInit); CkXmlW_Dispose(xmlPartsList); return; } rest = CkRestW_Create(); // Connect to the Amazon AWS REST server. bTls = TRUE; port = 443; bAutoReconnect = TRUE; success = CkRestW_Connect(rest,L"s3.amazonaws.com",port,bTls,bAutoReconnect); // ---------------------------------------------------------------------------- // Important: For buckets created in regions outside us-east-1, // there are three important changes that need to be made. // See Working with S3 Buckets in Non-us-east-1 Regions for the details. // ---------------------------------------------------------------------------- // Provide AWS credentials for the REST call. authAws = CkAuthAwsW_Create(); CkAuthAwsW_putAccessKey(authAws,L"AWS_ACCESS_KEY"); CkAuthAwsW_putSecretKey(authAws,L"AWS_SECRET_KEY"); CkAuthAwsW_putServiceName(authAws,L"s3"); success = CkRestW_SetAuthAws(rest,authAws); // Set the bucket name via the HOST header. // In this case, the bucket name is "chilkat100". CkRestW_putHost(rest,L"chilkat100.s3.amazonaws.com"); // The "uploadId=UploadId" must be added as a query parameter. This allows it to be // incorporated into the AWS signature calculation, which is a requirement. // Therefore, we use AddQueryParam: CkRestW_AddQueryParam(rest,L"uploadId",uploadId); // Our ObjectName in this case is "somethingBig.zip". responseXml = CkRestW_fullRequestString(rest,L"POST",L"/somethingBig.zip",CkXmlW_getXml(xmlPartsList)); if (CkRestW_getLastMethodSuccess(rest) != TRUE) { wprintf(L"%s\n",CkRestW_lastErrorText(rest)); CkXmlW_Dispose(xmlInit); CkXmlW_Dispose(xmlPartsList); CkRestW_Dispose(rest); CkAuthAwsW_Dispose(authAws); return; } // When successful, the S3 Storage service will respond with a 200 response code, // with an XML body. if (CkRestW_getResponseStatusCode(rest) != 200) { // Examine the request/response to see what happened. wprintf(L"response status code = %d\n",CkRestW_getResponseStatusCode(rest)); wprintf(L"response status text = %s\n",CkRestW_responseStatusText(rest)); wprintf(L"response header: %s\n",CkRestW_responseHeader(rest)); wprintf(L"response body: %s\n",responseXml); wprintf(L"---\n"); wprintf(L"LastRequestStartLine: %s\n",CkRestW_lastRequestStartLine(rest)); wprintf(L"LastRequestHeader: %s\n",CkRestW_lastRequestHeader(rest)); } // Load the XML response into Chilkat XMl and emit via GetXml to see the XML in a pretty-printed (indented) readable format. xml = CkXmlW_Create(); CkXmlW_LoadXml(xml,responseXml); wprintf(L"%s\n",CkXmlW_getXml(xml)); wprintf(L"----\n"); wprintf(L"Multipart upload completed.\n"); CkXmlW_Dispose(xmlInit); CkXmlW_Dispose(xmlPartsList); CkRestW_Dispose(rest); CkAuthAwsW_Dispose(authAws); CkXmlW_Dispose(xml); } |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.