Go to main content

Oracle® ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.0

Exit Print View

Updated: January 2019
 
 

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. For more details about using the PUT Bucket operation, see the following:

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 Amazon's official S3 PUT Bucket API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUT.html).

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 Figure 9, Table 9, Supported 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 Amazon's official S3 PUT Bucket API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUT.html).
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