Dell ObjectScale 1.3 Administration Guide

Edit a bucket

On the ObjectScale Portal user interface, edit the details of existing buckets.

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, Object store, Account, and Bucket name fields at the top of the Buckets page to locate the bucket.
   1. Select the appropriate 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. Select the account from the Accounts dropdown.
      To select another account, remove the current account to see all the available accounts. Then, select another account, by either using the dropdown to display all accounts, or by typing the account id into to the Select an account field to dynamically filter the list of accounts.
   4. Optionally, type at least the first three characters of a Bucket name to filter the list of buckets.
3. Select the bucket to modify and click Edit.
   The Edit Bucket wizard appears.
4. Select one or more of the sections with the bucket values to modify:
   • General (Review only, no edit.)
   • Policy
   • Controls
   • Event Rules
5. In the Policy page, modify the policy to apply to the bucket and then click Next.
   For more detailed information about editing a bucket policy statement, see About bucket policies.
   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, modify the required fields and then click Next.

   Option	Description
   Versioning	When Versioning is Off, you can change it to On. When Versioning is On, you can change it to Suspended. To maintain multiple versions of the same object in a bucket, set Versioning to On. To maintain a single version of each object, keep Versioning OFF or change it to Suspended. For more information, see Versioning configuration and effects on bucket operations.
   Object Lock	Object Lock allows objects to be locked or protected from deletion or overwriting, 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 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. You can change Object Lock from Off to On. If Object Lock is set to On, you cannot change it to Off. You can modify the default Object Lock retention mode and retention period. The Object Lock Retention mode is a default retention mode for new objects that are added to the 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 a retention mode is not set.) If the mode is GOVERNANACE or COMPLIANCE, you can set or change the 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. NOTE:Setting a default retention on a bucket does not set any retention settings on objects that are already in the bucket. Changing the bucket default retention period does not change the existing retention period for any objects in that bucket. For more information about Object Lock states and how Object Lock works with the different versioning states, see Object Lock configuration and the effects on bucket operations.
   Quotas	Enable quotas for the bucket. When quotas are enabled, you can set the storage level or object count level in ObjectScale that results in: Block writes at Quota—a hard quota Notification at Quota—a soft quota
   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 a 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.

7. In the Event Rule page, modify the required fields and then click Next.
   For more detailed information about editing bucket event notifications, see Setting up bucket event notifications.
   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 use to send the notifications for the configured events.

8. After making the necessary changes, click Save.