1 amazon.s3.createBucket

Creates a new Amazon S3 bucket with the specified name in the specified Amazon S3 region. Every object stored in Amazon S3 is contained within a bucket. Buckets partition the namespace of objects stored in Amazon S3 at the top level. Within a bucket, any name can be used for objects. However, bucket names must be unique across all of Amazon S3. Bucket ownership is similar to the ownership of Internet domain names. Within Amazon S3, only a single user owns each bucket. Once a uniquely named bucket is created in Amazon S3, organize and name the objects within the bucket in any way. Ownership of the bucket is retained as long as the owner has an Amazon S3 account. To conform with DNS requirements, the following constraints apply: Bucket names should not contain underscores Bucket names should be between 3 and 63 characters long Bucket names should not end with a dash Bucket names cannot contain adjacent periods Bucket names cannot contain dashes next to periods (e.g., "my-.bucket.com" and "my.-bucket" are invalid) Bucket names cannot contain uppercase characters There are no limits to the number of objects that can be stored in a bucket. Performance does not vary based on the number of buckets used. Store all objects within a single bucket or organize them across several buckets. Buckets cannot be nested; buckets cannot be created within other buckets. Do not make bucket create or delete calls in the high availability code path of an application. Create or delete buckets in a separate initialization or setup routine that runs less often. To create a bucket, authenticate with an account that has a valid AWS Access Key ID and is registered with Amazon S3. Anonymous requests are never allowed to create buckets.

<amazon.s3.createBucket
    bucketName='bucketName'
    maxKeys='maxKeys'
    access-key='access-key'
    secret-key='secret-key'
    region='region'
/>

Attributes
Name	Type	Required	Default	Description
AbucketName	String				Name of the bucket
AmaxKeys	Integer			1000	Maximum number of rows returned
Aaccess-key	String				The AWS access ke
Asecret-key	String				The AWS secret access key
Aregion	String				Sets the region to be used by the client. This will be used to determine both the service endpoint (eg: https://sns.us-west-1.amazonaws.com) and signing region (eg: us-west-1) for requests. If region is not explicitly provided as an attribute the DEFAULT_REGION_PROVIDER is consulted.

Example

Copy

<xsql-script>
    <body>
        <println><amazon.s3.createBucket bucketName='testjabbucket' /></println>
    </body>
</xsql-script>

Which prints in standard output:

Copy

S3Bucket [name=testjabbucket, creationDate=null, owner=null]