Sample code for 30+ languages & platforms
Delphi ActiveX

Upload File with User-Defined Metadata

See more Amazon S3 Examples

Demonstrates how to upload a file with user-defined metadata to the Amazon S3 service.

Chilkat Delphi ActiveX Downloads

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;
http: TChilkatHttp;
bucketName: WideString;
objectName: WideString;
localFilePath: WideString;
contentType: WideString;

begin
success := 0;

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

http := TChilkatHttp.Create(Self);

// Insert your AWS keys here:
http.AwsAccessKey := 'AWS_ACCESS_KEY';
http.AwsSecretKey := 'AWS_SECRET_KEY';

bucketName := 'chilkat.ocean';
objectName := 'seahorse.jpg';
localFilePath := 'qa_data/jpg/seahorse.jpg';
contentType := 'image/jpg';

// User-defined metadata are name/value pairs, and are added to the HTTP request header.
// Header names must begin with "x-amz-meta-" to distinguish them from other HTTP headers.
// Note that Amazon S3 stores user-defined metadata keys in lowercase.

// For example, to add genus=Hippocampus, we do this:
http.SetRequestHeader('x-amz-meta-genus','Hippocampus');

// Add a few more user-metadata key pairs.
http.SetRequestHeader('x-amz-meta-species','big-belly seahorse');
http.SetRequestHeader('x-amz-meta-habitat','shallow tropical and temperate waters');

success := http.S3_UploadFile(localFilePath,contentType,bucketName,objectName);

if (success <> 1) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
  end
else
  begin
    Memo1.Lines.Add('File uploaded.');
  end;
end;