Dell ObjectScale Application 1.3.x Installation Guide for Red Hat OpenShift

Create a bucket

This section describes how to set up a new bucket using the ObjectScale Portal user interface.

1. From the ObjectScale Portal user interface, click Buckets.
   The list of Buckets that the user is authorized to view is displayed.
2. Use the Namespace and Object store fields at the top of the Buckets page to locate the object store in which you want to create the bucket.
   1. Select the namespace from the namespace drop-down on the top of the Buckets page.
   2. Select the name of the object store that contains the bucket.
3. Click New Bucket.
   The New Bucket wizard appears.
4. In the General page, complete the required fields and then click Next:

   Option	Description
   Name	Type a name for the new bucket. Bucket names can consist only of lowercase letters, numbers, dots (.), and hyphens (-).
   Namespace	Select the namespace. Only the namespaces for which the user has edit permissions are listed in the dropdown.
   Object Store Name	Select the object store from the ObjectStore dropdown menu within which to create the bucket.
   Bucket Owner Account	Select the bucket owner account from the Bucket Owner Account dropdown menu. To select any account, first remove the selected account to see all accounts, and click the dropdown to list all accounts. Select an account from the data list, or you can begin typing the account id to the Bucket Owner Account data list.

5. In the Policy page, describe the policy to apply to the bucket and then click Next.
   For more detailed information about creating a bucket policy statement, see the "About bucket policies" section in the ObjectScale 1.3 Administration Guide.
   1. Switch to the Text view of the policy editor by clicking between the View and Text views of the policy editor.
   2. In the Policy editor text field, type the JSON-formatted policy or copy and paste a previously created policy. The syntax for policies is the same as the syntax used for Amazon AWS.
   3. Provided your policy is valid, you can switch to the tree view of the Policy. The tree view makes it easier to view your policy and to expand and contract statements.
6. In the Controls page, complete the required fields and then click Next.

   Option	Description
   Versioning	To maintain multiple versions of the same object within the bucket, set Versioning to On. To maintain a single version of an object, keep Versioning Off. For more information, see the "Versioning configuration and effects on bucket operations" section in the ObjectScale 1.3 Administration Guide.
   Object Lock	Enable Object Lock to protect objects from deletion or overwrite, for a fixed amount of time or indefinitely, depending on the configuration. When Versioning is On, Object Lock protects versions. When Versioning is Off (or edited later to Suspended), Object Lock applies to the object. Delete object and overwrite object operations are blocked for objects in the bucket with a lock that is still in effect. Optionally set a default Object Lock retention mode for the objects in this bucket. Objects are automatically locked when they are added to a bucket that has a configured default retention lock. The default retention lock is applied to objects even if the user does not have s3:PutObjectLegalHold and s3:PutObjectRetention permissions. Available lock types are: GOVERNANCE COMPLIANCE NONE (Object Lock is enabled, but the retention mode is not set.) If GOVERNANACE or COMPLIANCE is selected, you can optionally set a Retention period. Select either Days or Years and type the number of days or years for the period. This setting is a default retention period for the bucket. Objects can have explicit retention periods set for them. An explicit retention period set on an object supersedes this bucket default retention period. Object Lock is Off by default. For more information about Object Lock states and how Object Lock works with the different versioning states, see the "Object Lock configuration and the effects on bucket operations" section in the ObjectScale 1.3 Administration Guide.
   Quotas	Quotas is disabled by default. Enable Quotas for the bucket. When enabled, you can set the storage level or the object count level in ObjectScale that results in: Block writes at Quota—a hard quota Notification at Quota—a soft quota If a Default Bucket Quota is set at the account level when you are adding quotas to an object store, the same value is set for Block Writes At. You can update quota values or disable the Quotas field in the bucket.
   Encryption	Enable encryption to save the bucket data in an encrypted format. If Encryption was enabled at the account level when add to object store, you cannot disable encryption in the bucket. Encryption is disabled by default. NOTE:Encryption cannot be disabled after you create the bucket with encryption enabled.
   Bucket Logging	Enable Bucket logging to log requests for a specific source bucket to a designated target bucket in a consistent format. Enter the name of the target bucket in the Target Bucket field. Enter an optional prefix to prepend to generated log files in the Prefix for Bucket Logging files field. NOTE: The target bucket must be configured to allow bucket logging before allowing a source bucket to set it as a target. The prefix makes it easier to locate log objects. Multiple source buckets can share the same prefix.

7. In the Event Rule page, complete the required fields and then click Next.
   For more information about editing bucket event notifications, see .
   You must have at least one notification destination for this account to set up a bucket event rule.

   Option	Description
   Event Rule Name	Type a name for the new event.
   Events	Select one or more event types that trigger this event notification.
   Prefix/Suffix	Type the object prefix or suffix values that trigger this event notification.
   Send To	Select the notification destination to be used to send the notifications for the configured events.

   NOTE:Click Add Event Rule to add multiple event rules. You cannot create configurations on the same bucket that share a common event type.
8. Finally, use the Review page to review the values for configuring the new bucket and click Save.
   If necessary, click Edit to modify any of the values.