Create a bucket

You can create and configure S3, S3+FS, or CAS buckets in the ECS Portal.

Before you begin

  • This operation requires the System Administrator or Namespace Administrator role in ECS.
  • A System Administrator can create buckets in any namespace.
  • A Namespace Administrator can create buckets in the namespace in which they are the administrator.

About this task

For CAS-specific instructions on setting up a CAS bucket for a CAS object user, see the ECS Data Access Guide, available from the ECS Product Documentation page.

Procedure

  1. In the ECS Portal, select Manage > Buckets.
  2. On the Bucket Management page, click New Bucket.
  3. On the New Bucket page, on the Basic tab, do the following:
    1. In the Name field, type the bucket name.
    2. In the Namespace field, select the namespace that you want the bucket and its objects to belong to.
    3. In the Replication Group field, select the replication group that you want to associate the bucket with.
    4. In the Bucket Owner field, type the bucket owner, or select the Set current user as Bucket Owner checkbox.
      The bucket owner must be an ECS object user for the namespace. If you do not specify a user, you are assigned as the owner. However, you cannot access the bucket unless your username is also assigned as an object user.
      The user that you specify is given Full Control.
    5. Click Next.
  4. On the New Bucket page, on the Required tab, do the following:
    1. In the File System field, click On to specify that the bucket supports operation as a file system (for NFS or HDFS access).
      The bucket will be an S3 bucket that supports file systems.
      You can set a default UNIX group for access to the bucket and for objects created in the bucket. For more information, see Default group.
    2. In the CAS field, click On to set the bucket as a CAS bucket.
      By default, CAS is disabled and the bucket is marked as an S3 bucket.
      In the Reflection Expiration field, click On to configure an expiration time for reflections in the bucket.
      In the Reflection Age field, select the appropriate expiration time. (The minimum expiration time is 1 day and the maximum is 99 years.)
      If there is no configured expiration time for a reflection, the reflection is never deleted.
    3. In the Metadata Search field, click On to specify that the bucket supports searches based on object metadata.
      If the Metadata Search setting is turned on, you can add user and system metadata keys that are used to create object indexes. For more information on entering metadata search keys, see Metadata search fields.
      If the bucket supports CAS, metadata search is automatically enabled and a CreateTime key is automatically created. The metadata can be searched using the S3 metadata search capability or using the Centera API.
    4. In the Access During Outage field, click On if you want the bucket to be available during a temporary site outage. For more information on this option, see TSO behavior with the ADO bucket setting turned on.
      • If the Access During Outage setting is turned on, you have the option of selecting the Read-Only checkbox to restrict create, update, or delete operations on the objects in the bucket during a temporary site outage. Note that once you turn the Read-Only option on for the bucket, you cannot change it after the bucket is created. For more information on this option, see TSO behavior with the ADO bucket setting turned on.
    5. In the Server-side Encryption field, click On to specify that the bucket is encrypted.
    6. Click Next.
  5. On the New Bucket page, on the Optional tab, do the following:
    1. In the Quota field, click On to specify a quota for the bucket and select the quota setting you require.
      The settings you can specify are described in Bucket settings.
    2. In the Bucket Tagging field, click Add to add tags, and type name-value pairs.
      For more information, see Bucket tagging.
    3. In the Bucket Retention Period field, type a time period to set a bucket retention period for the bucket, or click Infinite if you want objects in the bucket to be retained forever.
      For more information on retention periods, see Retention periods and policies.
    4. In the Auto-Commit Period field, type a time period to allow updates to the files that are under retention. The interval applies only to file enabled buckets.
      The auto-commit value must be less than or equal to the retention value with a maximum of 1 day. A value of 0 indicates no auto-commit period.
    5. Click Save to create the bucket.

Results

To assign permissions on the bucket for users or groups, see the tasks later in this section.