Creating an S3 bucket

You can use the Tenant Manager to create S3 buckets for object data. When you create a bucket, you must specify the bucket's name and region. Optionally, you can also specify compliance settings for the objects in the bucket.

Before you begin

About this task

You can also create S3 buckets using the Tenant Management API or the S3 REST API. If you need to delete a bucket, you must use the S3 API.


  1. Select S3 > Buckets.
    The Buckets page appears, listing any buckets that have already been created.
  2. Select Create Bucket.
    The Create Bucket dialog box appears.
    • If the global Compliance setting is disabled, this dialog box includes Name and Region fields.

      screenshot Create Bucket modal is global Compliance is disabled

    • If the global Compliance setting is enabled, this dialog box also includes a Compliance section and an Enable Compliance check box.

      Create Bucket modal when compliance is enabled

  3. Enter a unique name for the bucket.
    Bucket names must comply with these rules:
    • Must be unique across each StorageGRID system (not just unique within the tenant account).
    • Must be DNS compliant.
    • Must contain between 3 and 63 characters.
    • Can be a series of one or more labels, with adjacent labels separated by a period. Each label must start and end with a lowercase letter or a number and can only use lowercase letters, numbers, and hyphens.
    • Must not look like a text-formatted IP address.
    • Should not use periods in virtual hosted-style requests because periods will cause problems with server wildcard certificate verification.
    Note: See the Amazon Web Services (AWS) Documentation for more information.
  4. From the Region drop-down list, select the region for this bucket.
    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. Contact your StorageGRID administrator to learn which region you should select.
    Attention: You cannot change the region after saving the bucket.
  5. If the page does not include a Compliance section or you do not want to create a compliant bucket, click Save.
    Attention: You cannot enable compliance after saving the bucket.
    The new bucket is saved and added to the list on the Buckets page.
  6. If the page includes a Compliance section and you want to create a compliant bucket, specify the compliance settings.
    1. Select the Enable compliance check box.
      Attention: You cannot disable compliance after saving the bucket.

      Additional compliance fields appear.

      screen shot showing additional compliance fields

    2. In the Retention Period box, specify the length of the retention period for objects added to this bucket, in days.

      The retention period for an object starts when that object is ingested into the grid. After you save the bucket, you can increase the retention period, but you cannot decrease this value.

      You can enter any number greater than or equal to 0.001. Fractional numbers of minutes are rounded to the nearest integer. For example, if you enter 0.001 (1.44 minutes), the system sets the retention period to 1 minute.
      Note: If you want to test compliance settings before implementing this feature in a production-level grid, you can specify a very short duration for the retention period. However, be aware that it will take longer than an hour to automatically delete objects in compliant buckets, even if the retention period is very short. This is because of time required for ILM scanning.
    3. For After Retention Period, select what should happen to each object at the end of its retention period.
      Option Description
      allow users to delete objects Users can delete an object manually as soon as its retention period expires, unless the bucket is under a legal hold.
      delete objects automatically An object will be deleted automatically when its retention period expires, unless the bucket is under a legal hold.
    4. If you need to put all objects in this bucket under a legal hold, select the Legal Hold check box.
      When Legal Hold is selected, objects in this bucket cannot be deleted, even if their retention period has expired.
    5. Click Save.
      The Confirm Retention Period dialog box appears.
    6. If you are sure you want to save this bucket with its current settings, re-enter the number of days each object must be preserved.

      screen shot of Confirm Bucket Create dialog box
    7. Click OK.
      The compliant bucket is saved and added to the list on the Buckets page.