Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Object management

An object is any file or document contained within a bucket. All objects that are currently stored in a bucket can be viewed from the Browse tab, which is selected by default.

GUID-2FCCA895-4538-4E04-9D37-3C56234A6C52-low.png

On the object page, you can view the following information:

  • Bucket name: The name of the object
  • Size: The size of the object (in MB, GB, TB, or PB)
  • Storage class: The selected storage class for the bucket
    NoteCurrently, the S3 Standard class is the only supported storage class.
  • Owner: The user that owns the object

Using objects

You are provided basic functionality with your bucket to manage the the objects stored inside of it. Similar to file storage on the internet, objects can be uploaded to the bucket, downloaded from the bucket, and have authentication applied to them. You can also view information specific to the file or versions of the file.

Uploading an object to a bucket

When uploading an object, you can add files up to 5GB in size. The changes may take up to 60 seconds to display in your bucket.

To upload an object:

Procedure

  1. From the Buckets page, select the bucket containing the object.

  2. Click Upload Object.

    The Upload Object screen appears.
  3. To upload an object, drag and drop a file or browse for one by clicking Select files.

    The object appears listed beneath the drag and drop window and a checkmark confirms when it has finished uploading to the bucket.
  4. When you are finished uploading, close the Upload Object window.

    The object appears in your selected bucket.

Downloading an object

To download an object:

Procedure

  1. From the Buckets page, select the bucket containing the object.

  2. Click the more icon at the righthand side of the object you want to download.

  3. Click Download.

Generating an authenticated link for an object

Authenticated links can be generated that provide you with direct access to an object, with date and time fields that can be manually set to expire. All authenticated links expire after a maximum of seven days.

Procedure

  1. From the Buckets page, select the bucket containing the object.

  2. Click the more icon at the righthand side of the object you want to link to.

  3. To create a link, click Generate link.

  4. Enter your Access key and Secret key and then click Next.

  5. In the Link expiration fields, set your values for the retention length of the link.

  6. Click Copy link.

    The link is copied to your clipboard.

Viewing the details of an object

To display the details of an object:

Procedure

  1. From the Buckets page, select the bucket containing the object.

  2. Click the more icon at the righthand side of the object with properties you want to view.

  3. Click View properties.

    Object properties are displayed.
  4. When finished, click Done.

Viewing the versions of an object

When viewing different versions of an object, you can see which objects have object lock or retention set on them.

To display the different versions of an object.

Procedure

  1. From the Buckets page, select the bucket containing the object.

  2. Click the more icon at the righthand side of the object with different versions you want to view.

  3. Click View versions.

    All versions of the selected object are displayed.
  4. When finished, click Done.

Deleting objects

When you delete an object or a version of an object, it is removed from the object list but a delete marker is created, allowing for the data associated with it to be restored to full functionality at any point.

TipWhen deleting objects, it can take up to 60 seconds for the change to display in your bucket.

Deleting an object

When you delete an object, the object is removed from the bucket and a delete marker is created, allowing you to restore it at a later time. See Displaying deleted objects and directories and Restoring a deleted object.

To delete an object:

Procedure

  1. From the Buckets page, select the bucket containing the object you want to delete.

  2. Click the more icon at the righthand side of the object.

  3. Click Delete.

    The object is deleted from the bucket.

Deleting multiple objects

When you delete objects, delete markers are created for each one, which can be used to restore them at a later time.

To delete multiple objects:

Procedure

  1. From the Buckets page, select the bucket containing the object you want to delete.

  2. Select the objects you want to delete by using their checkboxes. Additionally, you can select all objects in a bucket by clicking All on the object selection bar.

  3. From the righthand side of the object selection bar, click Delete.

    The objects are deleted from the bucket.

Displaying deleted objects and directories

When an object or a directory is deleted, it is not permanently removed from the bucket. A delete marker is created which maintains a copy of it until it is destroyed. At any point during your usage of the S3 Console, deleted objects and directories can be renabled and displayed.

To display deleted objects and directories:

Procedure

  1. From the Buckets page, navigate to the bucket containing the deleted objects and directories you want to view.

  2. Click the Show deleted objects box.

    Your deleted objects and directories now display with a trashcan icon next to them.

Restoring objects

When you restore an object or a version of an object, the delete marker that was created when it was deleted is fully restored, returning it back to its full functionality.

Restoring a deleted object

To restore a deleted object, you must first enable it to view its delete marker. See Displaying deleted objects and directories.

To restore a deleted object:

Procedure

  1. From the Buckets page, select the bucket containing the object you want to restore.

  2. Click the more icon at the righthand side of the object, noted by its trashcan icon.

  3. Click Restore.

    The object is restored to the bucket.

Restoring multiple deleted objects

To restore multiple deleted objects, you must first enable them to view their delete markers. See Displaying deleted objects and directories.

To restore multiple deleted objects:

Procedure

  1. From the Buckets page, select the bucket containing the objects you want to restore.

  2. Click the checkboxes associated with the deleted objects.

  3. From the righthand side of the object selection bar, click Restore.

    The objects are restored to the bucket.

Restoring a version of an object

ImportantWhen recovering a version of an object, the object's tags are preserved but it will lose its metadata in the recovery.

To restore a version of an object:

Procedure

  1. From the Buckets page, select the bucket containing the object version you want to restore.

  2. Navigate to the object and then click its more icon.

  3. Select View versions.

    All versions of the selected object are displayed.
  4. Click the more icon at the righthand side of the version you want to restore and select Restore Data.

    The object version is now restored to your bucket.

Destroying objects

Destroying objects and their versions is different from deleting them in that it completely removes them from your bucket. It destroys all delete markers associated with the object or the specific version of an object, preventing any future recovery over the lifetime of the bucket. When you destroy an object, it is completely removed from your cloud storage.

Destroying an object

WARNINGDestroying an object cannot be undone.

To destroy an object:

Procedure

  1. From the Buckets page, select the bucket containing the object you want to destroy.

  2. Click the Show deleted objects box.

    Your deleted object is now displayed with a trashcan icon next to it.
  3. Click the more icon at the righthand side of the object.

  4. Click Destroy.

  5. Type YES and then click Confirm Destroy.

    The object is permanently removed from the bucket.

Destroying multiple objects

WARNINGDestroying objects cannot be undone.

To destroy multiple objects:

Procedure

  1. From the Buckets page, select the bucket containing the objects you want to destroy.

  2. Select the objects you want to destroy by using their checkboxes. Additionally, you can select all objects in a bucket by clicking All on the object selection bar.

  3. From the righthand side of the object selection bar, click Destroy.

  4. Type YES and then click Confirm Destroy.

    The objects are permanently removed from the bucket.

Destroying a version of an object

When you destroy a version of an object, that specific version is completely removed from your cloud storage. All other versions remain unaffected.

WARNINGDestroying a version of an object cannot be undone.

To destroy a specific version of an object:

Procedure

  1. From the Buckets page, click the name of the bucket in which the object resides.

  2. Navigate to the object you wish to view and then click its more icon.

  3. Select View versions.

    All versions of the selected object are displayed.
  4. Click the more icon at the righthand side of the version you want to delete.

  5. Click Destroy.

  6. Type YES and then click Confirm Destroy.

    The version is permanently removed from the bucket.

 

  • Was this article helpful?