Sample code for 30+ languages & platforms
Delphi DLL

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 DLL Downloads

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

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
http: HCkHttp;
bucketName: PWideChar;
objectName: PWideChar;
localFilePath: PWideChar;
contentType: PWideChar;

begin
success := False;

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

http := CkHttp_Create();

// Insert your AWS keys here:
CkHttp_putAwsAccessKey(http,'AWS_ACCESS_KEY');
CkHttp_putAwsSecretKey(http,'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:
CkHttp_SetRequestHeader(http,'x-amz-meta-genus','Hippocampus');

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

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

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

CkHttp_Dispose(http);

end;