Documentation

Managing Objects

You can use the MinIO Console to perform several of the bucket and object management and interaction functions available in MinIO. Depending on the permissions and IAM policies for the authenticated user, you can:

Object Browser

The Object Browser lists the buckets and objects the authenticated user has access to on the deployment.

After logging in or navigating to the tab, the object browser displays a list of the user’s buckets, which the user can filter. Select a bucket to show a list of objects in the bucket.

Select a specific object to display summary information about the object such as name, size, tags, holds, and retention policies that apply. The console also shows the object’s metadata.

The user can perform actions on the bucket’s objects, depending on the policies and permissions that apply. Example actions the user may be able to perform include:

  • Rewind to a previous version

  • Create prefixes

  • View deleted objects

  • Upload objects

  • Download objects

  • Share

  • Preview

  • Manage legal holds

  • Manage retention

  • Manage tags

  • Inspect

  • Display versions

  • Delete

New in version Console: v0.24.0

View the status of uploading or downloading objects with the object manager button available on the top right corner of the Console. If you have not uploaded or downloaded any objects during the current session, the button does not appear.

Changed in version Console: v0.35.0

If you select multiple objects to download, MinIO creates a ZIP archive of those objects for downloading. You must unzip or uncompress this archive after downloading to access the files.

Buckets

The Console’s Bucket section displays all buckets to which the authenticated user has access. Use this section to create or manage these buckets, depending on your user’s access.

Creating Buckets

Select Create Bucket to create a new bucket on the deployment. MinIO validates bucket names. To see the rules for bucket names, select View Bucket Naming Rules.

MinIO does not limit the total number of buckets allowed on a deployment. However, MinIO recommends no more than 500,000 buckets per deployment as a general guideline.

While creating a bucket, you can enable versioning, object locking, bucket size (quota) limits, and retention rules (which require versioning).

Changed in version Console: v0.35.0

If you enable versioning, you can specify prefixes to exclude from versioning.

You must configure replication, locking, and versioning options at the time of bucket creation. You cannot change these settings for the bucket later.

Managing Buckets

Use the Search bar to filter for specific buckets. Select the row for the bucket to display summary information about the bucket.

Form the summary screen, select any of the available tabs to further manage the bucket.

Note

Some management features may not be available if the authenticated user does not have the required administrative permissions.

When managing a bucket, your access settings may allow you to view or change any of the following:

  • The Summary section displays a summary of the bucket’s configuration.

    Use this section to view and modify the bucket’s access policy, encryption, quota, and tags.

  • Configure alerts in the Events section to trigger notification events when a user uploads, accesses, or deletes matching objects.

  • Copy objects to remote locations in the Replication section with Server Side Bucket Replication Rules.

  • Expire or transition objects in the bucket from the Lifecycle section by setting up Object Lifecycle Management Rules.

  • Review security in the Access section by listing the policies and users with access to that bucket.

  • Properly secure unauthenticated access with the Anonymous section by managing rules for prefixes that unauthenticated users can use to read or write objects.

Tiers

The Tiers section provides an interface for adding and managing remote tiers to support lifecycle management transition rules. MinIO tiering supports moving objects from the deployment to the remote storage, but does not support automatically restoring them to the deployment.

The tiering tab allows users with the appropriate permissions to:

  • Review the status and summary information for all configured remote tiers.

  • Create a tier for a new remote target to storage on another MinIO deployment, Google Cloud Storage, Amazon’s AWS S3, or Azure.

  • Cycle the access credentials for any of the configured tiers with the tier’s icon.