This section explains how to use the qq s3_modify_bucket command.

For more information, see Managing Access Policies for an S3 Bucket in a Qumulo Cluster in the Qumulo Administrator Guide.

Examples

To Enable Versioning for an S3 Bucket

Run the qq s3_modify_bucket command, specify the bucket name, and use the --enable-versioning flag. For example:

qq s3_modify_bucket \
  --name MyBucket \
  --enable-versioning

The following is example output. All times are in the UTC time zone.

{
  "creation_time": "2024-05-22T21:42:11.295718303Z",
  "name": "MyBucket",
  "path": "/my-bucket",
  "versioning": "Enabled"
}

To Suspend Versioning for an S3 Bucket

Run the qq s3_modify_bucket command, specify the bucket name, and use the --suspend-versioning flag.

Description

Modify the settings of the given bucket. Use this command to update the bucket versioning state. Using this command to enable anonymous access to a bucket has been disabled, use s3_set_bucket_policy instead.

Usage

qq s3_modify_bucket [-h] --name NAME [--suspend-versioning | --enable-versioning] [--enable-object-lock-without-retention | --enable-object-lock-with-retention-days RETENTION_DAYS | --enable-object-lock-with-retention-years RETENTION_YEARS]

Flags

Flag Name Required Description
--name Yes The name of the bucket to be modified
--suspend-versioning No Suspends object versioning
--enable-versioning No Enables object versioning
--enable-object-lock-without-retention No Enable Object Lock with no default retention period. (Requires versioning to be enabled for the specified S3 bucket.)
--enable-object-lock-with-retention-days No Enable Object Lock with the retention period specified in days.
--enable-object-lock-with-retention-years No Enable Object Lock with the retention period specified in years.