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. 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
