Skip to main content

CreateBucket

note

This action creates an Astran S3 bucket.

Creates a new S3 bucket. To create a bucket, you must set up Astran S3 and have a valid AWS Access Key ID to authenticate requests. Anonymous requests are never allowed to create buckets.

Permissions​

ActionDescriptionResource
CreateBucketGrants permission to create a new bucketbucket

The following operations are related to CreateBucket:

Request Syntax​

PUT /Bucket HTTP/1.1
Host: <partition>.s3.astran.io

URI Request Parameters​

The request uses the following URI parameters.

Bucket

The name of the bucket to create.

Required: Yes

Response Syntax​

HTTP/1.1 200
Location: Location

Response Elements​

If the action is successful, the service sends back an HTTP 200 response.

The response returns the following HTTP headers.

Location

A forward slash followed by the name of the bucket.

Errors​

BucketAlreadyExists

The requested bucket name is not available. The bucket namespace is shared by all users of the system. Select a different name and try again.

HTTP Status Code: 409

Examples​

This request creates a bucket named colorpictures.

            PUT /colorpictures HTTP/1.1
            Host: <partition>.s3.astran.io
            Content-Length: 0
            Date: Wed, 01 Mar  2006 12:00:00 GMT
            Authorization: authorization string

This example illustrates one usage of CreateBucket.

            HTTP/1.1 200 OK
            x-request-id: 236A8905248E5A01
            Date: Wed, 01 Mar  2006 12:00:00 GMT

            Location: /colorpictures
            Content-Length: 0

See Also​

For more information about using this API in one of the language-specific AWS SDKs, see the following: