Sample code for 30+ languages & platforms
Delphi ActiveX

Create S3 Bucket in a Region

See more Amazon S3 Examples

Demonstrates how to create an S3 bucket in a specified region. This example will create a bucket in the eu-west-2 region.

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;
rest: TChilkatRest;
bTls: Integer;
port: Integer;
bAutoReconnect: Integer;
authAws: TChilkatAuthAws;
bucketRegion: WideString;
sbBucketRegion: TChilkatStringBuilder;
xml: TChilkatXml;
responseStr: WideString;
responseXml: TChilkatXml;

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.
bTls := 1;
port := 443;
bAutoReconnect := 1;
success := rest.Connect('s3.amazonaws.com',port,bTls,bAutoReconnect);

// Provide AWS credentials for the REST call.
authAws := TChilkatAuthAws.Create(Self);
authAws.AccessKey := 'AWS_ACCESS_KEY';
authAws.SecretKey := 'AWS_SECRET_KEY';
authAws.ServiceName := 's3';
success := rest.SetAuthAws(authAws.ControlInterface);

// We'll send a PUT request having an XML body such as this:
// <CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
//   <LocationConstraint>BucketRegion</LocationConstraint> 
//   </CreateBucketConfiguration>

// Create the XML body specifying the region as "eu-west-2"
bucketRegion := 'eu-west-2';
sbBucketRegion := TChilkatStringBuilder.Create(Self);
sbBucketRegion.Append(bucketRegion);

// We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
xml := TChilkatXml.Create(Self);
if (not sbBucketRegion.ContentsEqual('us-east-1')) then
  begin
    xml.Tag := 'CreateBucketConfiguration';
    xml.AddAttribute('xmlns','http://s3.amazonaws.com/doc/2006-03-01/');
    xml.UpdateChildContent('LocationConstraint','eu-west-2');
  end;

// --------------------------------------------------------------
// IMPORTANT: To create a bucket in the default us-east-1 region,
// do not add the LocationConstraint.  Adding a LocationConstraint of "us-east-1"
// causes an error "The specified location-constraint is not valid."
// By default, the bucket is created in us-east-1 by sending a PUT with an empty body.
// --------------------------------------------------------------

// Set the bucket name via the HOST header.
// In this case, the bucket name is "chilkateuwest2".
rest.Host := 'chilkateuwest2.s3.amazonaws.com';

// Make the call to create the bucket.

if (not sbBucketRegion.ContentsEqual('us-east-1')) then
  begin
    responseStr := rest.FullRequestString('PUT','/',xml.GetXml());
  end
else
  begin
    // If the bucket is to be created in the us-east-1 region (the default region)
    // just send a PUT with no body.
    responseStr := rest.FullRequestNoBody('PUT','/');
  end;
if (rest.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;

if (rest.ResponseStatusCode <> 200) then
  begin
    Memo1.Lines.Add('status code = ' + IntToStr(rest.ResponseStatusCode));
    responseXml := TChilkatXml.Create(Self);
    responseXml.LoadXml(responseStr);
    Memo1.Lines.Add(responseXml.GetXml());
    Memo1.Lines.Add('Failed.');
    Exit;
  end;

Memo1.Lines.Add('Bucket in the eu-west-2 region created.');
end;