Delphi ActiveX

S3 Rename File

See more Amazon S3 (new) Examples

Demonstrates how to rename a file on Amazon S3.

Renaming an object (file) in AWS S3 using the AWS S3 API involves copying the object to a new location with the desired name and then deleting the original object.

Delphi ActiveX

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Integer;
rest: TChilkatRest;
bTls: Integer;
port: Integer;
bAutoReconnect: Integer;
authAws: TChilkatAuthAws;
sbResponse: TChilkatStringBuilder;
statusCode: Integer;

begin
success := 0;

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

rest := TChilkatRest.Create(Self);

// Connect to the Amazon AWS REST server in the desired region.
bTls := 1;
port := 443;
bAutoReconnect := 1;
success := rest.Connect('s3-us-west-2.amazonaws.com',port,bTls,bAutoReconnect);

// Provide AWS credentials.
authAws := TChilkatAuthAws.Create(Self);
authAws.AccessKey := 'AWS_ACCESS_KEY';
authAws.SecretKey := 'AWS_SECRET_KEY';
authAws.ServiceName := 's3';

// This particular bucket is in the Oregon region, as opposed to the US Standard,
// therefore the Region must be set appropriately.
// Also note that we connected to "s3-us-west-2.amazonaws.com".
authAws.Region := 'us-west-2';

rest.SetAuthAws(authAws.ControlInterface);

// Set the bucket name via the HOST header.
// In this case, the bucket name is "chilkat.qa".
// Note that the Host header should use "bucketName.s3.amazonaws.com", not "bucketName.s3-us-west-2.amazonaws.com"
rest.Host := 'chilkat.qa.s3.amazonaws.com';

// Copy /images/sea_creatures/starfish.jpg to /images/sea_creatures/starfish3.jpg
// Notice here that the x-amz-copy-source includes the bucket in the source path,
// but the target path passed to FullRequestNoBody does NOT contain the bucket (because the bucket
// was already specified in the Host header).
rest.AddHeader('x-amz-copy-source','/chilkat.qa/images/sea_creatures/starfish.jpg');

sbResponse := TChilkatStringBuilder.Create(Self);
success := rest.FullRequestNoBodySb('PUT','/images/sea_creatures/starfish3.jpg',sbResponse.ControlInterface);
if (success = 0) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;

// When successful, the S3 Storage service will respond with a 200 or 204 response code,
// with an XML body.  
if (rest.ResponseStatusCode <> 200) then
  begin
    // Examine the request/response to see what happened.
    Memo1.Lines.Add('response status code = ' + IntToStr(rest.ResponseStatusCode));
    Memo1.Lines.Add('response status text = ' + rest.ResponseStatusText);
    Memo1.Lines.Add('response header: ' + rest.ResponseHeader);
    Memo1.Lines.Add('response body: ' + sbResponse.GetAsString());
    Memo1.Lines.Add('---');
    Memo1.Lines.Add('LastRequestStartLine: ' + rest.LastRequestStartLine);
    Memo1.Lines.Add('LastRequestHeader: ' + rest.LastRequestHeader);
  end;

Memo1.Lines.Add(sbResponse.GetAsString());
Memo1.Lines.Add('Copy Successful.');

// --------------------------------------
// Now we can delete the original file..
// --------------------------------------

// We no longer want to send the x-amz-copy-source header.  Remove it.
rest.RemoveHeader('x-amz-copy-source');

success := rest.FullRequestNoBodySb('DELETE','/images/sea_creatures/starfish.jpg',sbResponse.ControlInterface);
if (success = 0) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;

// If successfully deleted, the response status code is 204 and the response body text will be empty.
statusCode := rest.ResponseStatusCode;
Memo1.Lines.Add('Response status code = ' + IntToStr(statusCode));
Memo1.Lines.Add('Response text = ');
Memo1.Lines.Add(sbResponse.GetAsString());
end;