Skip to main content

Create an S3 bucket

Contributors netapp-madkat netapp-perveilerk ssantho3 netapp-lhalbert

You can use the Tenant Manager to create S3 buckets for object data.

Before you begin
  • You are signed in to the Tenant Manager using a supported web browser.

  • You belong to a user group that has the Root access or Manage all buckets permission. These permissions override the permissions settings in group or bucket policies.

    Note Permissions to set or modify S3 Object Lock properties of buckets or objects can be granted by bucket policy or group policy.
  • If you plan to enable S3 Object Lock for a bucket, a grid admin has enabled the global S3 Object Lock setting for the StorageGRID system, and you have reviewed the requirements for S3 Object Lock buckets and objects. See Use S3 Object Lock to retain objects.

Access the wizard

  1. Select View buckets from the dashboard, or select STORAGE (S3) > Buckets.

  2. Select Create bucket.

Enter details

  1. Enter details for the bucket.

    Field Description

    Bucket name

    A name for the bucket that complies with these rules:

    • Must be unique across each StorageGRID system (not just unique within the tenant account).

    • Must be DNS compliant.

    • Must contain at least 3 and no more than 63 characters.

    • Each label must start and end with a lowercase letter or a number and can only use lowercase letters, numbers, and hyphens.

    • Should not use periods in virtual hosted style requests. Periods will cause problems with server wildcard certificate verification.

    Note: You can't change the bucket name after creating the bucket.


    The bucket's region.

    Your StorageGRID administrator manages the available regions. A bucket's region can affect the data-protection policy applied to objects. By default, all buckets are created in the us-east-1 region.

    Note: You can't change the region after creating the bucket.

  2. Select Continue.

Manage object settings

  1. Optionally, enable object versioning for the bucket.

    Enable object versioning if you want to store every version of each object in this bucket. You can then retrieve previous versions of an object as needed. You must enable object versioning if the bucket will be used for cross-grid replication.

  2. If the global S3 Object Lock setting is enabled, optionally enable S3 Object Lock for the bucket to store objects using a write-once-read-many (WORM) model.

    Enable S3 Object Lock for a bucket only if you need to keep objects for fixed amount of time, for example, to meet certain regulatory requirements. S3 Object Lock is a permanent setting that helps you prevent objects from being deleted or overwritten for a fixed amount of time or indefinitely.

    Important After the S3 Object Lock setting is enabled for a bucket, it can't be disabled. Anyone with the correct permissions can add objects to this bucket that can't be changed. You might not be able to delete these objects or the bucket itself.

    If you enable S3 Object Lock for a bucket, bucket versioning is enabled automatically.

  3. If you selected Enable S3 Object Lock, optionally enable Default retention for this bucket.

    When Default retention is enabled, new objects added to the bucket will be automatically protected from being deleted or overwritten. The Default retention setting does not apply to objects that have their own retention periods.

    1. If Default retention is enabled, specify a Default retention mode for the bucket.

      Default retention mode Description


      • The object can't be deleted until its retain-until-date is reached.

      • The object's retain-until-date can be increased, but it can't be decreased.

      • The object's retain-until-date can't be removed until that date is reached.


      • Users with the s3:BypassGovernanceRetention permission can use the x-amz-bypass-governance-retention: true request header to bypass retention settings.

      • These users can delete an object version before its retain-until-date is reached.

      • These users can increase, decrease, or remove an object's retain-until-date.

    2. If Default retention is enabled, specify the Default retention period for the bucket.

      The Default retention period indicates how long new objects added to this bucket should be retained, starting from the time they are ingested. Specify a value between 1 and 36,500 days or between 1 and 100 years, inclusive.

  4. Select Create bucket.

    The bucket is created and added to the table on the Buckets page.

  5. Optionally, select Go to bucket details page to view bucket details and perform additional configuration.