(Visual FoxPro) S3 Abort Multipart Upload

This operation aborts a multipart upload. After a multipart upload is aborted, no additional parts can be uploaded using that upload ID. The storage consumed by any previously uploaded parts will be freed. However, if any part uploads are currently in progress, those part uploads might or might not succeed. As a result, it might be necessary to abort a given multipart upload multiple times in order to completely free all storage consumed by all parts. To verify that all parts have been removed, so you don't get charged for the part storage, use the {{-s3_list_parts:::List Parts-}} example to ensure the parts list is empty.

This example sends a DELETE request that looks like this:

DELETE /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: Date
Authorization: authorization string

The following is a sample response. A 204 response code is expected.

HTTP/1.1 204 OK
x-amz-id-2: Weag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
x-amz-request-id: 996c76696e6727732072657175657374
Date:  Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 0
Connection: keep-alive
Server: AmazonS3

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loXmlInit
LOCAL lnSuccess
LOCAL lcUploadId
LOCAL loRest
LOCAL lnBTls
LOCAL lnPort
LOCAL lnBAutoReconnect
LOCAL loAuthAws
LOCAL lcResponseBody

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

* Other S3 Multipart Upload Examples:
* Initiate Multipart Upload
* S3 Upload Parts
* Complete Multipart Upload
* List Parts

* When the multipart upload was initiated, an UploadId was provided in the XML response, and 
* we saved it to a file.  We'll get the upload ID from there..

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Xml')
loXmlInit = CreateObject('Chilkat.Xml')
lnSuccess = loXmlInit.LoadXmlFile("s3_multipart_uploads/initiate.xml")
IF (lnSuccess <> 1) THEN
    ? "Did not find the initiate.xml XML file."
    RELEASE loXmlInit
    CANCEL
ENDIF

lcUploadId = loXmlInit.GetChildContent("UploadId")
? "UploadId = " + lcUploadId

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Rest')
loRest = CreateObject('Chilkat.Rest')

* Connect to the Amazon AWS REST server.
lnBTls = 1
lnPort = 443
lnBAutoReconnect = 1
lnSuccess = loRest.Connect("s3.amazonaws.com",lnPort,lnBTls,lnBAutoReconnect)

* ----------------------------------------------------------------------------
* 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.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.AuthAws')
loAuthAws = CreateObject('Chilkat.AuthAws')
loAuthAws.AccessKey = "AWS_ACCESS_KEY"
loAuthAws.SecretKey = "AWS_SECRET_KEY"
loAuthAws.ServiceName = "s3"

lnSuccess = loRest.SetAuthAws(loAuthAws)

* Set the bucket name via the HOST header.
* In this case, the bucket name is "chilkat100".
loRest.Host = "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:
loRest.AddQueryParam("uploadId",lcUploadId)

* Our ObjectName in this case is "somethingBig.zip".
* A successful response will be a 204 status code with an empty response body.
lcResponseBody = loRest.FullRequestNoBody("DELETE","/somethingBig.zip")
IF (loRest.LastMethodSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loXmlInit
    RELEASE loRest
    RELEASE loAuthAws
    CANCEL
ENDIF

* When successful, the S3 Storage service will respond with a 204 response code
IF (loRest.ResponseStatusCode <> 204) THEN
    * Examine the request/response to see what happened.
    ? "response status code = " + STR(loRest.ResponseStatusCode)
    ? "response status text = " + loRest.ResponseStatusText
    ? "response header: " + loRest.ResponseHeader
    ? "response body: " + lcResponseBody
    ? "---"
    ? "LastRequestStartLine: " + loRest.LastRequestStartLine
    ? "LastRequestHeader: " + loRest.LastRequestHeader
ENDIF

? "Multipart upload aborted."

RELEASE loXmlInit
RELEASE loRest
RELEASE loAuthAws