TElAWSS3DataStorage.CreateBucket method

TElAWSS3DataStorage.CreateBucket

Creates a new data bucket.

Declaration

[C#]
    TElAWSS3DataStorageBucket CreateBucket(string BucketName);
    TElAWSS3DataStorageBucket CreateBucket(string BucketName, string Location);
    TElAWSS3DataStorageBucket CreateBucket(string BucketName, string Location, string ACL);
    TElAWSS3DataStorageBucket CreateBucket(string BucketName, string Location, TElStringList Headers);
    TElAWSS3DataStorageBucket CreateBucket(string BucketName, string Location, string ACL, TElStringList Headers);

[VB.NET]
    Function CreateBucket(ByVal BucketName As String) As TElAWSS3DataStorageBucket
    Function CreateBucket(ByVal BucketName As String, ByVal Location As String) As TElAWSS3DataStorageBucket
    Function CreateBucket(ByVal BucketName As String, ByVal Location As String, ByVal ACL As String) As TElAWSS3DataStorageBucket
    Function CreateBucket(ByVal BucketName As String, ByVal Location As String, ByVal Headers As TElStringList) As TElAWSS3DataStorageBucket
    Function CreateBucket(ByVal BucketName As String, ByVal Location As String, ByVal ACL As String, ByVal Headers As TElStringList) As TElAWSS3DataStorageBucket

[Pascal]
    function CreateBucket(const BucketName : string) : TElAWSS3DataStorageBucket;
    function CreateBucket(const BucketName : string; const Location : string) : TElAWSS3DataStorageBucket;
    function CreateBucket(const BucketName : string; const Location : string; Headers : TStringList) : TElAWSS3DataStorageBucket;
    function CreateBucket(const BucketName : string; const Location : string; const ACL : string) : TElAWSS3DataStorageBucket;
    function CreateBucket(const BucketName : string; const Location : string; const ACL : string; Headers : TStringList) : TElAWSS3DataStorageBucket;

[C++]
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, const std::string &ACL);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, TElStringList &Headers);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, TElStringList *Headers);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, const std::string &ACL, TElStringList &Headers);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, const std::string &ACL, TElStringList *Headers);

[PHP]
    TElAWSS3DataStorageBucket CreateBucket(string $BucketName)
    TElAWSS3DataStorageBucket CreateBucket(string $BucketName, string $Location)
    TElAWSS3DataStorageBucket CreateBucket(string $BucketName, string $Location, string $ACL)
    TElAWSS3DataStorageBucket CreateBucket(string $BucketName, string $Location, TElStringList $Headers)
    TElAWSS3DataStorageBucket CreateBucket(string $BucketName, string $Location, string $ACL, TElStringList $Headers)

[Java]
    TElAWSS3DataStorageBucket createBucket(String BucketName, String Location, TElStringList Headers);
    TElAWSS3DataStorageBucket createBucket(String BucketName);
    TElAWSS3DataStorageBucket createBucket(String BucketName, String Location, String ACL, TElStringList Headers);
    TElAWSS3DataStorageBucket createBucket(String BucketName, String Location);
    TElAWSS3DataStorageBucket createBucket(String BucketName, String Location, String ACL);

Parameters

ACL - specifies the ACL of the new bucket.
BucketName - the name of the new bucket.
Headers - contains HTTP request headers.
Location - specifies the location where the bucket should be physically stored.

Return value

Instance of TElAWSS3DataStorageBucket class which contains newly created bucket.

Description

Use this method to create new data bucket.
According to Amazon Simple Storage Service Developer guide, to comply with Amazon S3 requirements, bucket names:

Can contain lowercase letters, numbers, periods (.), underscores (_), and dashes (-)
Must start with a number or letter
Must be between 3 and 255 characters long
Must not be formatted as an IP address (e.g., 192.168.5.4)