Home > Storage > PowerScale (Isilon) > Product Documentation > Protocols > Dell EMC PowerScale OneFS S3 Overview > Buckets
OneFS requires a bucket to map to a specific directory in an access zone. This directory is called the bucket path. If the bucket path is not specified, a default path is used, which is configurable at an access zone level through the WebUI or CLI. When creating a bucket, OneFS creates a directory with a prefix of .isi_s3_ under the bucket path, and creates 16 other subdirectories named 0 through 15 under the .isi_s3_ directory. An example of this name is .isi_s3_ 1_1000000010001. The 16 subdirectories are used to store temporary files for the PUT operation. OneFS automatically balances different temporary files between the directories for better performance. Figure 4 shows the process of putting an object to the OneFS cluster which uses the temporary directory under the bucket.
OneFS S3 bucket names comply with DNS naming conventions. The following rules are required for naming S3 buckets in OneFS:
Table 1 shows the supported S3 bucket operations in OneFS 9.0. See the document Dell EMC PowerScale: OneFS S3 API Guide on Dell.com/StorageResources for details about each supported API.
API name in AWS S3 API reference | Description |
PUT operation to create a bucket. Anonymous requests are never allowed to create buckets. By creating the bucket, the authenticated user becomes the bucket owner. | |
ListObjects | List objects in a bucket. |
ListObjectsV2 | List objects in a bucket. |
GetBucketLocation | Returns the location as an empty string. |
DeleteBucket | Delete the bucket. |
GetBucketAcl | Get the access control list (ACL) of a bucket. |
PutBucketAcl | Set the permissions on an existing bucket using ACLs. |
HeadBucket | Determine if a bucket exists and if you have permission to access it. The operation returns a 200 OK if the bucket exists and if you have permissions to access it. Otherwise, the operation might return responses such as 404 Not Found and 403 Forbidden. |
Get a list of all buckets owned by the authenticated user of the request. | |
ListMultipartUploads | List in-progress multipart uploads. An in-progress multipart upload is a multipart upload that has been initiated using the Initiate Multipart Upload request but has not yet been completed or aborted. |