Spectra Logic

1-800-833-1132 : 1-303-449-6400

Create Bucket (Put Bucket)

Description

Create a bucket. The default data policy for the user creating the bucket is assigned to the bucket. If a default data policy cannot be determined, the operation fails. No media are initially allotted. This is an Amazon S3 compatible operation.

When creating a bucket for use with a data policy including an Amazon S3 or Microsoft Azure replication target, the bucket name must adhere to the cloud target naming requirements. § For BlackPearl software version 3.5.2 or earlier, the BlackPearl system changes bucket names with upper case letters to all lower case letters when needed. If you are using bucket names that only differ by case, the buckets are combined on the cloud target causing possible data collision and bucket ownership/permission problems. § For BlueScale software version 4.0 or later, if the bucket name is incompatible with the naming requirements of the cloud target provider, bucket creation fails and an error is returned.

Notes:

§	The bucket name cannot contain a colon (:), forward slash (/), or space.

§	The bucket name cannot exceed 255 characters.

See Put Bucket for Amazon S3 operation details.

Also see Create Bucket - Spectra S3.

Requests

Syntax

PUT http[s]:/{datapathDNSname}/{bucket_name}/

{bucket_name} must be unique on the BlackPearl system.

Responses

Response Elements

The operation returns status only.

Notable status codes:

§	200: OK (success)

§	400: Bad Request (data policy cannot be determined, bucket name is not allowed)

§	403: Forbidden (user does not have permission for the data policy, bucket name is reserved)

§	409: Conflict (bucket already exists)

Example

Sample Request

This request creates the bucket named “bucket1”.

PUT http://blackpearl-hostname/bucket1 HTTP/1.1

Sample Response

HTTP/1.1 200 OK