Chapter 4. Creating and managing buckets using MCG object browser

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.

3. Select one of the following options to create the buckets:

   • Create via Object Bucket Claim

     Note

     For RGW object bucket claims (OBCs), you must use the credentials associated with the OBC to access the newly created bucket. RGW administrator credentials cannot be used to access these buckets.

     1. Select a namespace.
     2. Enter the ObjectBucketClaim name.
     3. Select the storage class.
     4. Select the bucket class
     5. Select the Enable replication to obtain higher resiliency of the objects stored in the buckets.
     6. Click Create using ObjectBucketClaim.

   • Create via S3 API

     1. Enter a name for the bucket.
     2. Add tags with different key and value criteria to tag your bucket.
     3. Click Create.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.

2. Click the Buckets tab.

   All the MCG buckets that are created are listed in the page.

3. Select the required bucket.
4. Click the Details tab.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab and select the required bucket.
3. Click the Objects tab.

4. Select the required object.

   A sidebar pops-up with the object details.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab and select the required bucket.
3. Select the Objects tab.
4. In the options menu corresponding to the required object, select either Download or Preview based on your requirement.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab and select the required bucket.
3. Select the Objects tab.
4. In the options menu corresponding to the required object, select Share with presigned URL.
5. Select the expiration time to set the validity period of the presigned URL
6. Click Create.
7. Copy the generated URL.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab and select the required bucket.
3. Select the Objects tab.

4. In the Add objects section, do one of the following:

   • To upload a folder, click Upload and select the folder that you want to upload from the browser.
   • To upload specific files, drag and drop the files.

5. Click on the object that you added.

   A window with the Overview and Versions tab opens up for the object where you can get an overview of the object and the different versions of the object if the versioning is enabled.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab and select the required bucket.
3. Select the Objects tab.
4. Click Create folder.
5. Enter a name for the folder that satisfies the requirements.

6. Click Create.

   You are redirected inside the new folder.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab and select the required bucket.
3. Select the Objects tab.

4. To delete the object, do one of the following:

   • To delete multiple objects together, select multiple objects using the checkbox and then from the Actions menu select Delete.
   • To delete a single object, select the Action menu corresponding to the object and select Delete.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.
3. In the options menu corresponding to the required bucket, select Empty bucket.
4. Enter the bucket name for confirmation and click Empty bucket.
5. After the bucket is empty, in the options menu corresponding to the bucket, select Delete bucket.
6. Enter the bucket name for confirmation and click Delete bucket.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.

3. Select a bucket for which the lifecycle rule needs to be created.

   You can also create a new bucket using the steps from the Creating a new bucket using the MCG Object browser section.

4. In the bucket view, click the Management tab.
5. Click on Create lifecycle rule.
6. Enter a name for the lifecycle rule.

7. Select one of the following Rule scope.

   Rules can be created for either a specific subset of objects within a bucket or all objects in the bucket.

   • Targeted

     • Add any or all of the following filters to apply the rule for the specific object:

       • Prefix
       • Object tags
       • Object size
   • Global (Bucket-wide)

8. Define at least one lifecycle rule.

   • Delete an object after a specified time

     For a versioned bucket, the current version of the object is retained as a noncurrent version. For a nonversioned object, the object is deleted permanently.

   • Noncurrent versions of the objects

     This rule which applies to only the versioned objects deletes the older versions of the objects after they become noncurrent.

   • Incomplete multipart uploads

     This rule cleans up the abandoned uploads that were initiated but never completed after a specified period of time to prevent unnecessary storage costs. The object tags and size filter that were specified for the object with the targeted rule scope are not applicable for this rule and it deletes all multipart uploads from the bucket regardless of any filter.

   • Expired object delete markers

     This rule removes any unnecessary delete markers in versioned buckets that do not have any associated object versions, which might clutter bucket listings. The object tags and size filter that were specified for the object with the targeted rule scope are not applicable for this rule and it deletes all multipart uploads from the bucket regardless of any filter.

     Note
     • The object tags and object size filters are not applicable for this rule. The expired object delete markers are removed from the bucket regardless of any filters that are configured.
     • This rule is not enabled when delete an object after a specified time rule is selected.

9. Click Save.

   The newly created rule is listed in the Lifecycle rules page.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.
3. Select a bucket for which the lifecycle rule needs to be edited.
4. In the bucket view, click the Management tab.
5. In the Lifecycle rules tab, existing rules are listed.
6. Select the rule that you want to edit and from the Action menu select Edit lifecycle rule.
7. Edit the required fields and click Save.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.
3. Select a bucket for which you need to create the CORS rule.
4. In the bucket view, click the Permission tab and then click the CORS tab.
5. Click Create CORS rule.
6. Provide a name for the rule.

7. Select one of the following for Allowed origins:

   • All origins to allow requests from all domains

   • Custom origins to allow requests only from specified domains:

     1. You can add the required domains under Origin.
8. Select the required Allowed methods.

9. Select one of the following for Allowed headers:

   • All headers to allow all headers

   • Custom headers to restrict access to the specified headers

     1. You can add required headers under the Exposed header.
10. Enter the maximum age of preflight request in seconds.
11. Click Create.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.
3. Select a bucket for which you need to edit the CORS rule.
4. In the bucket view, click the Permission tab and then click the CORS tab.
5. Select the CORS rule that you want to edit.
6. From the Actions menu, click Edit configuration.
7. Modify the required fields.
8. Click Save.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.
3. Select a bucket for which you need to set a policy.
4. In the bucket view, click the Permission tab.

5. In the Bucket policy tab, you can do one of the following:

   • When no policy exists, you can do one of the following:

     • Drag a file from another location or upload a file using the Browse button.

     • Start from scratch or use a predefined policy configuration. Select Use a predefined policy configuration.

       1. Create a new policy or choose a policy from Available policies.
       2. Update the policy as required.
       3. Click Apply policy.
       4. Click Confirm to update the policy after reviewing the changes.

   • When a policy already exists, use a predefined policy configuration by selecting the Edit bucket policy from the Action menu.

     1. Select Use a predefined policy configuration.
     2. Choose a policy from Available policies.
     3. Update the policy as required.
     4. Click Apply policy.
     5. Click Confirm to update the policy after reviewing the changes.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.
3. Select a bucket for which you need to enable versioning for the objects.
4. Click the Properties tab.
5. Toggle Versioning to Enabled if you want to enable versioning or switch to Disabled if you want to suspend versioning of objects.
6. Click Enable or Suspend to confirm depending on your versioning selection.

Procedure

1. In the OpenShift Web Console, click Storage Object Storage.
2. Click the Buckets tab.
3. Select a bucket in which you need to list the versions of the objects.
4. Click the Objects tab.

5. Toggle the List all versions.

   • When List all versions is off:

     • The current version of the object excluding the delete markers is displayed.
     • Any Action menu actions are only performed for the latest or the current version.
     • To view all the versions of a particular object you need to click on that object. It opens up a side bar and in the Versions tab of the sidebar all the versions of the object is displayed.
     • Any Action menu option on the Versions sidebar table can be performed on that particular object version.

   • When List all versions is on:

     • All object versions including deleted objects that have delete markers are displayed. Each version of an object is listed as a separate row making it easier to track changes, restore previous versions, recover deleted data or permanently delete objects.
     • If you delete a specific version of an object, it is permanently deleted and cannot be undone.
     • If you remove a delete marker, the object is restored to its most recent version, which makes it accessible again. If no previous version exists, the object is permanently deleted.