PUT Bucket

The PUT Bucket operation creates a new bucket. To create a bucket with this operation, you must have an Oracle ZFS Storage Appliance user account and a valid Access Key assigned to your user account. Anonymous requests are never allowed to create buckets. When you create a bucket, you automatically become the bucket owner. Optionally, a bucket owner can grant permissions to other appliance users or predefined groups.

Syntax Example

PUT https://appliance:443/s3/v1/export/share_mount_point_path/bucketname
      

Request Parameters

The PUT Bucket operation does not support the use of request parameters.

Request Headers

In addition to supporting common request headers, the PUT Bucket operation also supports headers for specifying canned ACLs and specific ACL access permissions for appliance users and predefined groups. For further details about these request headers, see PUT Bucket.

Request Elements

This implementation of the PUT Bucket operation does not support the use of request elements.

Response Headers

The PUT Bucket operation uses only response headers that are common to most responses. For more information, see table "Supported Response Headers" in Supported Common Response Headers.

Response Elements

This implementation of the PUT Bucket operation does not return response elements.

Error Response Code

The PUT Bucket API does not return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

Note:

For additional request and response examples, see PUT Bucket.
PUT HTTP/1.1
x-amz-date: Sat, 07 Apr 2018 00:54:40 GMT
Authorization: authorization string
x-amz-grant-write: id="scobby", id="shaggy"

HTTP/1.1 200