Discuss this help topic in SecureBlackbox Forum

TElAWSS3DataStorage.CreateBucket

TElAWSS3DataStorage     See also     


Filter: C#/Java  VB.NET  Pascal  C++  PHP  


Creates a new data bucket.

Declaration

[C#/Java]
    TElAWSS3DataStorageBucket CreateBucket(string BucketName);
    TElAWSS3DataStorageBucket CreateBucket(string BucketName, string Location);
    TElAWSS3DataStorageBucket CreateBucket(string BucketName, string Location, TElStringList Headers);
    TElAWSS3DataStorageBucket CreateBucket(string BucketName, string Location, string ACL);
    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 Headers As TElStringList) 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 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, TStringList &Headers);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, TStringList *Headers);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, const std::string &ACL, TStringList &Headers);
    TElAWSS3DataStorageBucketHandle CreateBucket(const std::string &BucketName, const std::string &Location, const std::string &ACL, TStringList *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, TStringList $Headers)
    TElAWSS3DataStorageBucket CreateBucket(string $BucketName, string $Location, string $ACL, TStringList $Headers)

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)

See also:     DeleteBucket    

Discuss this help topic in SecureBlackbox Forum