Home > Storage > PowerScale (Isilon) > Product Documentation > Protocols > Dell PowerScale: OneFS S3 API Guide > CreateBucket
Table 2 shows the details about the OneFS S3 CreateBucket API request parameters and request body. If not specified, all unsupported request parameters and the request body are silently ignored by OneFS without an error code being returned to client.
Request parameters/body | Supported | Description |
Bucket | Yes | Required: Yes This is the name of the bucket to create. Bucket names must consist of characters, including lowercase letters (a-z), numbers (0-9), or dashes (-). Bucket names must start or end with a lowercase letter (a-z) or number (0-9). Bucket names must be 3–63 characters in length. |
x-isi-path | Yes | This is an optional OneFS extended header where a OneFS directory can be specified as the bucket path. OneFS creates the directory implicitly if the directory does not exist. See appendix A for an example. |
x-amz-acl | Yes | This is the canned ACL to apply to the bucket. Valid values: private, public-read, public-read-write, authenticated-read |
x-amz-bucket-object-lock-enabled | No | N/A |
x-amz-grant-full-control | Yes | This allows the grantee the read, write, read ACP, and write ACP permissions on the bucket. |
x-amz-grant-read | Yes | This allows the grantee to list the objects in the bucket. |
x-amz-grant-read-acp | Yes | This allows the grantee to read the bucket ACL. |
x-amz-grant-write | Yes | This allows the grantee to create, overwrite, and delete any object in the bucket. |
x-amz-grant-write-acp | Yes | This allows the grantee to write the ACL for the applicable bucket. |
CreateBucketConfiguration | No | N/A |
LocationConstraint | No | N/A. OneFS sets the bucket location to empty string. |
Note: Amazon S3 allows specifying a grantee using the following headers: email address, id, uri in the x-amz-grant-read, x-amz-grant-write, x-amz-grant-read-acp, x-amz-grant-write-acp, and x-amz-grant-full-control. OneFS does not support the email address to specify a grantee, and 501 NotImplemented code is returned.