Table of ContentsView in Frames

Operations on buckets

The StorageGRID Webscale system implements operations on buckets differently than the Amazon S3 REST API.

The StorageGRID Webscale system supports a maximum of 100 buckets per S3 account.

Bucket name restrictions follow the AWS United States Standard region restrictions.

The following table describes which operations on buckets are implemented, and how they are implemented, in the StorageGRID Webscale system.

Operation Implementation
DELETE Bucket Implemented with all Amazon S3 REST API behavior.
DELETE Bucket policy If the necessary access credentials are provided for the account, this operation deletes the policy attached to the bucket. For information about the policy language supported by the StorageGRID Webscale system, see Group and bucket access policies.
GET Bucket (List Objects)

The Storage Class for objects is always listed as STANDARD, even when the object was ingested with the REDUCED_REDUNDANCY storage class specified. When an object is ingested into StorageGRID Webscale with the REDUCED_REDUNDANCY storage class, it means that the object is ingested using a single-commit ingest operation. It does not result in the object being stored at lower levels of redundancy in the StorageGRID Webscale system.

Requests that traverse a large number of keys require special handling:

  • The request might return a truncated response that contains fewer keys than the max-keys parameter value. For example, if many keys contain a slash ("/"), then a GET /bucket/?delimiter='/' request would traverse at least all of these keys and the response might not return all of the expected results to avoid timing out.
  • The request might return an empty response to avoid timing out, and contain a NextMarker value to retrieve the next set of values.

To get the complete set of results, you need to continue making requests while updating the marker parameter, as you normally do with a truncated result. Always use NextMarker if it is present. In some cases, the StorageGRID Webscale implementation of the S3 REST API returns a NextMarker, when the Amazon S3 REST API would not, because it is a better marker than the last key returned.

GET Bucket acl If the necessary access credentials are provided for the account, this operation returns a positive response and the ID, DisplayName, and Permission of the bucket owner, indicating that the owner has full access to the bucket.
GET Bucket location If the necessary access credentials are provided for the account, this operation will return an empty string for the bucket's region. Buckets are not location constrained in StorageGRID Webscale.
GET Bucket policy If the necessary access credentials are provided for the account, this operation returns the policy attached to the bucket. For information about the policy language supported by the StorageGRID Webscale system, see Group and bucket access policies.
GET Bucket versioning

GET Bucket versioning requests are supported for compatibility, but always return a response indicating that versioning has not been enabled.

HEAD Bucket Implemented with all Amazon S3 REST API behavior.
PUT Bucket

Location constraints are ignored.

PUT Bucket policy If the necessary access credentials are provided for the account, this operation sets the policy attached to the bucket. For information about the policy language supported by the StorageGRID Webscale system, see Group and bucket access policies.