(Delphi DLL) 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.

For more information, see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, AuthAws, Rest, Xml, StringBuilder;

...

procedure TForm1.Button1Click(Sender: TObject);
var
rest: HCkRest;
bTls: Boolean;
port: Integer;
bAutoReconnect: Boolean;
success: Boolean;
authAws: HCkAuthAws;
bucketRegion: PWideChar;
sbBucketRegion: HCkStringBuilder;
xml: HCkXml;
responseStr: PWideChar;
responseXml: HCkXml;

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

rest := CkRest_Create();

// Connect to the Amazon AWS REST server.
bTls := True;
port := 443;
bAutoReconnect := True;
success := CkRest_Connect(rest,'s3.amazonaws.com',port,bTls,bAutoReconnect);

// Provide AWS credentials for the REST call.
authAws := CkAuthAws_Create();
CkAuthAws_putAccessKey(authAws,'AWS_ACCESS_KEY');
CkAuthAws_putSecretKey(authAws,'AWS_SECRET_KEY');
CkAuthAws_putServiceName(authAws,'s3');
success := CkRest_SetAuthAws(rest,authAws);

// 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 := CkStringBuilder_Create();
CkStringBuilder_Append(sbBucketRegion,bucketRegion);

// We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
xml := CkXml_Create();
if (not CkStringBuilder_ContentsEqual(sbBucketRegion,'us-east-1')) then
  begin
    CkXml_putTag(xml,'CreateBucketConfiguration');
    CkXml_AddAttribute(xml,'xmlns','http://s3.amazonaws.com/doc/2006-03-01/');
    CkXml_UpdateChildContent(xml,'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".
CkRest_putHost(rest,'chilkateuwest2.s3.amazonaws.com');

// Make the call to create the bucket.

if (not CkStringBuilder_ContentsEqual(sbBucketRegion,'us-east-1')) then
  begin
    responseStr := CkRest__fullRequestString(rest,'PUT','/',CkXml__getXml(xml));
  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 := CkRest__fullRequestNoBody(rest,'PUT','/');
  end;
if (CkRest_getLastMethodSuccess(rest) <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

if (CkRest_getResponseStatusCode(rest) <> 200) then
  begin
    Memo1.Lines.Add('status code = ' + IntToStr(CkRest_getResponseStatusCode(rest)));
    responseXml := CkXml_Create();
    CkXml_LoadXml(responseXml,responseStr);
    Memo1.Lines.Add(CkXml__getXml(responseXml));
    Memo1.Lines.Add('Failed.');
    Exit;
  end;

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

CkRest_Dispose(rest);
CkAuthAws_Dispose(authAws);
CkStringBuilder_Dispose(sbBucketRegion);
CkXml_Dispose(xml);
    CkXml_Dispose(responseXml);

end;