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 can configure locking and versioning options only when you create the bucket. 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.

  • 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.